# 腾讯频道（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 个机器人**，正好对上这个典型布局：

代码块

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

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

---

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

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

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

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

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

---

## 三、完整流程（5 步）

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

浏览器打开 **[AI 开发者管理平台 - QQ互联](https://connect.qq.com/ "AI 开发者管理平台 - QQ互联")**，用**你要接入的那个 QQ 号**登录（手机 QQ 扫码即可）。

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

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

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

![](https://developer.qcloudimg.com/http-save/yehe-8150249/80f2026f41d4a2f3a172b4ea01ae2e5e.png)

看图上有三种状态：

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

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

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

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

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

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

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

![](https://developer.qcloudimg.com/http-save/yehe-8150249/a02b4478c4a3d87aa3cb2275bfd14108.png)

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

它长这样：

代码块

```bash
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 号之后，头像就能自动取到了：

代码块

```bash
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互联](https://connect.qq.com/ "AI 开发者管理平台 - QQ互联") |
| Token 位置 | 我的账号凭证 → 对应账号那一行 |
| Token 格式 | `bot:v1_` + 100 多字符 |
| 显示次数 | **仅 1 次** |
| 失效方式 | 点「重新获取」/ 删除账号 |
| 头像地址 | `[https://q.qlogo.cn/headimg_dl?dst_uin=<QQ号>&spec=100](https://q.qlogo.cn/headimg_dl?dst_uin=%3CQQ%E5%8F%B7%3E&spec=100 "https://q.qlogo.cn/headimg_dl?dst_uin=<QQ号>&spec=100")` |

---

后台截图：  
![](https://developer.qcloudimg.com/http-save/yehe-8150249/a869b62fa750813415ddafb2148861de.png)

![](https://developer.qcloudimg.com/http-save/yehe-8150249/18939e1334c9e536167f2bff473ae372.png)

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

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

孜然QQ频道自动化程序机器人配置教程

人工智能

腾讯频道QQ机器人接入完整教程，核心步骤是从connect.qq.com获取Token（仅显示1次）。涵盖5步接入流程、Token失效风险、QQ号需手动填写的原因、常见FAQ及避坑清单，助你快速完成自建后台的机器人对接。

代码解释

OpenClaw

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

孜然QQ频道自动化程序机器人配置教程-腾讯云开发者社区-腾讯云

孜然QQ频道自动化程序机器人配置教程

孜然QQ频道自动化程序机器人配置教程

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