想把 WorkBuddy 接进企业微信,让团队在群里 @ 机器人就能派活,先在企业微信里建一个机器人,再回 WorkBuddy 填两个凭证,最后扫码或者填号绑定。全程不需要公网服务器。
先说它接进来能干什么。群里 @ 机器人下任务,它自动跑完把结果贴回群里。你可以随时发消息跟进进度,也能建一个专属任务群长期绑着它处理团队日常。任务做完它会自动在群里通知相关的人,待办和验收事项也能同步到企微群。遇到要批准的命令或者改文件的操作,你在群里点确认就行。

动手之前,你得先有个企业微信账号。没有的话去企业微信官网免费注册一个企业,几分钟的事。

建机器人分两种角色,你是管理员还是普通成员,入口不一样。管理员走后台,浏览器打开企业微信管理后台,用管理员账号登录,依次点安全与管理,再点管理工具,然后进智能机器人,最后点创建机器人。普通成员不用碰后台,直接在企微客户端点工作台,进智能机器人应用,再点创建机器人。

这里有个共同的坑。进去之后如果先跳进了 AI 自动生成页面,别用那个,点左下角的手动创建,再选 API 模式创建。这一步选错,后面就白忙。
接着填基本信息。管理员这边点可见范围后的添加,选好要用机器人的成员、部门或者标签。普通成员那边点可使用成员后的修改,同样圈定范围。填完先保存,然后在 API 配置区域选使用长连接。长连接是推荐项,配置步骤最少,也不用回填什么 Webhook 地址。
然后拿凭证。在 API 配置区域选使用长连接后,复制 Bot ID,再点获取拿 Secret,把这两个妥善存好。长连接模式就这两个东西,不用再填 URL、Token 或者 Encoding-AESKey,比回调模式省事得多。
回 WorkBuddy 完成绑定。打开 WorkBuddy,点左下角头像菜单里的设置,进助理设置。在集成区域找到企微助理集成,点配置。弹窗里选 WebSocket 长连接,之后有两条路。一条是手动把刚才复制的 Bot ID 和 Secret 填进去,点注册。另一条是走快捷绑定,用企微扫码完成。两条都能成。
绑定完去企微里找机器人。在通讯录的企业创建的分组下能找到它,点发消息。先发一句你好做联通测试,它要是正常回了,就说明对接成功。
如果你已经在用 Webhook,或者网络限制逼着你走 URL 回调,也有备选方案。先在企微的 API 配置区域选使用 URL 回调,点 Token 和 Encoding-AESKey 输入框右边的随机获取,把这两个参数存好。回 WorkBuddy 进助理设置的企微集成配置,在注册弹窗切到使用 URL 回调,填入 Token 和 Encoding-AESKey 点注册,成功后复制生成的 Webhook URL。最后回到企微机器人页面,把这段地址粘进 URL 输入框保存。回调凭据务必存好,丢了后面没法注册。
有两处跟微信远程是一样的。任务实际是在你电脑上跑的,企微那头只发指令和批操作,电脑提供项目文件、终端环境、凭证和插件工具。本地能自己点的时候,优先用主界面的普通任务,需要远程触发或者统一翻记录再用助理。
最后是排障。机器人没响应,先确认电脑上 WorkBuddy 开着且助理服务已开启,再核对企业微信和 WorkBuddy 选的是不是同一种接入方式,长连接就核对 Bot ID 和 Secret,回调就核对 Token 和 Encoding-AESKey。长连接注册失败,多半是 Secret 失效或者复制时带进了空格,回企微后台重新获取一次再注册。
