WorkBuddy 接入企业微信全流程，踩了三个坑写下来给你们

WorkBuddy
, , ,
1

网上的教程大多语焉不详，我自己折腾了半天，把完整流程和坑位记下来。

前置条件

  • WorkBuddy 已安装并登录
  • 企业微信管理员权限
  • 5 块钱的耐心

第一步：企业微信后台新建应用

登录 work.weixin.qq.com，进入「应用管理」→「自建应用」，新建一个应用，名字随便起，图标随便传。

建完之后记下三个东西：

  • AgentId
  • Secret（点「查看」才显示）
  • 企业的 CorpId（在「我的企业」→「企业信息」里）

第二步：配置接收消息

在应用设置里找「接收消息」，开启后会要求填：

  • URL（这是 WorkBuddy 给你的 Webhook 地址）
  • Token
  • EncodingAESKey

:warning: 坑1：WorkBuddy 的 Webhook 地址在「Claw 设置」→「企微 AIBot 集成」里，不是在主界面，很多人找不到

第三步：回到 WorkBuddy 填入信息

打开 WorkBuddy，右上角头像 →「Claw 设置」→「企微 AIBot 集成」，把刚才的 Token 和 EncodingAESKey 填进去，点保存。

它会生成一个 Webhook URL，复制这个 URL 回到企业微信后台粘贴进去。

:warning: 坑2：先保存 WorkBuddy 生成 URL，再去企业微信填，顺序反了会验证失败

第四步：验证连接

企业微信后台点「保存」，如果显示「验证成功」就通了。

去手机企业微信，在「通讯录」→「智能机器人」里找到你建的应用，发一条消息试试。

:warning: 坑3：应用需要配置「可见范围」，默认只有管理员能看到，记得在应用设置里把范围改成全员或你需要的部门

能跑起来之后可以做什么

  • 手机发「帮我写今天的日报」→ 电脑自动生成
  • 把机器人拉进群 → 群里 @它 分配任务
  • 出差在外直接用手机遥控公司电脑跑脚本

整个流程大概 20 分钟，坑踩完之后其实不复杂。有问题评论区说。

4 个赞
2

照着楼主的教程走了一遍，成功了！

中间确实卡在坑1上了，那个 Webhook 地址的位置太隐蔽了。我在主界面找了十分钟没找到，差点放弃。后来看到楼主说在「Claw 设置」里才找到。

建议 WorkBuddy 团队把这个入口提到更显眼的位置，或者在应用首页加个「接入企微」的快捷入口，不然新用户真的会迷路。

另外分享一个小技巧：配置完之后建议在企微后台把「消息加密方式」设成「安全模式」，虽然明文模式也能跑，但安全模式对企业来说更合规。WorkBuddy 两种都支持，不用担心兼容问题。

2 个赞
3

补充第四个坑：IP 白名单。

楼主可能没遇到，但如果你的企业微信开了 IP 白名单限制（很多大厂和国企都有），那 WorkBuddy 的 Webhook 请求会被企微拦截，表现就是验证一直失败，没有任何错误提示。

解决方法：在企微管理后台 →「安全管理」→「API 白名单」里，把 WorkBuddy 的服务器 IP 加进去。具体 IP 可以在 WorkBuddy 的帮助文档里找到，也可以联系客服获取。

这个坑特别隐蔽，因为错误表现跟「顺序填错」一模一样——都是验证失败。我排查了两个小时才定位到是 IP 白名单的问题。

还有一点：如果你公司用了内网穿透，要确保 WorkBuddy 的出口 IP 跟白名单里的一致，不然内网环境和外网环境出口不同，会出现「办公室能用、回家不能用」的灵异现象。

2 个赞
4

请问如果公司有多个部门，每个部门想用不同的 AI 配置（比如市场部用内容生成模式、技术部用代码模式），是建多个企微应用还是一个应用里能分？

1 个赞
5

回复楼上 @fullstackhuio 的问题，我们公司就是这个场景。

实测下来建议建多个企微应用。原因：

  1. WorkBuddy 一个应用只能绑一套配置，不支持按部门分流
  2. 多个应用可以设不同的可见范围，市场部只看到市场部的 bot，技术部只看到技术部的
  3. 每个应用的对话记录独立，不会串

我们建了三个应用：「AI 内容助手」给市场部、「AI 代码助手」给技术部、「AI 日报助手」给全员。每个配置不同的 Skill 和提示词模板。

唯一麻烦的是每个应用都要走一遍楼主说的配置流程。三个应用配了大概一个小时，好在一次配完就不用管了。

另外提醒一下：企微对自建应用数量有上限（好像是 20 个），别无限建。

1 个赞
6

感谢分享！之前一直想接但看到网上那些教程就头大，楼主写得清楚多了。今晚回去试试。

1 个赞
7

有个细节想请教：楼主说「把机器人拉进群」，请问群聊场景下 WorkBuddy 是怎么响应的？是所有消息它都会回，还是只有 @它 才回？

我担心的是群里日常聊天它也插嘴，那就很尴尬了。另外群聊消息它会不会都读取？从数据安全角度考虑，不太想让它看到群里所有人的聊天记录。

还有一个问题：企微群最多支持 2000 人，如果是大群（比如全公司群），WorkBuddy 的响应速度会不会明显变慢？毕竟大群里消息量很大，不知道它处理得过来不。

1 个赞
8

mark 一下，下周部署的时候照着这个来。坑位记下了，应该能少走弯路。

2 个赞