docs/channels/wecom-bot.mdx
<Note> 智能机器人与企业微信自建应用是两种不同的接入方式。智能机器人使用 WebSocket 长连接,无需服务器公网 IP 和域名,配置更简单。 </Note>通过企业微信智能机器人接入CowAgent,支持企业内部单聊和内部群聊,无需公网 IP,使用 WebSocket 长连接模式,支持Markdown渲染和流式输出。
无需提前创建机器人,启动 Cow 项目后打开 Web 控制台(本地链接:http://127.0.0.1:9899/),选择 通道 菜单,点击接入通道,选择企微智能机器人,切换到「扫码接入」模式,使用企业微信扫码即可自动完成机器人创建和接入。
<Note> 扫码成功后,可在企业微信工作台 - **智能机器人**页面对机器人进行进一步配置,包括修改名称、头像、可见范围等。 </Note>需要先在企业微信中创建智能机器人并获取 Bot ID 和 Secret,再通过 Web 控制台或配置文件接入。
步骤一:创建智能机器人
打开企业微信客户端,进入工作台,点击智能机器人:
点击创建机器人 - 手动创建:
右侧窗口拖到最下方,选择API模式创建:
设置机器人名称、头像、可见范围,并选择长连接模式,记录下 Bot ID 和 Secret 信息后点击保存。
步骤二:接入 CowAgent
<Tabs> <Tab title="Web 控制台"> 打开 Web 控制台,选择**通道**菜单,点击**接入通道**,选择**企微智能机器人**,切换到「手动填写」模式,输入 Bot ID 和 Secret,点击接入即可。 </Tab> <Tab title="配置文件"> 在 `config.json` 中添加以下配置后启动程序:```json
{
"channel_type": "wecom_bot",
"wecom_bot_id": "YOUR_BOT_ID",
"wecom_bot_secret": "YOUR_SECRET"
}
```
| 参数 | 说明 |
| --- | --- |
| `wecom_bot_id` | 智能机器人的 BotID |
| `wecom_bot_secret` | 智能机器人的 Secret |
日志显示 [WecomBot] Subscribe success 即表示连接成功。
| 功能 | 支持情况 |
|---|---|
| 单聊 | ✅ |
| 群聊(@机器人) | ✅ |
| 文本消息 | ✅ 收发 |
| 图片消息 | ✅ 收发 |
| 文件消息 | ✅ 收发 |
| 流式回复 | ✅ |
| 定时任务主动推送 | ✅ |
在企业微信中搜索创建的机器人名称,即可开始单聊对话。
如需在企微内部群聊中使用,将机器人添加到群中,@机器人发送消息即可。