WorkBuddy 接 QQ 为什么要实名？还有一条 AppSecret 只有一次机会

2026-08-16

QQ 是 WorkBuddy 接入里流程最短的平台之一——官方文档写的是点「创建机器人」后会立刻成功，机器人还会给你的 QQ 发一条成功消息。

但它有两个前置条件，卡住的人基本都卡在这两条上：实名认证，和一条只有一次机会的凭证。

本文依据 WorkBuddy 官方文档《接入 QQ 指南》（Platform-Integration/QQ-Guide），核对日 2026-08-16。QQ 开放平台侧的规则以其官方为准。我们没有安装客户端，本文不含实测数据。

一、两个前提条件

官方给的前提只有两条：

已在电脑上安装 WorkBuddy，并开启了助理远程控制功能；
拥有一个已完成实名认证的 QQ 账号。

官方对第二条的说明是：QQ 开放平台要求账号完成实名认证。如未认证，请先在 QQ 中完成实名认证后再进行后续操作。

需要说清楚的是：这是 QQ 开放平台的平台规则，不是 WorkBuddy 定的。 任何人要在 QQ 开放平台上创建机器人，都得先过这一关。所以这一步没有绕过的办法，也不该去找绕过的办法。

没实名会怎样：你在开放平台那边就走不到创建机器人这一步。建议先去 QQ 里把实名做了，再开始配——不然你会在流程中间被卡住，白折腾一遍。

二、完整流程

官方给的三步：

1）注册并登录 QQ 开放平台

浏览器访问 QQ 开放平台，使用 QQ 扫码登录。

2）创建机器人

点「创建机器人」。官方说明点后会立刻成功，此时机器人会给你的 QQ 发一条成功消息。头像昵称可以按喜好自定义编辑。

这一步是所有平台里最简单的——没有权限申请、没有审核、没有发布流程。对比一下钉钉：要开三个 API 权限、要创建版本、要提交审核、应用必须发布后才能使用。

3）配置凭证

复制机器人的 AppID 和 AppSecret，然后：

打开 WorkBuddy，在头像处进入「设置 - 助理设置」；
配置 QQ 机器人集成；
填入刚才复制的 AppID 和 AppSecret，点「注册」。

配置成功的标志（官方给了两个）：

助理设置中，「QQ 机器人集成」显示已连接；
助理里能看到 QQ 图标。

两个都出现了才算配好。

三、AppSecret：只有一次机会

这是本文最需要你记住的一条。官方原文标了「重要提示」：

出于安全考虑，AppSecret 不支持明文保存，二次查看将会强制重置，请自行妥善保存。

拆开说清楚它的后果：

不支持明文保存：你回头去开放平台后台，看不到之前那个 AppSecret 的原文；
二次查看将强制重置：你去点「查看」这个动作本身，就会让旧的失效；
旧的失效之后：你在 WorkBuddy 里配好的那个凭证就不对了，接入会断，得用新 Secret 重新注册一遍。

所以最糟糕的操作是：接入用了一段时间，某天出问题了，你回后台”确认一下 Secret 对不对”——这一看，本来还能用的也废了。

正确做法：

创建机器人拿到 AppSecret 的当下，立刻复制；
存进密码管理器（不是记事本、不是微信收藏、不是聊天记录）；
顺手把 AppID 一起存进去，两个放一起；
之后需要核对时，看你自己存的那份，别回后台点查看。

四、凭证复制的两个细节

官方在多个平台的指南里反复提醒过同一件事——避免带入多余空格或遗漏字符。

具体到操作：

一、先粘到纯文本编辑器里看一眼。 复制凭证之后，先粘到记事本 / TextEdit 里，看清楚首尾有没有多余的空格或换行，确认干净了再填进 WorkBuddy。首尾空白是最阴的一个——肉眼完全看不出来，但会让注册失败。

二、别在两个网页输入框之间直接来回复制。 中间过一道纯文本，能规避掉大部分不可见字符的问题。

五、配好之后不回复怎么办

QQ 侧官方 FAQ 有一条专门的：QQ 机器人频繁断开或不回复，给的做法是：

优先切换模型测试；若持续存在，记录错误码、发生时间与网络环境后再排查。

注意「优先切换模型」这个措辞——官方在多类问题里都把切模型排在前面，因为它成本几秒钟、完全可逆、能一次排除一整个方向。

另外还有一条通用的「已完成接入但发送消息无响应」：先确认当前连接状态是否仍在线；优先切换模型后再次测试；若首次可用、后续失效，记录复现时间与平台类型。

但在这两条之前，先查一件官方没写但更基础的事：

你的电脑是不是活着。

QQ 这条链路的终点是你自己电脑上正在运行的那个 WorkBuddy。电脑关机、休眠、客户端退出、断网——机器人一定不回复，而且这在 QQ 开放平台后台里怎么查都查不出来。

而且这完美匹配「时好时坏」的特征：你在电脑前的时候好好的，人一走电脑睡了就失联，回来动一下鼠标又好了。

出门前的检查：

□ 电脑开机，且电源设置里没有「N 分钟后自动睡眠/休眠」
□ 笔记本接着电源（电池模式下的睡眠策略通常更激进）
□ WorkBuddy 客户端在运行（进程活着，不是最小化就行）
□ 助理 / 远程控制功能已开启
□ 助理设置里「QQ 机器人集成」显示已连接
□ 网络稳定

六、什么时候不该选 QQ

QQ 的优势是流程短、没有企业账号门槛。但有几种情况建议选别的：

你根本不常用 QQ —— 那接了也想不起来用。官方还有微信助理这个选项，不需要任何开发凭证，只要 WorkBuddy ≥ 4.6.4 和微信 ≥ 8.0.70，扫码即可。
要在组织内多人用 —— 企业微信有可见范围设置（可以指定哪些员工、部门或标签能用），QQ 这边官方文档没有对应的管控说明。
公司规定不能用 QQ 传业务信息 —— 那就别在这上面处理业务数据。

七、一个安全上的提醒

用 IM 遥控，意味着你在一个聊天软件里下达会真实操作你电脑文件的指令。官方在使用技巧里有一条「先本地后远程」讲的就是这个：

远程遥控意味着它在你看不见的地方自主行动，执行了超出预期的操作你未必来得及叫停。建议新手先在桌面端边看边用，摸清执行方式、理解习惯和风险边界，再逐步放手。

具体到 QQ：别在远程状态下做批量删改、别处理客户或财务数据、别试第一次做的新任务。远程适合查东西、写点内容、汇总已有材料，以及触发已经跑熟的固定流程。

小结

两个前提：电脑上客户端在运行且助理远程控制功能已开启；QQ 账号已完成实名认证（QQ 开放平台的规则，没有绕过办法）。
流程三步：开放平台扫码登录 → 点「创建机器人」（点后立刻成功，会给你 QQ 发消息）→ 复制 AppID + AppSecret 填进 WorkBuddy 头像处「设置 - 助理设置」→ 注册。
成功标志两个：助理设置显示已连接 + 助理里能看到 QQ 图标。
★ AppSecret 只有一次机会：官方明确不支持明文保存、二次查看将强制重置。拿到当下就存密码管理器，之后别回后台点查看。
凭证先粘到纯文本编辑器看首尾空白，别在两个网页输入框之间直接复制。
不回复：先查电脑是不是活着 → 官方做法是优先切换模型测试 → 记录错误码、时间与网络环境。
只想省事又不非得用 QQ 的，微信助理不需要任何开发凭证。

功能与流程以官方为准，QQ 开放平台规则以其官方为准，核对日 2026-08-16。