企业微信接入怎么比？WorkBuddy 接的是智能机器人，CodeBuddy CLI 接的是群机器人

2026-08-16

「企业微信接入」这个说法，在这套产品体系里指的可能是两种不同的东西：

WorkBuddy：接的是企业微信的智能机器人（走 API 模式，需要 Bot ID + Secret 或 Token + AESKey）；
CodeBuddy CLI：官方有一篇 cli/wecom-bot-setup，走的是群机器人 WebHook 的路子。

两种机器人在企业微信侧就是两个不同的东西，配置入口、凭证、能力都不一样。

依据：WorkBuddy 官方文档《接入企业微信指南》（Platform-Integration/Wecom-Guide）；CodeBuddy 官方中文文档 cli/wecom-bot-setup 与 Function-Description/MCP-Guide 中的企微机器人示例。核对日均为 2026-08-16。企业微信侧规则以企业微信官方为准。我们没有安装任何一方，本文不含实测数据。

一、WorkBuddy 侧：智能机器人（API 模式）

前提：拥有一个可创建智能机器人的企业微信账号。

两个入口（按角色）：

管理员：企业微信管理后台 →「安全与管理」→「管理工具」→「智能机器人」→「创建机器人」→ 选「API 模式创建」；
普通成员：企业微信客户端 →「工作台」→「智能机器人应用」→「创建机器人」→（若先进了 AI 自动生成页面，点左下角「手动创建」）→「API 模式创建」。

两种接入方式（官方推荐前者）：

方式	要填什么	要不要回填 Webhook
长连接模式（推荐）	Bot ID + Secret	不需要
URL 回调模式	Token + Encoding-AESKey	需要

一项别的平台没有的能力：配置时要设「可见范围」——官方说明是「选择哪些员工、部门或标签可以使用这个机器人」。

配好之后：在企业微信通讯录的「企业创建的」分组下找到机器人，点「发消息」。

二、CodeBuddy 侧：群机器人 Webhook

CodeBuddy 官方有独立的 cli/wecom-bot-setup 文档。从 MCP 文档里那个示例能看出它走的路径：

获取方式：在企业微信群中「添加群机器人」→ 获取 WebHook URL。

官方给的地址格式示例：

https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

用法（MCP 示例里的配置）：

{
  "mcpServers": {
    "wecom": {
      "command": "uvx",
      "args": ["wecom-bot-mcp-server"],
      "env": {
        "WECOM_WEBHOOK_URL": "your-webhook-url"
      }
    }
  }
}

官方给的示例指令：请通过企业微信机器人通知：正式产品已发布，请 @xxxx 进行验收。

三、两种机器人的差别在哪

这不是我们的判断，是企业微信侧的产品差别在两边接入方式上的体现：

	智能机器人（WorkBuddy 侧）	群机器人 WebHook（CodeBuddy 侧示例）
创建位置	管理后台「智能机器人」或客户端「智能机器人应用」	在某个群里「添加群机器人」
凭证	Bot ID + Secret，或 Token + Encoding-AESKey	一个 WebHook URL
作用范围	有「可见范围」（员工/部门/标签）	通常绑定在创建它的那个群
交互方向	官方文档描述的是收发双向（收消息 → 执行 → 回复）	MCP 示例里演示的是发通知

最实质的差别在最后一行：一个是「你在企微里给它派活，它执行完回复你」；一个是「任务完成后往群里发个通知」。

方向不同，用途也不同。

四、所以该怎么选

如果你想「在企业微信里给它下达任务」 → WorkBuddy 的企业微信接入是为这个设计的：官方文档开头写的就是「让您可以通过企业微信随时随地远程操控电脑上的 WorkBuddy 完成任务」。

如果你想「让它把结果发到项目群里」 → 群机器人 WebHook 这条路更直接。而且这条路 WorkBuddy 侧也走得通——官方 MCP 文档里那个企微机器人示例，本来就是给 WorkBuddy 配的。

两者可以并存：用智能机器人接收任务，用群机器人 MCP 发通知。官方在 MCP 的适用场景里列的正是这类：

场景	官方说明
发布通知	版本上线后自动通知项目群相关人员
任务提醒	将待办、验收、协作事项同步到企微群
流程打通	连接 WorkBuddy 任务处理与外部平台

五、两边共同的注意事项

一、凭证别带多余空格。 官方在企业微信接入的排查里专门写了：长连接注册失败 → 重新复制 Bot ID 和 Secret，避免带入多余空格；URL 验证失败 → 重新复制 Webhook URL，确保没有遗漏或多余字符。

