手把手教你 OpenClaw 接入 QQ 机器人，让本地 AI 在 QQ 里听你指挥

💬 本文带你：OpenClaw对接QQ

一、为什么选择 QQ 机器人？

很多同学第一反应是：为什么不接钉钉 / 飞书 / 企业微信？
说白了：免费不够用、想买又太贵。

1.1 国内 IM 「按 API 收费」

平台	收费方式（典型情况）
钉钉	必须上专业版，一年近 1 万，API每月50万调用次数
飞书	按 600 元/人/年计费，用户越多越贵。
企业微信	整体价格偏高

而我们做本地 OpenClaw，初衷就是——低成本甚至零成本地玩 AI、用 AI。

1.2 国外 IM：体验和合规都不理想

一句话：Telegram / Discord / Slack 这些海外 IM，在国内要么连不上、要么难推广，还牵扯合规问题，所以理论上可行，现实上很难落地。

1.3 为什么最终选 QQ？

综合以上几点，我最后选了 QQ：

优势	说明
成本几乎为 0	QQ 机器人开放平台对个人开发者非常友好
功能足够丰富	支持私聊、群聊、@ 提醒等能力，用来做「本地 AI 助手」完全够用

一句话总结：

把本地 OpenClaw 接到一个「大家都用得起、用得顺手」的 IM 上，QQ 目前是性价比最高的选择。

---

二、准备工作：确保环境就绪

在开始配置之前，请确保你的环境满足以下要求：

前置条件检查清单

✅ Node.js 版本：v22+（推荐使用 nvm 管理）
✅ 操作系统：Windows（本文以 Windows 为例）
✅ OpenClaw 版本：2026.2.9+
✅ QQ 账号：需要实名认证的 QQ 账号

1. 检查 Node.js 版本

node --version

确保版本是 v22。如果不是，可以使用 nvm 切换：

nvm use 22

2. 检查 OpenClaw 是否已安装

打开 PowerShell（建议以管理员身份运行），执行：

openclaw --version

如果显示版本号，说明已安装。如果没有，请先参考之前的文章安装 OpenClaw。

---

三、安装 QQ 机器人插件

QQ 机器人功能需要通过插件来实现，我们需要安装 @sliverp/qqbot 插件。

步骤 1：进入 OpenClaw 配置目录

cd C:\Users\DELL\.openclaw

步骤 2：安装 QQ 机器人插件

npm install @sliverp/qqbot@1.3.7 --save

安装过程可能需要几分钟，请耐心等待。（如果慢的话，可以科学上网，会快一些）

步骤 3：复制插件到 OpenClaw 扩展目录

安装完成后，需要将插件复制到 OpenClaw 的扩展目录：

插件安装目录：

C:\Users\DELL\.openclaw\node_modules\@sliverp\qqbot

目标目录：

C:\Users\DELL\AppData\Roaming\npm\node_modules\openclaw\extensions\qqbot

⚠️ 注意：

• 请将路径中的 DELL 替换为你实际的用户名
• 如果你的 nvm 安装路径不同，请相应调整路径
• 如果 OpenClaw 是全局安装的，路径可能是：C:\Users\你的用户名\AppData\Roaming\npm\node_modules\openclaw\extensions\qqbot

步骤 4：启用插件

# 启用 qqbot 插件
openclaw plugins enable qqbot

# 查看已安装的插件列表
openclaw plugins list

如果看到 qqbot 插件已启用，说明安装成功！

---

四、注册 QQ 机器人

现在我们需要在 QQ 机器人开放平台注册一个机器人。

步骤 1：访问 QQ 机器人开放平台

1. 打开浏览器，访问：QQ 机器人开放平台
2. 使用 QQ 扫码登录（需要实名认证）
3. 如果没有注册开放平台，可以先注册。

步骤 2：创建机器人

1. 登录后，点击「创建机器人」
2. 填写机器人名称和描述（可以随意填写，后续可以修改）
3. 阅读并同意服务协议
4. 点击「创建」

步骤 3：获取 AppID 和 AppSecret

创建成功后，进入「开发管理」页面：

