OpenClaw 接入 QQ 机器人：手把手教你在 QQ 里拥有自己的 AI 助手

什么是 OpenClaw？为什么要接入 QQ？

先说人话：OpenClaw 就是一个能帮你把 AI 连接到各种聊天软件上的工具。

把它装好、配置好之后，你就能在 QQ 里直接和 AI 对话，就像跟一个真人朋友聊天一样——问它问题、让它帮你写东西、查资料，甚至帮你做日程提醒，都行。

那为什么偏偏选 QQ 呢？原因很实在：

• 不花钱：钉钉机器人要收费，飞书也有各种限制，而 QQ 对个人用户完全免费开放。
• 不用翻墙：Telegram、Discord 虽然也能接 AI，但在国内用起来很折腾。QQ 随时随地都能用，信号稳、速度快。
• 你已经有 QQ 了：不需要再下载什么新软件，打开 QQ 就能用上 AI，多省事。
• 功能齐全：私聊、群聊、@ 提醒……QQ 本身的功能已经够丰富了，完全够 AI 助手施展拳脚。

接下来这篇文章会带你从头到尾走一遍，哪怕你从来没碰过"命令行"这种东西，照着做也能搞定。每一步我都会尽量讲清楚，遇到命令只需要复制粘贴就行。

开始之前你需要准备什么

动手之前先检查一下这几样东西：

你可能注意到很多教程会提到 “Node.js” 这个东西。

简单理解，它就是 OpenClaw 运行时需要的一个"底层引擎"，就像手机 App 需要操作系统才能运行一样。

好消息是：OpenClaw 的安装脚本会帮你自动装好 Node.js，不需要你单独去处理。

如果你想确认自己电脑上有没有装过 Node.js，可以这样检查：

• Windows：按下键盘上的 Win 键，输入 cmd 打开命令提示符，然后输入 node --version 回车
• Mac：打开"启动台"里的"终端"，输入 node --version 回车

看到类似 v22.x.x 这样的数字就说明已经有了。看到报错也没关系，后面安装 OpenClaw 的时候会自动帮你搞定。

第一步：安装 OpenClaw

OpenClaw 在每个系统上的安装方式略有不同，但都非常简单——核心操作就是打开一个"命令窗口"，然后粘贴一行命令，等它自动跑完就好。

Windows 电脑安装

见【Windows 部署安装 OpenClaw 教程：零基础小白也能搞定的完整指南】

Mac 电脑安装

见【Mac 部署安装 OpenClaw 教程：从零搭建个人 AI 助手完整指南】

Linux 系统安装

见【Linux 部署安装 OpenClaw 教程：从环境搭建到生产运行的完整指南】

用云服务器安装（不想用自己电脑的看这里）

见【云服务器 部署安装 OpenClaw 教程】

第二步：在 QQ 上创建你的机器人

OpenClaw 装好了，接下来要在 QQ 那边创建一个机器人账号——你可以把它理解为给 AI 注册一个"QQ 号"。

扫码登录 QQ 开放平台

用电脑浏览器打开下面这个网址：

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

页面上会显示一个二维码，拿出手机打开 QQ，扫一下这个码就能登录。

如果你是第一次用这个平台，会让你做一次实名认证：填写姓名、身份证号，然后刷个脸。听起来有点麻烦，但实际上一两分钟就能搞定，而且只需要做一次。

创建机器人并起个名字

登录之后，你会看到一个 “创建机器人” 的按钮，点一下就好。然后填写以下内容：

1. 机器人名称：随便取一个你喜欢的名字，比如"小助手"、“AI 小秘书”、“知识星球"之类的。
2. 头像：上传一张图片作为机器人的头像，让它看起来更有个性。
3. 描述：简单写一句话说明它是干什么的，比如"一个能回答各种问题的 AI 助手”。
4. 点击 “确认” 完成创建。

每个 QQ 账号目前最多可以创建 5 个机器人，所以可以放心尝试。

保存好两串重要的字符

机器人创建成功后，页面上会显示两个非常关键的信息：

• AppID：一串数字，相当于机器人的"身份证号"
• AppSecret：一串字母和数字的组合，相当于机器人的"密码"

划重点：AppSecret 只会显示这一次！ 页面关掉之后就再也看不到了。所以请你现在就把它们复制下来，保存到手机备忘录、电脑记事本、或者任何你不会弄丢的地方。如果真的忘记保存了，也不用慌，后面"常见问题"部分会告诉你怎么重新生成。

回到 QQ 界面，你就可以收到刚才创建的 QQ 机器人给你发了一条新消息。

提示：如果找不到，到 QQ 开放平台的沙箱配置页面扫码添加好友

云服务器用户额外要做的事：添加 IP 白名单（选）

如果你的 OpenClaw 装在自己的电脑上，这一步可以跳过。

