🎬 本节视频教程
上一节讲了扫码直连的微信。这一节讲另外两个常用平台：企微助理（需要开放平台配置）和 QQ 机器人（扫码直连）。一个面向企业团队，一个面向 QQ 重度用户。
一、企微助理接入#
企微助理对接的是企业微信，适合把 WorkBuddy 能力共享给整个团队。和微信助理不同，它需要在企业微信的开放平台创建应用，并配置回调。
准备工作#
- 企业微信的管理员权限（或请管理员协助）
- 一台可被公网访问的服务器（用于接收回调），或确认网络环境支持
- 拿到应用的 AppKey / AppSecret
配置步骤#
- 登录企业微信管理后台，在"应用管理"里创建一个自建应用
- 在应用设置里配置回调 URL（Callback URL），让企业微信能把消息推送给你的服务
- 记下应用的 AppKey / AppSecret
- 回到 WorkBuddy：进入 Claw 设置 → 选择 "企微助理" → 点击 "配置"
- 把 AppKey / AppSecret 填入对应字段
- 按提示完成回调地址的绑定与验证
验证是否成功#
在企业微信里找到刚创建的那个应用（通常会以机器人或助理的形态出现），给它发一句测试指令。电脑端 WorkBuddy 收到并响应，即说明对接成功。
回调 URL 必须能被企业微信服务器访问到，所以你需要一台公网服务器。如果只在本地用，企微助理不是最佳选择，可考虑飞书的 WebSocket 长连接方案。
二、QQ 机器人接入#
QQ 机器人属于扫码直连型，和微信助理一样简单，适合学生和 QQ 重度用户。
准备工作#
- 一台运行 WorkBuddy 的电脑
- 一个能正常登录的 QQ 账号
配置步骤#
- 进入 WorkBuddy 的 Claw 设置
- 选择 "QQ 机器人"，点击 "配置"
- 客户端弹出二维码
- 用手机 QQ 扫码并确认授权
- 绑定成功后，QQ 里会出现对应的 WorkBuddy 机器人
验证是否成功#
在 QQ 里找到刚绑定的 WorkBuddy 机器人，发一句"你好"测试。电脑端有响应即代表链路打通。
三、两个平台对比#
| 对比项 | 企微助理 | QQ 机器人 |
|---|---|---|
| 接入方式 | 开放平台 + 回调 | 扫码直连 |
| 所需权限 | 企业管理员 | 普通 QQ 账号 |
| 是否要服务器 | 是（公网回调） | 否 |
| 适用对象 | 企业团队 | 个人 / 学生 |
| 配置耗时 | 较长 | 几分钟 |
四、使用方式#
两种平台接入后的用法和微信一致——在 IM 里发自然语言指令，电脑端执行后回传结果。
几个通用建议：
- 企业场景下，建议先由管理员在本地验证好任务模板，再开放给同事使用
- QQ 场景下，同样遵循"先本地后远程"，新指令先在桌面端跑通
- 重要操作（删除、批量改名、发消息）远程触发前务必确认范围
五、常见问题#
| 问题 | 解决办法 |
|---|---|
| 企微回调验证失败 | 检查回调 URL 是否公网可达、签名是否正确 |
| 企微发指令无响应 | 确认 AppKey/AppSecret 填对、WorkBuddy 在运行 |
| QQ 扫码失败 | 换个网络重试，确认 QQ 账号状态正常 |
小结#
企微助理走开放平台 + 回调，适合企业团队；QQ 机器人扫码直连，适合个人。到这里，IM 类平台的主流接入方式就讲完了。办公平台（飞书/钉钉）的接入思路和企微类似，可参照本章举一反三。