1. 找到「基础信息」部分
2. 记录下：
   • AppID（类似：1234567890）
   • AppSecret（类似：abcdefghijklmnopqrstuvwxyz123456）

🔒 安全提示：AppSecret 非常重要，请妥善保管，不要泄露！

步骤 4：配置沙箱环境（测试用）

由于个人开发者需要审核才能正式上线，我们可以先在沙箱环境中测试：

1. 进入「成员管理」→ 添加管理员 QQ 号（如果已经是管理员可跳过）
2. 进入「沙箱配置」→ 「消息列表配置」
3. 添加你的 QQ 号到测试成员列表

步骤 5：添加机器人为好友

1. 点击左侧菜单的「使用范围和人员」
2. 使用你的 QQ 扫码添加机器人为好友

---

五、配置并启动 OpenClaw

现在回到本地，配置 OpenClaw 连接到 QQ 机器人。

步骤 1：添加 QQ 频道配置

在 PowerShell 中执行：

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

💡 格式说明：token 的格式是 AppID:AppSecret，中间用冒号连接

示例：

openclaw channels add --channel qqbot --token "1234567890:abcdefghijklmnopqrstuvwxyz123456"

步骤 2：重启 OpenClaw 网关

配置完成后，需要重启网关使配置生效：

openclaw gateway restart

步骤 3：查看运行状态

重启后，可以查看日志确认是否正常运行：

openclaw logs --tail 50

如果看到类似以下信息，说明连接成功：

[INFO] qqbot channel connected
[INFO] Gateway started successfully

---

六、测试：在 QQ 中与 AI 对话

现在一切就绪，让我们来测试一下！

测试步骤

1. 打开 QQ，找到你刚才添加的机器人好友
2. 发送一条消息，例如："你好，介绍一下你自己"
3. 等待回复，OpenClaw 会处理你的消息并回复

测试场景

场景	测试内容	预期结果
基础对话	"你好"	AI 正常回复问候
代码生成	"帮我写一个 Python 的冒泡排序"	AI 返回代码
问题解答	"什么是 OpenClaw？"	AI 解释 OpenClaw
工具调用	"帮我查一下今天的天气"	AI 调用工具并返回结果

---

七、常用命令速查

为了方便后续使用，这里整理了一些常用命令：

插件管理

# 查看已安装的插件列表
openclaw plugins list

# 查看插件状态
openclaw plugins status

# 禁用插件
openclaw plugins disable qqbot

# 启用插件
openclaw plugins enable qqbot

频道管理

# 查看已配置的频道
openclaw channels list

# 删除频道
openclaw channels remove qqbot

# 更新频道配置
openclaw channels add --channel qqbot --token "新的AppID:新的AppSecret"

日志和调试

# 查看最新 50 条日志
openclaw logs --tail 50

# 实时查看日志
openclaw logs --follow

# 查看网关状态
openclaw gateway status

# 重启网关
openclaw gateway restart

---

八、常见问题排查

在实际使用过程中，可能会遇到一些问题。这里整理了一些常见问题和解决方案：

问题 1：Unknown channel: qqbot

错误信息：

Error: Unknown channel: qqbot

可能原因：

• 插件未正确安装到 extensions 目录
• 插件未启用

解决方案：

1. 确认插件已复制到正确位置：

   dir "C:\Program Files\nvm\v22.22.0\node_modules\openclaw\extensions\qqbot"
   

2. 确认插件已启用：

   openclaw plugins enable qqbot
   

3. 重启网关：

   openclaw gateway restart
   

问题 2：机器人无响应

现象：在 QQ 中发送消息，机器人不回复

排查步骤：

1. 检查日志：

   openclaw logs --tail 50
   

   查看是否有错误信息

2. 确认 AppID 和 AppSecret 正确：

   • 检查配置的 token 格式是否正确（AppID:AppSecret）
   • 确认没有多余的空格或换行

3. 确认沙箱配置：

   • 确认你的 QQ 号已添加到沙盒测试成员列表
   • 确认已添加机器人为好友

4. 检查网络连接：

   • 确认本地网络可以访问 QQ 开放平台 API
   • 如果有代理，确认代理配置正确

问题 3：无法添加机器人为好友

