QQ 机器人接入教程：五步在 QQ 开放平台创建机器人并绑定 WorkBuddy
面向中小企业与开发者的 QQ 机器人接入实操：创建应用、开通消息权限、回填回调地址、填入 App ID 与 Secret、发布上线，一枚机器人即可在群里 @ 它派活。
有些团队的日常协同不在钉钉、飞书、企微里——销售和技术之间一直用 QQ 群传文件、截图、排期。这类团队想上 AI 助手，绕一圈去别的平台反而割裂。
QQ 机器人的价值就在于它是原生 QQ 生态的：一旦配好，同事在自己熟悉的 QQ 群里 @机器人 就能派活，不需要再装一个 App、再注册一个账号。
与其它通道的对比 #
| 对比项 | QQ 机器人 | 微信助理 | 企业微信助理 |
|---|---|---|---|
| 使用入口 | QQ 群 / QQ 单聊 | 个人微信 | 企业微信群 @ |
| 是否需企业 organization | 视平台政策而定 | 不需要 | 需要企业（免费可注册） |
| 需要开发者凭据 | App ID / App Secret（或 Client ID / Secret） | 不需要，扫码即绑 | Bot ID + Secret |
| 擅长场景 | 熟悉 QQ 习惯的小团队、玩家社群 | 个人随手派单 | 正规组织架构内的任务流 |
| 上手难度 | 中，要过平台审核 | 低 | 中 |
结论：想让团队"零学习成本直接用"，QQ 生态下这是最顺的一条；但别指望它像企微那样承担合规、审批这类组织流程。
前置条件 #
- 电脑上已安装 WorkBuddy，并已开启「助理」的远程控制。
- 有一个 QQ 开放平台（q.qq.com） 账号，且具备创建应用的资格（多数个人与企业实名账号即可）。
- 明确机器人跑在哪台电脑上——执行永远在电脑端，QQ 只是通道。
说明：QQ 开放平台的后台改版较频繁，各按钮名称与位置以你登录开发者后台后看到的实际页面为准。下面给的是稳定的流程骨架，不是逐个截图标注。
五步接入流程 #
第 1 步：创建应用 / 机器人
登录 QQ 开放平台（q.qq.com） → 进入开发者后台 → 创建应用或机器人 → 填写名称、简介、头像/图标 → 提交创建。
名称直接写用途（如「AI 助理-交付群」），后面同事在群里认的是这个名字。
第 2 步：开通消息相关权限
应用详情 → 找到「权限」或「功能授权」→ 开通与收发消息相关的权限（群消息、单聊消息、好友消息等，具体名称以平台展示为准）。
这一阶段的判断原则很简单：只开消息相关权限。别顺手把所有权限都勾上。
第 3 步：回填 WorkBuddy 生成的回调 / 事件订阅地址
在应用里找到「事件订阅」或「消息接收」配置页 → 把 WorkBuddy 生成或提供的 Webhook（回调）地址填进去。
这一步是 QQ 链路和企微、钉钉链路最大的区别：这里填的是我方（WorkBuddy 侧）的地址，平台带着消息过来看门。
如果你的组织网络条件允许，也可以优先使用长连接模式，这样就不需要向平台暴露任何回调地址，配置步骤更少——这一条与各平台的通用做法一致，具体选项以开发者后台提供的模式为准。
第 4 步：把凭据填回 WorkBuddy
回到 WorkBuddy 的助理设置 → 集成(BETA) → QQ 集成 → 配置，填入平台给出的 App ID 与 App Secret（部分平台称之为 Client ID / Client Secret），保存。
{
"integration": "qq-assistant",
"appId": "平台给的 App ID",
"appSecret": "平台给的 App Secret",
"callbackType": "webhook",
"callbackUrl": "第 3 步填到平台那边的地址",
"status": "已连接"
}四项都要对上，缺一项就静默失败。
第 5 步：发布应用
应用详情 → 「发布 / 「提交审核」」→ 填版本描述 → 提交。
不发布不生效，和飞书、钉钉一样，草稿态机器人群里@不到；平台侧通常还需要审核等待。
验证是否成功 #
- QQ 里私聊机器人发一句文字指令——应回复。
- 在群（如适用）里 @机器人 发指令——应回复。
- 让它执行一条读本地文件的指令，返回结果正确才算打通。
- 检查 WorkBuddy 集成状态是否为「已连接」。
落地后怎么真正用起来 #
接完不等于能用。建议配三个东西：
- 角色（系统提示词）：告诉它身份、能干什么、不能干什么（比如别动财务文件）。
- 使用说明：在群里或公告里贴一段"@机器人 + 指令"的写法示例。
- 率先示范：你自己先发三条真实指令，把效果立住，团队才会跟上。
这三条对应的正是本站"机器人落地三动作"的思路，做不到位，机器人一个月后就变成沉默图标。
具体到 QQ 场景，这三件事建议这么落：
- 角色（系统提示词）：把身份、能干的事、红线写清，例如"你是交付群助理，负责整理交付进度与风险提醒；涉及金额、合同、客户承诺的问题一律回复'请找负责人确认'"。有了这条红线，同事瞎问时它不会乱答应。
- 使用说明：在群公告里贴一段最短的用法—— "@AI助理 + 一句人话指令"，再配两个例子（"@AI助理 汇总今天群里提到的待办"、"@AI助理 把上周的周报要点列出来"）。会写指令的人永远比会写 PNG 的人多。
- 率先示范：你自己先发三条真实指令，把效果立住。第一周的示范决定了这个机器人的生死，之后同事才会照着抄。
常见坑与 FAQ #
Q1：平台后台找不到「创建机器人」按钮。
先确认账号类型是否有创建资格；再看是否已实名认证；仍找不到，以开发者后台实际菜单为准，通常入口在应用管理或机器人管理区域。
Q2：App ID 和 App Secret 在哪？
在应用的「凭证 / 基本信息 / 开发信息」区域，创建完成后一般都能看到；有些平台需要点"查看"才显示完整值。
Q3：一直显示「未连接」。
按顺序查：凭据复制是否完整（最常带空格）、WorkBuddy 是否在运行、第 3 步的回调地址是否与 WorkBuddy 侧一致、应用是否已发布。
Q4：为什么群里 @ 了没反应？
确认机器人是否已加入该群（加群操作一般在群设置或机器人管理里）；再确认应用已发布并通过审核。
Q5：消息发过去很慢、时有时无。
QQ 开放平台的审核与消息通道可能有限流；同时确认那台电脑没有休眠、WorkBuddy 没被关掉。
Q6：能用几个机器人？
可以建多个，按群/用途拆分（一个交付群、一个运维告警群）。但一个机器人背后对应的是一台电脑上的 WorkBuddy 实例，别让一个机器人承担所有场景。
Q7：回调地址泄露了怎么办？
及时到平台重置/更换地址与密钥，并到 WorkBuddy 侧同步更新。地址或密钥一旦外泄，等于别人能往你的群发消息或读到你的消息。
小结 #
QQ 机器人这条路最值钱的地方是零迁移成本——团队不用换工具、不用学新界面，AI 直接进到他们本来就所在的群里。代价是它不承担组织级流程，别拿它替代正经的审批与台账。
本系列属于「专家与连接器」模块。需要给多个群配不同角色、统一凭据管理，本站提供 1v1 部署陪跑。
相关阅读：微信助理绑定教程 · 企业微信助理接入教程 · 群机器人 Webhook 与定时推送