WorkBuddy 接入企业微信指南
本指南将帮助您在企业微信中配置 WorkBuddy 智能机器人，让您可以通过企业微信随时随地远程操控电脑上的 WorkBuddy 完成编程任务。
前提条件
在开始之前，请确保您已满足以下条件：
- 已在电脑上安装 WorkBuddy，并开启了 Claw 远程控制功能
- 拥有一个可创建智能机器人的企业微信账号
可根据您的账号角色选择不同入口：
- 管理员：在企业微信管理后台依次点击「管理工具」→「智能机器人」→「创建机器人」，再选择「API 模式创建」
- 普通成员：在企业微信客户端依次点击「工作台」→「智能机器人应用」→「创建机器人」→「手动创建」→「API 模式创建」
提示
如果您还没有企业微信账号，可以前往 企业微信官网 免费注册一个企业。
1. 创建企业微信智能机器人
1.1 选择创建入口
请根据您的账号角色选择对应入口：
- 管理员：打开浏览器，访问 企业微信管理后台，使用管理员账号登录后，依次点击「安全与管理」→「管理工具」→「智能机器人」→「创建机器人」
- 普通成员：打开企业微信客户端，进入「工作台」→「智能机器人应用」→「创建机器人」
1.2 进入 API 模式创建流程
进入机器人创建页面后，按以下方式切换到 API 模式：
- 管理员：在创建页面直接选择「API 模式创建」
- 普通成员：如果先进入 AI 自动生成页面，请点击左下角的「手动创建」，再选择「API 模式创建」
以下截图主要以管理后台页面为例，不同入口的界面文案可能略有差异，但后续配置项一致。
进入 API 模式页面后，请先完成机器人名称、可见范围等公共信息，并点击页面底部的「保存」；保存后，再继续选择具体的接入方式。
关于 API 模式
企业微信 API 模式支持两种接入方式，推荐优先使用长连接模式：
- 长连接模式（推荐）：在 WorkBuddy 中填写
Bot ID和Secret即可完成绑定，配置更简单，无需回填 Webhook URL - URL 回调模式：适用于需要 Webhook 回调的场景；需在 WorkBuddy 中填写
Token和Encoding-AESKey，生成 Webhook URL 后再回填到企业微信
下文主流程以长连接模式为例，URL 回调模式放在文末作为备选方案。
2. 完成长连接接入前的公共配置
2.1 填写机器人基本信息
在继续配置长连接之前，请先完成以下公共配置：
| 配置项 | 说明 |
|---|---|
| 机器人名称 | 建议填写容易识别的名字，如「WorkBuddy 助手」 |
| 可见范围 | 选择哪些员工、部门或标签可以使用这个机器人 |
2.2 设置可见范围
点击「可见范围」后的「添加」，选择需要使用机器人的成员、部门或标签。
完成以上配置后，请先点击页面底部的「保存」，再在右侧「API 配置」区域选择「使用长连接」。
3. 使用长连接接入
推荐优先使用长连接模式。它的配置步骤更少，也不需要回填 Webhook URL。
3.1 在企业微信中获取 Bot ID 和 Secret
- 在「API 配置」区域选择「使用长连接」
- 复制
Bot ID - 点击
点击获取获取Secret，并妥善保存
提示
长连接模式不需要再填写 URL、Token 或 Encoding-AESKey。
3.2 在 WorkBuddy 中完成绑定
- 打开 WorkBuddy，点击右上角头像菜单中的「Claw 设置」
- 在「集成（BETA）」区域找到「企微 AIBot 集成」，点击「配置」
- 在弹窗中选择「WebSocket 长连接」，填入刚才复制的
Bot ID和Secret - 点击「注册」完成绑定
4. 开始使用
配置完成后，您就可以在企业微信中直接与机器人对话了。
4.1 找到机器人
在企业微信通讯录的「企业创建的」分组下找到刚刚创建的机器人，点击「发消息」即可开始下发任务。
4.2 联通后对话效果
发送一条简单消息（例如“你好”）进行联通测试。如果配置正确，WorkBuddy 会接收到消息并在企业微信中返回回复。
恭喜
如果机器人能够正常回复，说明您已成功完成 WorkBuddy 与企业微信的对接！
5. 备选方案：使用 URL 回调接入
如果您已经在使用 Webhook 配置，或因网络、部署限制需要通过 URL 回调接入，可按以下步骤操作。
5.1 在企业微信中生成回调凭据
- 在「API 配置」区域选择「使用 URL 回调」
- 点击
Token和Encoding-AESKey输入框右侧的「随机获取」 - 保存这两个参数，后续需要在 WorkBuddy 中使用
重要
请务必保存好 Token 和 Encoding-AESKey，否则后续无法完成注册。
5.2 在 WorkBuddy 中生成 Webhook URL
- 打开 WorkBuddy，进入「Claw 设置」→「企微 AIBot 集成」→「配置」
- 在注册弹窗中切换到「使用 URL 回调」
- 填入刚才获取的
Token和Encoding-AESKey，点击「注册」 - 注册成功后，复制生成的 Webhook URL
5.3 回填 URL 并保存
回到企业微信的机器人创建页面：
- 将刚才复制的 Webhook 地址粘贴到
URL输入框 - 点击「保存」完成配置
常见问题
机器人没有响应怎么办？
请按以下步骤排查：
- 检查 WorkBuddy 状态：确保电脑上的 WorkBuddy 正在运行，且 Claw 服务已开启
- 核对接入方式：确认企业微信与 WorkBuddy 中选择的是同一种接入方式
- 检查凭据：长连接模式请核对
Bot ID和Secret；URL 回调模式请核对Token和Encoding-AESKey - 检查网络连接：确保电脑能够正常访问网络
URL 验证失败怎么办？
- 确保 WorkBuddy 处于运行状态
- 检查 Claw 服务是否已正常启动
- 重新复制 Webhook URL，确保没有遗漏或多余字符
- 确认
Token和Encoding-AESKey与 WorkBuddy 中配置的完全一致
长连接注册失败怎么办？
- 确认企业微信侧已选择「使用长连接」
- 重新复制
Bot ID和Secret，避免带入多余空格 - 如
Secret已失效，可在企业微信后台重新获取后再次注册