如果 OpenClaw 装在云服务器上，你需要告诉 QQ 平台"这台服务器是可信的"，否则机器人不会响应。

操作方法：在机器人管理页面，找到 “开发管理” → “IP 白名单”，把你的云服务器公网 IP 地址填进去保存就好。

公网 IP 可以在你购买的云服务器控制台里找到。

备注：如果找不到可以先忽略，后面有问题再回来配置，大部分不会有问题

把自己加到测试名单里（选）

机器人刚创建好的时候处于"测试模式"（也叫沙箱模式），只有被添加到测试名单里的人才能跟它聊天。

1. 在机器人管理页面的左侧菜单，找到 “沙箱配置”。
2. 点击 “添加成员”，输入你自己的 QQ 号，或者扫码添加。
3. 添加完成后，在 QQ 好友列表里找到你的机器人（可能需要扫码添加好友），就可以开始聊天了。

备注：如果找不到可以先忽略，后面有问题再回来配置，大部分不会有问题

第三步：把 OpenClaw 和 QQ 机器人连起来

针对 Mac / Windows / Linux 部署 OpenClaw

这是整个过程中最关键的一步，但也是最简单的——只需要在命令窗口里依次执行 3 条命令。

打开你的命令窗口（Windows 用 PowerShell，Mac/Linux 用终端），然后依次复制粘贴以下命令，每输入一条就按一次回车：

命令 1：安装 QQ 机器人插件

openclaw plugins install @sliverp/qqbot@latest

这条命令会下载一个让 OpenClaw 能对接 QQ 的插件，等它跑完就行。

命令 2：绑定你的机器人

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

把命令中的 你的AppID 和 你的AppSecret 替换成你之前保存的那两串字符。注意中间用英文冒号 : 隔开，两头用英文双引号 " 包住。

比如你的 AppID 是 102917561，AppSecret 是 abcdef123456，那命令就是：

openclaw channels add --channel qqbot --token "102917561:abcdef123456"

命令 3：重启让配置生效

openclaw gateway restart

三条命令全部执行完毕后，你可以再输入一条命令检查状态：

openclaw channels

如果看到 qqbot 后面显示 running，那就恭喜你——配置成功了！

针对云服务部署 OpenClaw

如果你是云服务部署的 OpenClaw，比如腾讯云一键部署 OpenClaw；

进入腾讯云控制台，选中对应的已部署OpenClaw的Lighthouse服务器，点击服务器卡片进入“管理实例”页面。

配置 QQ 机器人 App ID 和 App Secret

进入“应用管理”页签，在“Channel配置” 中，选择“QQ”并输入在前面步骤中获取的QQ机器人App ID和App Secret，并点击添加并应用并确定操作，等待几十秒后页面提示“保存成功”即完成配置。

注意：如果之后和QQ 机器人对话时，出现“该机器人去火星了，稍后再试吧”，大概率就是是因为没有正确配置 App ID 和App Secret，可重新按照这些步骤尝试配置。

第四步：打开 QQ 开始聊天

和机器人私聊

打开手机 QQ 或者电脑 QQ，在好友列表里找到你创建的那个机器人（如果找不到，回到 QQ 开放平台的沙箱配置页面扫码添加好友）。

试着给它发几条消息看看效果：

• 发 “你好”——它会跟你打招呼
• 发 “明天北京天气怎么样”——它会帮你查天气
• 发 “帮我写一段 200 字的自我介绍”——它会帮你写文案
• 发 “123 乘以 456 等于多少”——它也能帮你算数

如果能收到回复，说明一切都搞定了！

在群聊里使用

你也可以把机器人拉进 QQ 群，让群里的人都能用上 AI：

1. 在 QQ 群设置里邀请机器人加入群聊。
2. 群里发消息时需要 @ 一下机器人 它才会回复，不会打扰正常的群聊。
3. 多个人可以同时跟它聊，互不影响。

你可以用它做什么

接入成功后，你的 QQ 机器人就具备了 AI 对话能力，用途非常广：

• 日常问答：不懂的问题直接问它，比百度搜索还方便
• 写作帮手：让它帮你写周报、朋友圈文案、祝福语、邮件回复
• 学习辅导：遇到不会的英语单词、数学题、概念解释，直接问它
• 翻译工具：发一段英文过去，它马上帮你翻译成中文
• 头脑风暴：需要想点子、做计划的时候，让它帮你出主意
• 群聊助手：在群里 @ 它就能回答大家的问题，省得你当"人肉百科"

想要更多控制？看看进阶配置

这部分内容适合有一定动手能力、想要深度定制机器人行为的用户。如果你只是想正常使用，上面的步骤已经完全够了，可以跳过这一节。

修改配置文件

OpenClaw 的所有配置都保存在一个文件里。如果你想手动调整一些设置，可以找到并编辑这个文件：

• Windows：文件路径是 C:\Users\你的用户名\.openclaw\config.json
• Mac / Linux：文件路径是 ~/.openclaw/config.json