统一做法：复制后先粘到纯文本编辑器（记事本 / TextEdit）里看一眼首尾，确认干净了再填。首尾空白肉眼完全看不出来，但会让配置直接失败。

二、WebHook URL 是凭证。 官方 MCP 安全提示里明写：妥善保管 WebHook URL——它是机器人调用凭证，切勿泄露。 别提交到代码仓库，别贴在聊天记录里。

三、两边选的模式要一致。 这是 WorkBuddy 侧官方 FAQ 里列的排查项之一：核对接入方式——确认企业微信与 WorkBuddy 中选择的是同一种接入方式。平台那边选长连接、客户端这边选 URL 回调，怎么配都不通。

四、宿主得活着。 官方在助理文档「注意事项」里明写电脑需要保持开机并运行 Tencent WorkBuddy；这也是企微接入排查列表的第一条。

六、企业微信侧还有一条常见故障

官方 FAQ 里有一条：提示 Webhook 域名主体校验未通过。

官方说明：企业微信侧会对 Webhook 地址进行域名主体校验；做法是核对地址是否完整、是否与当前配置要求一致；仍无法通过则保留报错截图提交排查。

这条只会出现在 URL 回调这条路上——所以又回到那个建议：没有公网 IP 就选长连接，Webhook 相关的这一整类问题从根上不会出现。

七、我们不写的东西

不写谁的企微接入更好——两边接的不是同一种机器人，比较没有意义；
不复述 CodeBuddy cli/wecom-bot-setup 的详细步骤——以其官方文档为准；
不推断智能机器人与群机器人在企业微信侧的完整能力差异——那是企业微信的产品问题，以企业微信官方为准；
不写群机器人能不能反向接收指令——官方示例演示的是发通知方向，未展开说明。

八、想两条都走，配置顺序建议

如果你确定要「企微里派活 + 结果发群里」这套组合，给一个顺序：

第一步：先把智能机器人配通。 按官方指南走完整流程——选入口（管理员走管理后台，普通成员走客户端并点左下角「手动创建」）→ 填机器人名称与可见范围 → 先点底部「保存」 → 在右侧「API 配置」选「使用长连接」→ 复制 Bot ID、点「点击获取」拿 Secret → 回 WorkBuddy 左下角头像「设置 - 助理设置」→「集成（BETA）」→「企微 AIBot 集成」→ 选「WebSocket 长连接」→ 填入 → 注册。

第二步：在通讯录里验一次。 在「企业创建的」分组下找到机器人，发一句「你好」测试。通了再往下走。

第三步：再配群机器人 MCP。 在你要接收通知的那个群里「添加群机器人」拿 WebHook URL，然后按官方 MCP 流程配——侧边栏「插件」→ 右上角「MCP 服务器」→「配置 MCP」，把官方那段 mcpServers 配置粘进去替换地址。

第四步：确认 MCP 状态灯是绿的。 红灯要查配置内容（JSON 格式）、命令环境、地址三个方向。

这个顺序的好处：两条链路分开验证，出问题时知道是哪一条断了。反过来同时配，一旦不通你分不清是智能机器人的凭证问题还是 MCP 的配置问题。

一个配置级别的建议：群通知这类是典型的跨项目能力，官方 MCP 最佳实践里明说公共能力配用户级——所以配到 ~/.workbuddy/mcp.json 就对了。

小结

★ 两边接的不是同一种机器人：WorkBuddy 走企业微信的智能机器人（API 模式）；CodeBuddy CLI 侧的文档与 MCP 示例走的是群机器人 WebHook。
方向不同：智能机器人是「你派活 → 它执行 → 回复你」；群机器人 WebHook 示例演示的是「任务完成后往群里发通知」。
WorkBuddy 侧两个入口按角色分（管理员走管理后台，普通成员走客户端且要点左下角「手动创建」），两种接入方式官方推荐长连接（Bot ID + Secret，不用回填 Webhook）。
WorkBuddy 侧有一项别的平台没有的能力：「可见范围」（指定员工、部门或标签）。
两者可以并存：智能机器人收任务，群机器人 MCP 发通知——官方 MCP 适用场景里列的正是「发布通知」「任务提醒」。
共同注意：凭证别带空格（先过纯文本编辑器）、WebHook URL 是凭证切勿泄露、两边模式必须一致、电脑得开着。
域名主体校验未通过只出现在 URL 回调路径上——没公网 IP 就选长连接。

双方功能与文档表述均以各自官方为准，企业微信侧规则以企业微信官方为准，核对日 2026-08-16。