跳到正文
FunCoding

搜索

搜索文档、Skill 和 MCP

企业微信智能机器人

使用 API 模式 BotID 与 Secret,处理群提及、附件和图片回复。

企业微信渠道接入智能机器人的 API 模式,以 BotID 和 Secret 建立出站 WebSocket。它不使用自建应用的 CorpID、AgentID,也不需要公网回调的 Token、EncodingAESKey。

配置与启动

在企业微信创建智能机器人、选择 API 模式并取得凭据,将它们注入 Qwen Code 进程环境。

{
  "channels": {
    "wecom-work": {
      "type": "wecom",
      "botId": "$WECOM_BOT_ID",
      "secret": "$WECOM_SECRET",
      "privatePolicy": "allowlist",
      "allowedUsers": ["zhangsan"],
      "groupPolicy": "disabled",
      "sessionScope": "user",
      "cwd": "/path/to/project"
    }
  }
}
qwen channel start wecom-work

将示例用户 ID 换成实际值。群需要按访问策略另行开放,不能用私聊 allowedUsers 代替群成员权限。

群消息的提及边界

平台只推送 @机器人消息,因此 requireMention 的 true 和 false 在这里接收范围相同;保留该字段主要为兼容。当前适配器不再做第二次会误拒绝平台消息的提及门禁。

groupHistoryLimit 不能据此捕获平台从未推送的未提及消息。群准入、发送者限制和 dispatch 忙时策略仍正常适用。

输入和回复

可处理文本、语音转写、图片、混合图文、文件和视频。语音输入是平台提供的转写;图片分析需要模型能力,文件和视频则提供临时路径。

文本回复使用 Markdown。需要发送图片时,输出代码块外的标记,例如以下字面形式:

[IMAGE: /absolute/path/to/image.png]

上面的代码块只展示语法,实际响应中的标记不能被代码块包裹。有效图片必须位于系统临时目录的 channel-files 下,不能随意引用工作区任意路径。通用文件、视频、语音标记不会作为相应媒体发送。