腾讯频道（QQ频道）机器人接入完整教程：从 connect.qq.com 获取 Token

本文记录把 QQ 机器人接入自建管理后台的完整流程。整件事的核心只有一句话：从 connect.qq.com 拿到 Token。

---

目录

1. 先理清三个概念
2. 最重要的一条：Token 只显示 1 次
3. 完整流程（5 步）
4. 为什么 QQ 号必须手动填？
5. 常见问题 FAQ
6. 避坑清单

---

一、先理清三个概念

在动手之前，先把这三个东西分清楚，后面就不会乱。

概念	在 connect.qq.com 上的样子	作用
主号（QQ账号）	灰色「QQ账号」标签	真人号，负责创建频道、拿收益
机器人	蓝色「机器人」标签	干活的号，按角色分工
Token	bot:v1_xxxxxxxx...	唯一的接入凭据，相当于账号的钥匙

机器人按角色分成三类：

• 发布 —— 往频道发视频 / 图文帖，一个主号一般配 3 个
• 私聊 —— 主动私信用户（拉新 / 引流），配 1 个
• 评论区 —— 回复评论、与人互动，增加频道活跃度，配 1 个

一个 QQ 号最多创建 5 个机器人，正好对上这个典型布局：

代码块

主号
├── 发布 ×3
├── 私聊 ×1
└── 评论区 ×1

注意：只有两级结构。主号是顶级账号，打手挂在主号下面，打手下面不能再挂打手。

---

二、最重要的一条：Token 只显示 1 次

这是整个流程里唯一容易翻车的地方，先单独说：

点完「获取 Token」必须当场复制。关掉页面就再也看不到了。

如果没复制到，只能回去点「重新获取」再生成一个 —— 而重新获取会让旧 Token 立刻失效。如果你已经把这个账号接进了后台，它会直接断线，你得回去把新的 Token 重新填一遍。

所以顺序永远是：先复制，再关页面。

---

三、完整流程（5 步）

步骤 1：打开腾讯频道开放平台并登录

浏览器打开 AI 开发者管理平台 - QQ互联，用你要接入的那个 QQ 号登录（手机 QQ 扫码即可）。

登录后进入「我的账号凭证」页面。

步骤 2：在「我的账号凭证」里找到目标账号

这一页会列出这个 QQ 号下面的所有账号，每行都直接写着 QQ 号 —— 这就是你后面要手填的那个号码的来源。

看图上有三种状态：

• 带灰色「QQ账号」标的是真人号（对应后台的「主号」）
• 带蓝色「机器人」标的是机器人（对应「发布 / 私聊 / 评论区」）
• 已经有 Token 的账号，下面会显示打码的 Token（形如 bot:v1_*********************61ZQ）和创建时间，右边是「重新获取 | 删除」
• 还没有 Token 的机器人，右边是蓝色的「获取 Token」按钮

步骤 3：点那一行的「获取 Token」

机器人默认是没有 Token 的，按钮显示「获取 Token」，点一下即可。

如果那行显示的是「重新获取」，说明它已经有 Token 了 —— 别随便点。点了旧 Token 会立即失效，后台里填好的那个账号会直接断线。

步骤 4：当场复制 Token（只显示这一次！）

点完会提示「创建成功」，这张卡片下面会展开一个面板，明确写着：

Skill 安装命令：复制后直接发送给你的 OpenClaw AI 助手 （本 Token 仅展示 1 次，请记得保存。如安装失败，可切换其他渠道重试）

红框里就是你的 Token，点右边的「复制 Token」把整串复制走。

它长这样：

代码块

bot:v1__yMhsPBtUAnjg-IhIJB7228_U1hNb4vvSB1vuDAC9gMlnHLGDKHhH-5ZzKsfwzdkCNxbL-8YQHlY-PbHjA0RRKmXoz-4O2c3YhydkPa2Ts-eKY_33Zq5PqKe_Gw

特征：

• 以 bot:v1_ 开头
• 总长 100 多个字符
• 包含大小写字母、数字、- 和 _

面板下方还有个「复制安装指令」按钮和 QQ官方 / SkillHub / Github / ClawHub 几个渠道标签 —— 那是给腾讯自家的 AI 助手用的，如果你是自己写代码调用，不需要管它，只复制 Token 就够了。

步骤 5：回到后台填写

进后台「机器人管理」→「新增」，按下面填：