现象：扫码后无法添加好友

解决方案：

1. 确认已在「成员管理」中添加你的 QQ 号为管理员
2. 确认已在「沙盒配置」→「消息列表配置」中添加你的 QQ 号
3. 尝试重新生成二维码
4. 确认 QQ 账号已实名认证

问题 4：插件安装失败

现象：执行 npm install 时报错

解决方案：

1. 检查 Node.js 版本：

   node --version
   

   确保是 v22

2. 清理缓存重试：

   npm cache clean --force
   npm install @sliverp/qqbot@1.3.7 --save
   

3. 使用国内镜像（如果网络问题）：

   npm install @sliverp/qqbot@1.3.7 --save --registry=https://registry.npmmirror.com
   

问题 5：网关启动失败

现象：执行 openclaw gateway restart 后无法启动

排查步骤：

1. 查看详细错误信息：

   openclaw logs --tail 100
   

2. 检查配置文件：

   type C:\Users\DELL\.openclaw\openclaw.json
   

   确认 JSON 格式正确

3. 检查端口占用：

   netstat -ano | findstr :端口号
   

---

九、进阶配置：群组和权限管理

配置成功后，你还可以进一步配置群组功能和权限管理。

群组配置

QQ 机器人支持群聊功能，你可以在群组中添加机器人：

1. 创建或加入一个 QQ 群
2. 将机器人拉入群组（需要管理员权限）
3. 在群组中@机器人，即可触发 AI 回复

权限配置

在 QQ 机器人开放平台，你可以配置：

• 消息权限：控制机器人可以接收哪些消息
• 成员权限：控制哪些成员可以@机器人
• 功能权限：控制机器人可以使用哪些功能

---

十、实战演示：让 AI 帮你写代码

现在让我们用一个实际场景来演示 QQ + OpenClaw 的强大功能。

场景：在 QQ 中让 AI 写代码

1. 打开 QQ，找到机器人好友
2. 发送指令： 帮我写一个 Python 函数，实现快速排序算法，要求： - 函数名为 quick_sort - 包含详细的注释 - 添加使用示例
3. 等待 AI 回复，OpenClaw 会分析你的需求并生成代码
4. 继续对话，可以要求 AI 优化代码或添加测试用例

更多使用场景

场景类型	示例指令
代码生成	"帮我写一个 React 组件，实现待办事项列表"
代码审查	"帮我检查这段代码有什么问题：[粘贴代码]"
问题解答	"解释一下什么是闭包，并给出 JavaScript 示例"
文档生成	"帮我生成这个 API 的文档：[描述 API]"
工具调用	"帮我查一下北京的天气"

---

十一、总结

通过本文的步骤，你已经成功：

1. ✅ 安装了 QQ 机器人插件：让 OpenClaw 支持 QQ 渠道
2. ✅ 注册了 QQ 机器人：在开放平台创建了机器人应用
3. ✅ 配置了连接：将 OpenClaw 与 QQ 机器人对接
4. ✅ 测试了功能：在 QQ 中与 AI 对话成功

核心价值

🎯 便捷性：在 QQ 中直接使用 AI，无需切换应用
🎯 灵活性：支持私聊和群聊，适应不同场景
🎯 可扩展性：基于 OpenClaw 的强大能力，可以调用各种工具

写在最后

将 OpenClaw 接入 QQ，不仅让 AI 助手更贴近日常使用场景，也为团队协作提供了新的可能性。无论是个人使用还是团队协作，QQ + OpenClaw 的组合都能带来更好的体验。

💡 小贴士：如果你在使用过程中遇到问题，可以：

• 查看 OpenClaw 日志：openclaw logs --tail 50
• 参考 OpenClaw 官方文档
• 查看 QQ 机器人开放平台文档

---

相关资源

官方文档

• OpenClaw 官方文档
• QQ 机器人开放平台
• @sliverp/qqbot 插件

相关阅读

• 手把手教你安装 OpenClaw 并接入飞书
• 一步步带你手搓专属 IM APP，控制本地 OpenClaw

---

🌟 准备好了吗？赶紧动手试试，让你的 QQ 也能指挥 AI 助手！💪