> ## Content Index
> Fetch the complete content index at: https://tbbbk.com/llms.txt
> Use this file to discover other available public pages before exploring further.

# OpenClaw 接入 QQ 机器人完整教程（2026）：扫码创建、三条命令搞定
- URL: https://tbbbk.com/openclaw-qq-bot-setup-guide-2026/
- Published: 2026-03-08T08:51:51.000Z
- Updated: 2026-03-08T08:51:51.000Z
- Description: 腾讯专门给 OpenClaw 开了 QQ 机器人入口，扫码创建机器人、三条命令接入，不需要公网IP和Webhook。从注册到群聊配置全流程覆盖。
- Author: TuBaiBai
- Tags: OpenClaw, 折腾日记, #Import 2026-07-20 07:13

## 为什么要接入 QQ

OpenClaw 默认支持的 Telegram 和 Discord，国内用户得开代理才能用。之前我写过[飞书和钉钉的接入教程](https://tbbbk.com/openclaw-wechat-dingtalk-feishu-setup/)，算是解决了一部分问题。但说实话，飞书和钉钉更偏办公场景，日常随手跟 AI 聊天，大多数人还是习惯打开 QQ。

最近腾讯搞了个大动作——专门给 OpenClaw 开了 QQ 机器人的入口。不需要自己去折腾 QQ 开放平台的审批流程，扫个码就能创建机器人，三条命令接进 OpenClaw。我前两天看到消息的时候还有点不敢信，试了一下发现是真的，整个过程可能是我接入过的最简单的渠道。

这篇文章把整个流程从头到尾走一遍，包括注册、创建机器人、接入 OpenClaw，还有一些容易踩的坑。如果你的 OpenClaw 还没装好，先去看[这篇安装教程](https://tbbbk.com/openclaw-install-host-vs-docker-debian-ubuntu/)。

## 前置条件

需要两样东西：

- **OpenClaw 已安装且正常运行**。终端跑一下 `openclaw gateway status`，显示 running 就行。
- **一个 QQ 号**。对，就这么简单。不需要企业认证，不需要开发者账号，普通个人 QQ 就够了。

跟飞书要开发者权限、钉钉要建组织那些比起来，QQ 这次的门槛低得离谱。

## 注册 QQ 开放平台

打开腾讯专门给 OpenClaw 做的入口页面：

```text
https://q.qq.com/qqbot/openclaw/login.html
```

注意这个 URL——它不是 QQ 开放平台的常规入口，是腾讯专门给 OpenClaw 用户开的简化流程。

打开之后用手机 QQ 扫码登录。如果你之前没注册过 QQ 开放平台，扫码后会让你走一遍实名认证：填姓名、身份证号、手机号，然后人脸识别。整个过程跟注册微信小程序差不多，几分钟搞定。

已经注册过 QQ 开放平台的直接扫码就进去了，不用重复认证。

## 创建 QQ 机器人

这是整个流程里最魔幻的部分——登录开放平台之后，页面上直接有个「创建机器人」按钮，点一下就完事了。

不需要填应用名称，不需要写描述，不需要上传图标，不需要选权限。就是点一下。然后你就有了一个 QQ 机器人。

做过飞书和钉钉接入的人应该知道，光是创建应用这一步就要填一堆信息、勾一堆权限、提交审批等通过。QQ 这次属于是卷到极致了。我当时看到的时候第一反应是"不会吧，这就完了？"——确实就完了。连个机器人头像都不用设置，系统会自动给一个默认头像。

创建完成后，页面会直接给出三条命令，照着跑就行。命令都帮你拼好了，连 Token 值都填进去了，真正意义上的复制粘贴。

## 接入 OpenClaw

机器人创建好之后，页面给的三条命令长这样（Token 会是你自己的，这里用示例）：

```bash
# 1. 安装 QQ 机器人插件
openclaw plugins install @sliverp/qqbot@latest

# 2. 配置机器人 Token（AppID:AppSecret 格式）
openclaw channels add --channel qqbot --token "102917561:你的AppSecret"

# 3. 重启 Gateway 让配置生效
openclaw gateway restart
```

三条命令跑完，机器人就在线了。

关于第二条命令里的 Token 格式说明一下：它是 `AppID:AppSecret` 的组合，中间用冒号分隔。页面上创建完机器人会直接给你拼好的完整命令，复制粘贴就行，不需要自己拼。

### 验证是否成功

打开手机 QQ（或者电脑版 QQ），在联系人或搜索里找到你刚创建的机器人。给它发一条消息，比如「你好」。如果机器人正常回复了，说明全通了。

如果没有反应，先检查几个地方：

```bash
# 确认 Gateway 在运行
openclaw gateway status

# 查看实时日志，看有没有报错
openclaw logs --follow
```

最常见的问题是 Token 复制错了（多了空格或者少了一截），或者 gateway restart 之后没等它完全起来就发消息了。

## 一个 QQ 号能建 5 个机器人

一个 QQ 号最多可以创建 5 个机器人。如果你有多台跑 OpenClaw 的服务器，或者想给不同用途分开独立的会话，这个特性很实用。

比如我自己的用法：

- 机器人 1 接到 VPS 上的 OpenClaw，用来处理服务器运维相关的事
- 机器人 2 接到本地电脑的 OpenClaw，日常对话和文件处理

每个机器人都是独立的会话、独立的记忆，互不干扰。创建方法跟第一个一样，在开放平台里再点一次「创建机器人」就行。

## VPS 远程部署场景

很多人的 OpenClaw 跑在 VPS 上，这种情况下 QQ 机器人特别好用——手机 QQ 随时随地能用，不需要 SSH 连上去操作。

SSH 到你的 VPS，执行上面那三条命令就完事了。QQ 机器人插件用的是 WebSocket 长连接，**不需要你的 VPS 有公网域名，也不需要配 Webhook**。它会主动连出去跟腾讯的服务器建立连接，消息通过这条连接收发。

这意味着：

- 纯 IP 的 VPS 能用 ✅
- 在 NAT 后面的 VPS 能用 ✅
- 没配 SSL 证书的 VPS 能用 ✅

唯一的要求是你的 VPS 能访问外网（能连 qq.com 的服务器）。绝大多数 VPS 都满足这个条件。国内云厂商的机器（阿里云、腾讯云）自然没问题，海外 VPS 只要能连中国大陆方向的网络也行。我试过甲骨文的日本节点和搬瓦工的美西节点，都能正常连。

如果你的 OpenClaw 是 Docker 部署的，在容器里执行那三条命令就行，Docker 版的操作方式跟宿主机一样。更多 Docker 部署的细节可以看[1Panel + OpenClaw Docker 安装教程](https://tbbbk.com/1panel-openclaw-docker-install-guide-2026/)。

## 群聊怎么用

QQ 机器人默认支持私聊。群聊的话，把机器人拉进 QQ 群，在群里 @ 机器人就能触发对话。

不过有个注意点：群聊场景下，机器人只响应 @ 它的消息，不会自动读取所有群消息。这个行为跟 Telegram 的 Bot 类似——在群里必须 @ 才会触发。

如果你想让机器人在群里更活跃一些，可以在 OpenClaw 的配置里调整群消息策略。打开 `~/.openclaw/openclaw.json`（Docker 版对应容器内的路径），找到 channels 部分：

```json
{
  "channels": {
    "qqbot": {
      "enabled": true,
      "groupPolicy": "open"
    }
  }
}
```

`groupPolicy` 支持三种模式：

- `"open"` — 所有群消息都会收到（谨慎使用，token 消耗大）
- `"allowlist"` — 只响应指定群的消息
- `"off"` — 不处理群消息，只接受私聊

改完配置记得重启 Gateway：

```bash
openclaw gateway restart
```

## 跟 Telegram 对比

我同时在用 Telegram Bot 和 QQ 机器人接入 OpenClaw，说说实际体验上的区别。

| 维度    | QQ 机器人     | Telegram Bot             |
| ----- | ---------- | ------------------------ |
| 网络要求  | 国内直连 ✅     | 需要代理 ❌                   |
| 接入难度  | 3 条命令      | 找 BotFather 创建 + 配 Token |
| 实名认证  | 需要（身份证+人脸） | 不需要                      |
| 群聊支持  | @ 触发       | @ 触发 或全量监听               |
| 消息类型  | 文字、图片      | 文字、图片、文件、语音等             |
| 多端同步  | QQ 全平台     | Telegram 全平台             |
| 生态成熟度 | 新，社区插件     | 官方支持，最成熟                 |

简单说：在国内用，QQ 的体验远超 Telegram，因为不用翻墙这一条就是绝对优势。但 Telegram 在功能丰富度和生态成熟度上还是领先，比如 Telegram 支持 inline buttons、reactions、文件传输等高级特性，QQ 机器人目前还在补全这些能力。

我的建议是：如果你主要在国内使用，QQ 机器人作为主力渠道，Telegram 做备用。如果你长期挂代理没压力，那 Telegram 的体验上限更高。

## AppSecret 泄露了怎么办

如果不小心把 Token（AppID:AppSecret）泄露了——比如截图发群里忘了打码，或者不小心提交到了 GitHub——不用慌，处理很简单：

1. 去 QQ 开放平台，找到你的机器人，点「重置 AppSecret」
2. 拿到新的 Secret 之后，重新执行绑定命令：

```bash
openclaw channels add --channel qqbot --token "你的AppID:新的AppSecret"
openclaw gateway restart
```

旧的 Secret 会立刻失效，别人拿到了也用不了。

## 常见问题

### 安装插件报错 npm ERR!

如果 `openclaw plugins install @sliverp/qqbot@latest` 报 npm 相关的错误，大概率是网络问题。试试先设 npm 国内镜像：

```bash
npm config set registry https://registry.npmmirror.com
# 然后重新安装
openclaw plugins install @sliverp/qqbot@latest
```

### 机器人不回消息

按这个顺序排查：

1. `openclaw gateway status` 确认 Gateway 在跑
2. `openclaw logs --follow` 看日志，找 qqbot 相关的错误信息
3. 确认 Token 格式对不对——必须是 `AppID:AppSecret`，冒号分隔，不要有多余空格
4. 确认 QQ 开放平台那边机器人状态是「已上线」

### Docker 容器里安装插件报权限错误

如果你的 OpenClaw 跑在 Docker 里，进容器后执行插件安装可能会遇到权限问题。确保你是用 root 用户或者 openclaw 用户进入容器：

```bash
# 进入 OpenClaw 容器
docker exec -it openclaw bash

# 然后正常执行三条命令
openclaw plugins install @sliverp/qqbot@latest
openclaw channels add --channel qqbot --token "你的Token"
openclaw gateway restart
```

### 已经接了 Telegram，再接 QQ 会冲突吗

不会。OpenClaw 支持同时接入多个渠道，Telegram、QQ、飞书、钉钉可以全部同时在线。每个渠道都是独立的会话，你在 QQ 里问的问题不会出现在 Telegram 的对话里，反过来也一样。

想了解更多多渠道配置的玩法，可以看[OpenClaw 进阶配置教程](https://tbbbk.com/openclaw-advanced-config-guide/)里的渠道管理章节。

## 后续能玩什么

QQ 机器人接好之后，OpenClaw 的所有能力都能通过 QQ 来调用。几个值得试的玩法：

- **日常问答**：随手问问题、翻译、写邮件，比开浏览器用 ChatGPT 方便
- **服务器管理**：如果 OpenClaw 跑在 VPS 上，你可以通过 QQ 让它帮你查服务器状态、重启服务
- **定时任务**：[配好 Cron](https://tbbbk.com/openclaw-advanced-config-guide/)，让它每天定时通过 QQ 推送天气、新闻摘要、日程提醒
- **群里当助手**：拉进工作群或朋友群，@ 它就能帮大家查资料、总结讨论

如果你还想给 OpenClaw 装更多技能，可以去 [ClawHub 看看有什么好用的 Skill](https://tbbbk.com/clawhub-skill-picks-for-china-users/)。

QQ 机器人这个渠道目前还在快速迭代中，功能应该会越来越完善。能这么简单就把 AI 助手接进 QQ，说实话我还是挺惊喜的——毕竟之前在国内用 OpenClaw 最大的痛点就是渠道不方便，现在算是彻底解决了。相比之下飞书要搞应用权限和审批，钉钉要装社区插件还要建组织，QQ 这个扫码三条命令的体验直接把它们按在地上摩擦。

对了，如果你还在纠结 OpenClaw 到底选哪个渠道的，我列个简单的决策树：国内个人用 → QQ 机器人；国内办公 → 飞书/钉钉（看公司用哪个）；不介意翻墙 → Telegram（功能最全）。多渠道可以同时开，不冲突。