字段	怎么填
Token	粘贴刚复制的那一长串。粘贴后点右边的「读取」，系统会真的去连一次腾讯，验证 Token 是否有效，并把昵称自动填进「名称」框
名称	点「读取」后会自动填上，也可以手动改
QQ 号	必须手动填（原因见下一节）。填了之后头像才能自动取到
角色	真人号选「主号」；机器人按用途选「发布 / 私聊 / 评论区」
上级主号	角色不是「主号」时必填，选它归属的那个主号。一个主号下最多 5 个

填完保存即可。

---

四、为什么 QQ 号必须手动填？

因为腾讯的接口刻意不返回 QQ 号。

腾讯频道开放平台用 tiny_id（一串 18 位的内部 ID，而且每个频道还不一样）作为成员标识，就是为了切断和 QQ 号的关联。

我把平台提供的 55 个官方工具的参数定义全部翻过一遍，没有任何一个字段能拿到 QQ 号：

工具	返回的字段	有 QQ 号吗
get_user_info	City / Country / Gender / IsGuildAuthor / MemberName / NickName / Province	❌
get_guild_member_list	JoinTime / Location / MemberName / NickName / Role / Type	❌
guild_member_search	只有 nickname + tinyid	❌

成员列表返回的 key 是 admins / ai_members / members / owners / robots / tinyid / 加入时间 / 性别 / 昵称 —— 整份输出里一个 5~11 位的数字都没有。

有意思的是，平台有个叫 push_qq_msg 的工具，功能是「给用户自己推送一条 QQ 消息」，调用时不需要传 QQ 号 —— 说明服务端是知道你的 QQ 号的，只是故意不下发。

所以结论很明确：QQ 号只能从 connect.qq.com 那一行手抄过来。

好消息是，填了 QQ 号之后，头像就能自动取到了：

代码块

https://q.qlogo.cn/headimg_dl?dst_uin=<QQ号>&spec=100

---

五、常见问题 FAQ

Q1：Token 没复制到，怎么办？

只能回 connect.qq.com 点「重新获取」再生成一个。

注意：重新获取会让旧的立刻失效。如果后台里已经填过旧 Token，记得回去把新的填进去。

Q2：点「读取」提示「Token 无效或已失效」

三种可能：

1. Token 复制时漏了头尾（必须以 bot:v1_ 开头，一整串 100 多个字符）
2. 在 connect.qq.com 上点过「重新获取」，旧 Token 已经作废
3. 在 connect.qq.com 上把这个账号「删除」了

回 connect.qq.com 核对一遍，或者重新获取一个。

Q3：一个 QQ 号能接几个机器人？

最多 5 个。这正好对上典型布局：1 个主号 + 3 个发布 + 1 个私聊 + 1 个评论区。

Q4：主号和打手是什么关系？

两级结构：

• 主号是一级账号，负责创建频道、拿收益。不能有上级，角色也不能改（要换请删掉重建）
• 打手必须选一个上级主号，一个主号下最多 5 个
• 不支持三级 —— 打手下面不能再挂打手

Q5：删除主号会怎样？

它名下的打手会一起被删掉（连带磁盘上的 Token 凭据文件）。删除前会弹确认框，把要连带删掉的打手名字列出来。

Q6：那串「Skill 安装命令」是干什么的？

那是腾讯给自家 AI 助手（OpenClaw）准备的，复制后发给 AI 就能自动装好官方 Skill。

如果你是自己写代码调用官方接口，不需要它 —— 拿到 Token 就能直接调 API。

---

六、避坑清单

照着做，基本不会踩坑：

•  点「获取 Token」之前，先确认浏览器没开无痕 / 剪贴板可用
•  点完「获取 Token」，第一件事是复制，别先去干别的
•  已经接进后台的账号，不要点「重新获取」，点了就得重新填
•  不要在 connect.qq.com 上删除账号，删了 Token 立刻失效
•  QQ 号记得从 connect.qq.com 那一行抄，抄完核对一遍位数
•  一个主号下最多 5 个打手，超了会被拦
•  打手不能挂打手，不支持三级结构

---

附：Token 速查

项目	值
平台地址	AI 开发者管理平台 - QQ互联
Token 位置	我的账号凭证 → 对应账号那一行
Token 格式	bot:v1_ + 100 多字符
显示次数	仅 1 次
失效方式	点「重新获取」/ 删除账号
头像地址	https://q.qlogo.cn/headimg_dl?dst_uin=<QQ号>&spec=100

---

后台截图：

本文基于实际操作整理，截图来自真实后台。