QQ 接入怎么比？WorkBuddy 要实名且 AppSecret 只有一次机会
QQ 是两边都支持的渠道，但 WorkBuddy 侧有两条约束值得先知道——其中一条是「只有一次机会」级别的。
先说形态前提：WorkBuddy 是商业闭源桌面客户端，QQ 接入是产品内置的；OpenClaw 是 MIT 开源自托管 Gateway 网关，QQ Bot 在它的中文区渠道分组里。
依据：WorkBuddy 官方文档《接入 QQ 指南》（
Platform-Integration/QQ-Guide）与官方 FAQ；OpenClaw 官方中文文档zh-CN/channels/（QQ Bot 页在中文区渠道分组下）。核对日均为 2026-08-16。QQ 开放平台侧规则以其官方为准。我们没有安装任何一方，本文不含实测数据。
一、WorkBuddy 侧的两条前提
官方给的前提条件只有两条，但第二条是硬门槛：
- 已在电脑上安装 WorkBuddy，并开启了助理远程控制功能；
- 拥有一个已完成实名认证的 QQ 账号。
官方对第二条的说明：QQ 开放平台要求账号完成实名认证。如未认证，请先在 QQ 中完成实名认证后再进行后续操作。
这是 QQ 开放平台的平台规则，不是 WorkBuddy 定的——任何人要在 QQ 开放平台上创建机器人都得过这一关。所以没有绕过的办法，也不该去找绕过的办法。
建议先去 QQ 里把实名做了，再开始配——不然你会在流程中间被卡住。
二、★ AppSecret 只有一次机会
这是 WorkBuddy 侧 QQ 接入最该记住的一条。官方标了「重要提示」：
出于安全考虑，AppSecret 不支持明文保存，二次查看将会强制重置，请自行妥善保存。
拆开说清楚后果：
- 你回开放平台后台，看不到之前那个 AppSecret 的原文；
- 你去点「查看」这个动作本身，就会让旧的失效；
- 旧的失效之后，你在 WorkBuddy 里配好的凭证就不对了，接入会断。
所以最糟糕的操作是：用了一段时间之后某天出问题，你回后台「确认一下 Secret 对不对」——这一看，本来还能用的也废了。
正确做法：拿到 AppSecret 的当下立刻复制 → 存进密码管理器 → 顺手把 AppID 一起存 → 之后核对看你自己存的那份，别回后台点查看。
对照一下别的平台：Discord 的 Bot Token 官方也写明「Token 只会完整显示一次，如果丢失需要重新生成」，但 Discord 那边丢了可以 Reset Token 重新生成；元宝派的凭证官方说明可以重新创建 Bot 获取新凭据；钉钉与飞书的 AES Key / Token / Encrypt Key 可以点刷新重新生成。QQ 这条是这几个里最不可逆的。
三、WorkBuddy 侧的完整流程
官方给的三步，是九个平台里最短的之一：
- 注册并登录 QQ 开放平台：浏览器访问，QQ 扫码登录；
- 创建机器人：点「创建机器人」——官方说明点后会立刻成功，机器人会给你的 QQ 发一条成功消息；头像昵称可自定义；
- 配置凭证：复制 AppID 和 AppSecret → 打开 WorkBuddy，在头像处进入「设置 - 助理设置」→ 配置 QQ 机器人集成 → 填入后点「注册」。
成功的两个标志（官方给的）：助理设置中「QQ 机器人集成」显示已连接；助理里能看到 QQ 图标。两个都出现了才算配好。
没有权限申请、没有审核、没有发布流程——对照钉钉（三个 API 权限 + 创建版本 + 提交审核 + 应用必须发布）和飞书（一百多条权限 JSON + 四个凭证 + 事件回调 + 必须发布），QQ 这条路轻得多。
四、OpenClaw 侧的路径
OpenClaw 的 QQ Bot 在文档的中文区渠道分组里（与微信、腾讯元宝并列）。
从同分组的微信页能看出这类渠道的通用架构（官方原文口径）：OpenClaw 提供通用渠道插件契约，外部插件提供渠道专用运行时；核心保持与渠道无关。
对应的操作模式是：装插件 → 启用 → 重启 Gateway 网关 → 用命令行完成登录与配对。准入用的是 OpenClaw 的配对和允许列表模型（openclaw pairing list <channel> / openclaw pairing approve <channel> <CODE>）。
具体到 QQ Bot 页的细节，以 OpenClaw 官方文档为准——本文重点是并列关系与 WorkBuddy 侧的可操作项。
五、并列对照
| WorkBuddy | OpenClaw | |
|---|---|---|
| 形态 | 产品内置集成 | 渠道插件（核心与渠道分离） |
| 前提 | QQ 账号已实名认证 + 客户端运行且助理功能已开启 | 运行中的 Gateway 网关 |
| 凭证 | AppID + AppSecret（Secret 二次查看强制重置） | 以官方 QQ Bot 页为准 |
| 配置方式 | 客户端界面填入后点「注册」 | 命令行 |
| 准入控制 | 官方文档未提供该平台的准入配置说明 | 配对与允许列表模型 |
| 成功标志 | 显示「已连接」+ 助理里出现 QQ 图标 | 以官方文档为准 |
六、配好之后不回复，两边都先查同一件事
宿主活着没有。
- WorkBuddy：官方在助理文档「注意事项」里明写——使用助理时，电脑需要保持开机并运行 Tencent WorkBuddy；
- OpenClaw：Gateway 网关是本地进程，官方在 Cron 文档里也写明 Gateway 网关必须处于运行状态。
这一条能解释绝大多数「时好时坏」：你在电脑前的时候好好的，人一走机器睡了就失联。
WorkBuddy 侧官方另有 QQ 专门的一条排查：QQ 机器人频繁断开或不回复 → 优先切换模型测试；若持续存在，记录错误码、发生时间与网络环境后再排查。
「优先切换模型」是官方在多类问题里反复推荐的第一步——成本几秒钟、完全可逆、能一次排除一整个方向。
七、什么情况选哪个（按官方自述定位归因）
强调：这是按双方官方自述做的归因，不是评测结论。
- 你就是 QQ 重度用户、想最快接上 → WorkBuddy 侧流程三步、点创建立刻成功（前提是已实名）；
- 你已经在跑 OpenClaw 网关，想把 QQ 并进已有的多渠道体系 → OpenClaw 的插件路径；
- 你需要细粒度准入控制（谁能给它发消息） → OpenClaw 有配对与允许列表模型；WorkBuddy 侧九个平台里只有企业微信有官方明确的「可见范围」；
- 你不常用 QQ → 那两边都别选这个渠道。WorkBuddy 侧还有微信助理这个更省事的选项——官方明确无需填写 App ID、App Secret 等开发凭证，只需扫码（要求 WorkBuddy ≥ 4.6.4、微信 ≥ 8.0.70）。
八、一条安全提醒
用 IM 遥控意味着你在聊天软件里下达的指令会真实操作你电脑上的文件。官方在使用技巧里的「先本地后远程」讲的正是这个：远程遥控意味着它在你看不见的地方自主行动，执行了超出预期的操作你未必来得及叫停。
所以远程只做查、写、汇总和已经跑熟的固定流程；批量删改、客户与财务数据、第一次试的新任务，都别远程做。
九、我们不写的东西
- 不写谁的 QQ 接入更好——形态不同，比较没有意义；
- 不复述 OpenClaw QQ Bot 页的配置细节——以其官方文档为准；
- 不写绕过实名认证的办法——那是 QQ 开放平台的规则，也不该找绕法；
- 不写两边 QQ 渠道的能力差异（如群聊支持）——需逐条核对各自官方文档，本文未展开。
小结
- ★ WorkBuddy 侧两条硬约束：QQ 账号必须已实名认证（QQ 开放平台规则）；AppSecret 不支持明文保存、二次查看强制重置——拿到当下就存密码管理器，之后别回后台点查看。
- 这条不可逆程度在几个平台里最高：Discord Token 可 Reset、元宝可重建 Bot、钉钉飞书的 Key 可刷新，QQ 的一看就废。
- WorkBuddy 侧流程最短之一：开放平台扫码登录 → 点「创建机器人」（立刻成功）→ 填 AppID + AppSecret 注册。无权限申请、无审核、无发布。
- 成功标志两个：显示「已连接」+ 助理里出现 QQ 图标。
- OpenClaw 侧走渠道插件路径（核心与渠道分离），准入用配对与允许列表模型。
- 两边共同前提：宿主得活着（电脑保持开机运行客户端 / Gateway 网关必须运行）。
- 不回复时 WorkBuddy 侧官方做法：优先切换模型测试，再记录错误码、时间与网络环境。
双方功能与文档表述均以各自官方为准，QQ 开放平台规则以其官方为准，核对日 2026-08-16。