WeCom (企业微信)

本指南介绍如何配置 Qwen Code 接入 WeCom 智能机器人。

前提条件

一个 WeCom 组织账号
一个以 API 模式创建的 WeCom 智能机器人
机器人的 Bot ID 和 Secret

创建机器人

打开 WeCom 管理后台并创建一个智能机器人。
选择 API 模式。
复制 Bot ID 和 Secret。
将机器人添加到需要使用的单聊或群聊中。

智能机器人使用从 Qwen Code 到 WeCom 的 WebSocket 连接。你无需配置公网回调 URL、Token、EncodingAESKey、Corp ID 或 Agent ID。

配置

将 channel 添加到 ~/.qwen/settings.json：


{
  "channels": {
    "my-wecom": {
      "type": "wecom",
      "botId": "$WECOM_BOT_ID",
      "secret": "$WECOM_SECRET",
      "senderPolicy": "allowlist",
      "allowedUsers": ["zhangsan"],
      "sessionScope": "user",
      "cwd": "/path/to/your/project",
      "instructions": "You are a concise coding assistant responding via WeCom.",
      "groupPolicy": "open",
      "groups": {
        "*": { "requireMention": true }
      }
    }
  }
}

将凭证设置为环境变量：


export WECOM_BOT_ID=<your-bot-id>
export WECOM_SECRET=<your-secret>

或者在 settings.json 的 env 部分中定义它们：


{
  "env": {
    "WECOM_BOT_ID": "your-bot-id",
    "WECOM_SECRET": "your-secret"
  }
}

运行


qwen channel start my-wecom

打开 WeCom 并向智能机器人发送消息。

访问控制

senderPolicy 的工作方式与其他 IM 通道相同：

allowlist：仅 allowedUsers 中的用户可以使用该机器人。这是推荐的企业默认设置。
pairing：用户必须先完成配对才能使用该机器人。
open：任何可以向机器人发送消息的人都可以使用它。

对于群聊，将 groupPolicy 设置为 "allowlist" 或 "open"。默认情况下，群消息需要通过 "requireMention": true 进行 @ 提及。

当 WeCom SDK 包含明确的提及元数据时，Qwen Code 会将其用于此过滤判断。如果不存在提及元数据，该 channel 会将接收到的群消息视为未提及。仅当你希望依赖 WeCom 侧的消息投递范围控制时，才将 "requireMention" 设置为 false。

图片与文件

用户可以发送文本、带转录的语音消息、图片、图文混合消息、文件和视频。图片会作为图像附件传递给 agent。文件和视频会被下载到本地临时路径，以便 agent 使用文件工具读取它们。

助手的响应会以 WeCom Markdown 格式发送。要发送由 agent 生成的本地图片，请在代码块外包含以下标记：


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

出于安全考虑，本地图片路径必须位于系统临时目录下的 channel 文件目录中，例如 Linux 上的 /tmp/channel-files/...。通用的文件、视频和语音上传标记会被忽略，因为模型生成的文件路径可能会上传任意工作区文件。

故障排除

机器人无法连接

验证 Bot ID 和 Secret。
确保机器人是以 API 模式创建的。
检查运行 qwen channel start 的 shell 中是否可用这些环境变量。

机器人在群聊中不响应

检查 groupPolicy。
除非群配置设置了 "requireMention": false，否则请 @ 提及该机器人。
确认机器人已被添加到群聊中。

自建应用凭证无效

此 channel 专用于 WeCom 智能机器人。此 channel 不使用自建应用的回调凭证，如 Corp ID、Agent ID、Token 和 EncodingAESKey。