# 企业微信智能机器人

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

- 网址：https://funcoding.ai/agents/qwen-code/channels/wecom/
- 核实日期：2026-10-08（命令、配置和价格以官方文档为准）
- 官方来源：[Qwen Code 官方文档：WeCom](https://github.com/QwenLM/qwen-code/blob/main/docs/users/features/channels/wecom.md)、[Qwen Code 官方文档：Channels Overview](https://github.com/QwenLM/qwen-code/blob/main/docs/users/features/channels/overview.md)

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

## 配置与启动

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

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

```bash
qwen channel start wecom-work
```

将示例用户 ID 换成实际值。群需要按[访问策略](https://funcoding.ai/agents/qwen-code/channels/access/)另行开放，不能用私聊 allowedUsers 代替群成员权限。

## 群消息的提及边界

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

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

## 输入和回复

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

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

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

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