OpenClaw 接入 QQ 机器人完整教程（2026）：扫码创建、三条命令搞定

为什么要接入 QQ

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

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

这篇文章把整个流程从头到尾走一遍，包括注册、创建机器人、接入 OpenClaw，还有一些容易踩的坑。如果你的 OpenClaw 还没装好，先去看这篇安装教程。

前置条件

需要两样东西：

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

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

注册 QQ 开放平台

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

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

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

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

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

创建 QQ 机器人

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

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

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

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

接入 OpenClaw

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

# 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），在联系人或搜索里找到你刚创建的机器人。给它发一条消息，比如「你好」。如果机器人正常回复了，说明全通了。

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

# 确认 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 安装教程。

群聊怎么用

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

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

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

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

groupPolicy 支持三种模式：

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

改完配置记得重启 Gateway：

openclaw gateway restart

跟 Telegram 对比

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

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

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

AppSecret 泄露了怎么办

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

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

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

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

常见问题

安装插件报错 npm ERR!

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

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 用户进入容器：

# 进入 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 进阶配置教程里的渠道管理章节。

后续能玩什么

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

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

如果你还想给 OpenClaw 装更多技能，可以去 ClawHub 看看有什么好用的 Skill。

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

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