本指南将帮助您在企业微信中配置 WorkBuddy 智能机器人，让您可以通过企业微信随时随地远程操控电脑上的 WorkBuddy 完成编程任务。

一、前提条件

在开始之前，请确保您已满足以下条件：

已在电脑上安装 WorkBuddy，并开启了 Claw 远程控制功能

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

可根据您的账号角色选择不同入口：

管理员：在企业微信管理后台依次点击「管理工具」→「智能机器人」→「创建机器人」，再选择「API 模式创建」

普通成员：在企业微信客户端依次点击「工作台」→「智能机器人应用」→「创建机器人」→「手动创建」→「API 模式创建」

提示

如果您还没有企业微信账号，可以前往 企业微信官网 免费注册一个企业。

二、创建企业微信智能机器人

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 回调模式放在文末作为备选方案。

三、完成长连接接入前的公共配置

1）填写机器人基本信息

在继续配置长连接之前，请先完成以下公共配置：

配置项说明

机器人名称建议填写容易识别的名字，如「WorkBuddy 助手」

可见范围选择哪些员工、部门或标签可以使用这个机器人

2）设置可见范围

点击「可见范围」后的「添加」，选择需要使用机器人的成员、部门或标签。

完成以上配置后，请先点击页面底部的「保存」，再在右侧「API 配置」区域选择「使用长连接」。

四、使用长连接接入

推荐优先使用长连接模式。它的配置步骤更少，也不需要回填 Webhook URL。

1）在企业微信中获取 Bot ID 和 Secret

在「API 配置」区域选择「使用长连接」

复制 Bot ID

点击 点击获取 获取 Secret，并妥善保存

提示

长连接模式不需要再填写 URL、Token 或 Encoding-AESKey。

2）在 WorkBuddy 中完成绑定

打开 WorkBuddy，点击右上角头像菜单中的「Claw 设置」

在「集成（BETA）」区域找到「企微 AIBot 集成」，点击「配置」

在弹窗中选择「WebSocket 长连接」，填入刚才复制的 Bot ID 和 Secret

点击「注册」完成绑定

五、开始使用

配置完成后，您就可以在企业微信中直接与机器人对话了。

1）找到机器人

在企业微信通讯录的「企业创建的」分组下找到刚刚创建的机器人，点击「发消息」即可开始下发任务。

2）联通后对话效果

发送一条简单消息（例如“你好”）进行联通测试。如果配置正确，WorkBuddy 会接收到消息并在企业微信中返回回复。

恭喜

如果机器人能够正常回复，说明您已成功完成 WorkBuddy 与企业微信的对接！

六、备选方案：使用 URL 回调接入

如果您已经在使用 Webhook 配置，或因网络、部署限制需要通过 URL 回调接入，可按以下步骤操作。

1）在企业微信中生成回调凭据

在「API 配置」区域选择「使用 URL 回调」

点击 Token 和 Encoding-AESKey 输入框右侧的「随机获取」

保存这两个参数，后续需要在 WorkBuddy 中使用

重要

请务必保存好 Token 和 Encoding-AESKey，否则后续无法完成注册。

2）在 WorkBuddy 中生成 Webhook URL

打开 WorkBuddy，进入「Claw 设置」→「企微 AIBot 集成」→「配置」

在注册弹窗中切换到「使用 URL 回调」

填入刚才获取的 Token 和 Encoding-AESKey，点击「注册」

注册成功后，复制生成的 Webhook URL

3）回填 URL 并保存

回到企业微信的机器人创建页面：

将刚才复制的 Webhook 地址粘贴到 URL 输入框

点击「保存」完成配置

七、常见问题

1）机器人没有响应怎么办？

请按以下步骤排查：

检查 WorkBuddy 状态：确保电脑上的 WorkBuddy 正在运行，且 Claw 服务已开启

核对接入方式：确认企业微信与 WorkBuddy 中选择的是同一种接入方式

检查凭据：长连接模式请核对 Bot ID 和 Secret；URL 回调模式请核对 Token 和 Encoding-AESKey

检查网络连接：确保电脑能够正常访问网络

2）URL 验证失败怎么办？

确保 WorkBuddy 处于运行状态

检查 Claw 服务是否已正常启动

重新复制 Webhook URL，确保没有遗漏或多余字符

确认 Token 和 Encoding-AESKey 与 WorkBuddy 中配置的完全一致

3）长连接注册失败怎么办？

确认企业微信侧已选择「使用长连接」

重新复制 Bot ID 和 Secret，避免带入多余空格

如 Secret 已失效，可在企业微信后台重新获取后再次注册