QQ机器人接入OpenClaw完整指南：从零开始打造你的智能助手

第一步：创建QQ机器人（1分钟搞定）

1. 访问QQ开放平台专用入口
   打开浏览器，访问QQ开放平台的OpenClaw专用接入页面：
   👉 https://q.qq.com/qqbot/openclaw/index.html 

2. 扫码登录
   用你的手机QQ扫描页面上的二维码，完成开发者账号注册。

   注意：如果QQ号未实名，需要先完成实名认证（填写姓名、身份证号即可）。

3. 一键创建机器人
   登录成功后，页面会有一个显眼的 “创建机器人” 按钮，点击一次即可完成创建。
   关键信息：创建成功后，页面会直接显示三行预设的配置指令，请先不要关闭这个页面，我们马上要用。

4. 获取核心凭证
   在机器人管理页面，找到并复制以下两个关键信息（后续配置要用）：

   • AppID

   • AppSecret

   重要：AppSecret首次查看后记得保存好，后续无法再明文查看。

5. 把机器人加为好友
   创建完成后，点击页面上的 “扫码聊天” 或直接搜索你的机器人名称，把它添加到你的QQ好友列表中。

---

第二步：在OpenClaw中安装QQ插件

回到你的Ubuntu终端，执行以下命令：

bash

# 1. 安装QQ机器人插件（和钉钉插件不同，这是官方的QQ专用插件）
openclaw plugins install @sliverp/qqbot@latest

 

安装成功后，你会看到类似 Plugin "qqbot" installed 的提示。

---

第三步：配置QQ频道并绑定机器人

现在，将刚才复制的AppID和AppSecret配置到OpenClaw中：

bash

# 2. 添加QQ频道（将命令中的 AppID 和 AppSecret 替换成你自己的）
openclaw channels add --channel qqbot --token "你的AppID:你的AppSecret"

 

示例：如果你的AppID是 123456，AppSecret是 abcdef，那么命令就是：
openclaw channels add --channel qqbot --token "123456:abcdef"

---

第四步：重启服务，让配置生效

bash

# 3. 重启网关服务
openclaw gateway restart

 

看到重启成功的提示后，你的OpenClaw就已经和QQ机器人成功连接了。

---

第五步：测试一下！

1. 打开手机QQ或电脑QQ，找到你刚添加的机器人好友。

2. 发送一条消息试试，比如：“你好” 或 “自我介绍”。

3. 如果机器人回复了你，恭喜你，接入成功！🎉

---

🔧 如果没反应，快速排查

 

问题	解决方案
机器人完全不回复	检查 openclaw gateway restart 是否执行成功，以及AppID和AppSecret是否填对
提示“机器人去火星了”	需要在QQ开放平台配置IP白名单，把你的Ubuntu服务器IP加进去
模型调用失败	确认你之前配置的阿里云百炼API Key还有额度（新用户有90天免费）

---

💡 为什么QQ比钉钉顺畅？

• 完全个人化：QQ机器人面向个人开放，一个QQ号最多可以创建5个机器人

• 官方深度适配：QQ开放平台专门为OpenClaw做了优化，整个流程就是为“龙虾”设计的

• 无需审批发布：创建即用，没有钉钉那套企业审批流程

---

现在，快去试试你的QQ“小龙虾”吧！有任何问题随时问我～