用任意文本编辑器（记事本就行）打开它，找到 channels 这一段，你会看到类似这样的内容：

{
  "channels": {
    "qqbot": {
      "enabled": true,
      "appId": "你的AppID",
      "clientSecret": "你的AppSecret",
      "dmPolicy": "open",
      "groupPolicy": "open"
    }
  }
}

修改完保存，然后执行一下重启命令让新配置生效：

openclaw gateway restart

私聊和群聊的策略怎么选

配置文件里有两个控制"谁能跟机器人聊天"的设置项：

如果只是自己用，两个都设成 open 就行。如果你打算让很多人使用，建议改成 allowlist 控制一下范围，避免被不认识的人滥用。

常见问题

Q1：执行命令时提示 “Unknown channel: qqbot” 是什么意思？

这是说 QQ 插件没有装好。重新执行安装命令试一下：

openclaw plugins install @sliverp/qqbot@latest

如果还是装不上，可能是网络问题，先切换到国内的下载源：

npm config set registry https://registry.npmmirror.com
openclaw plugins install @sliverp/qqbot@latest

Q2：机器人创建好了，QQ 里发消息却没有回复？

别着急，按照下面的顺序逐一排查：

1. 检查 AppID 和 AppSecret：确认你粘贴的时候没有多复制空格或者少复制字符。
2. 检查沙箱名单：如果你的 QQ 号还没被加到沙箱成员里，机器人是不会回复的。回到 QQ 开放平台把自己加进去。
3. 检查 IP 白名单（云服务器用户）：确认服务器的公网 IP 已经加到了白名单里。
4. 检查机器人状态：在命令窗口执行 openclaw channels，看看 qqbot 是不是 running 状态。
5. 看看日志找线索：执行 openclaw logs --tail 50，日志里通常会写明具体出了什么问题。

Q3：Windows 上提示"脚本被禁止运行"怎么办？

这是 Windows 的安全策略在起作用。用管理员身份打开 PowerShell，先执行这条命令：

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

输入 Y 确认后，再重新运行安装命令就好了。

Q4：安装过程中下载特别慢，甚至超时了？

在国内网络下有时候确实会慢。解决办法是切换到国内的下载源，执行：

npm config set registry https://registry.npmmirror.com

切换完之后再重新执行安装命令，速度会快很多。

Q5：三条命令都执行了，但 qqbot 状态不是 running？

可以看看日志来找原因：

openclaw logs --tail 100

比较常见的情况有：

• AppID 或 AppSecret 填错了：回到 QQ 开放平台确认一下，重新执行绑定命令
• 端口被占用：OpenClaw 默认用 18789 端口，如果这个端口被其他软件占了，就会启动失败
• 配置文件格式错误：如果你手动编辑过配置文件，检查一下有没有漏掉逗号或者括号

Q6：在自己电脑上运行 OpenClaw 需要配置 IP 白名单吗？

一般不需要。IP 白名单主要是给云服务器用户准备的。如果你的 OpenClaw 就装在自己的电脑上，直接跳过这步就行。

Q7：AppSecret 忘记保存了怎么补救？

没关系，还有救。回到 QQ 开放平台，进入你的机器人管理页面，在 “开发管理” 里找到密钥信息，点 “重置” 就能生成一个新的 AppSecret。

拿到新密钥后，重新执行绑定和重启命令：

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

Q8：我完全没用过命令行，感觉好复杂怎么办？

其实你需要做的只是"打开一个窗口"然后"复制粘贴命令"，并不需要自己写任何东西。如果你用 Windows，就打开 PowerShell；如果你用 Mac，就打开终端。把文章里的命令原封不动地复制进去，按回车就行了。整个过程跟在浏览器地址栏里粘贴网址差不多简单。

如果实在觉得命令行不好操作，可以考虑用腾讯云或阿里云的一键部署方案，全程都是图形化界面，点鼠标就能完成。

总结

整篇文章虽然看起来挺长，但实际操作起来核心步骤就四个：

1. 装 OpenClaw：打开命令窗口，粘贴一行安装命令，等它自动完成。
2. 创建 QQ 机器人：在网页上扫码登录，填个名字，记下 AppID 和 AppSecret。
3. 三条命令连起来：安装插件 → 绑定凭证 → 重启服务，三条命令复制粘贴搞定。
4. 打开 QQ 聊天：给机器人发条消息，收到回复就大功告成。

熟练的话整个过程 3 分钟就能搞定，第一次操作也不会超过 15 分钟。完成后你就拥有了一个专属的 QQ AI 助手，随时随地打开 QQ 就能和 AI 对话，问问题、写文案、查信息、做翻译……它几乎什么都能帮你。

如果大家在操作过程中遇到了任何问题，或者有什么好玩的玩法想分享，都欢迎在评论区留言交流。看到必回！～～～