OpenClaw 接入 QQ 机器人配置指南。主要步骤包括安装 QQ Bot 插件、获取应用凭证、配置 IP 白名单及启动网关服务。重点提示家用宽带因动态 IP 导致连接不稳定，推荐使用云服务器部署以确保稳定性。支持私聊、群聊@、图片文件收发等功能。
腾讯开放平台已提供 OpenClaw 接入入口，通过几条命令即可完成配置。安装完 OpenClaw 后，执行以下命令：
openclaw plugins install @sliverp/[email protected]
openclaw channels add --channel qqbot --token
openclaw gateway restart
⚠️ 重要提示：如果是家用宽带，没有申请固定 IP 地址的话，大可以放弃这种方式。由于 QQ 开发平台的白名单限制，机器人会非常不稳定，频繁掉线。建议使用云服务器或有固定 IP 的环境部署。
在完成 OpenClaw 安装后，除了飞书，我们还可以通过 QQ 机器人来控制你的 AI 助手。本文将介绍如何将 OpenClaw 接入 QQ 机器人平台。
但在此之前，必须提醒大家：QQ 机器人对网络环境要求极高。
在开始之前，必须坦诚地告诉你：
| 环境 | 推荐程度 | 说明 |
|---|---|---|
| 云服务器（阿里云/腾讯云） | ✅ 推荐 | 有固定 IP，稳定 |
| 企业宽带（固定 IP） | ✅ 推荐 | 稳定，但成本高 |
| 家用宽带（动态 IP） | ❌ 不推荐 | 不稳定，频繁掉线 |
如果你使用的是家用宽带，建议直接放弃 QQ 机器人方案，改用飞书或其他方式。
打开浏览器，访问 QQ 开放平台。 使用你的 QQ 号登录。
进入「应用管理」页面 点击「创建机器人」 填写应用名称（如：OpenClaw-QQ） 提交审核（沙箱模式下可添加测试用户）
创建成功后，在应用详情页获取：
💡 Token 格式为：
AppID:AppSecret（用冒号连接）
在 QQ 开放平台的应用设置中，找到「服务器配置」或「白名单设置」：
⚠️ 如果你的 IP 会变化，每次变更后都需要来这里更新白名单。
在终端执行以下命令：
openclaw plugins install @sliverp/[email protected]
等待 1-2 分钟，插件会自动下载安装。
⚠️ 安装过程需要一些时间，小内存机器请耐心等待
openclaw channels add
选择 qqbot，按提示输入 Token。
openclaw channels add --channel qqbot --token "AppID:AppSecret"
编辑 ~/.openclaw/openclaw.json：
{
"channels": {
"qqbot": {
"enabled": true,
"appId": "你的 AppID",
"clientSecret": "你的 AppSecret"
}
}
}
openclaw gateway restart
openclaw gateway --port 18789 --verbose
⚠️ 群聊中需要 @机器人 才能触发回复
| 功能 | 支持情况 |
|---|---|
| C2C 私聊 | ✅ 支持 |
| 群聊 @消息 | ✅ 支持 |
| 频道消息 | ✅ 支持 |
| 图片收发 | ✅ 支持 |
| 文件发送 | ✅ 支持 |
| Markdown 格式 | ✅ 支持 |
| 定时推送 | ✅ 支持 |
| 输入状态提示 | ✅ 支持 |
Q：机器人显示离线？
Q：收不到群消息？
Q：IP 频繁变更怎么办？
QQ 机器人接入 OpenClaw 本身并不复杂，但网络环境的限制是最大的痛点。
如果你有云服务器，配置好 IP 白名单后基本可以稳定使用。但如果你只有家用宽带，建议直接放弃这个方案——频繁的 IP 变更会让你疲于奔命，白名单永远跟不上变化。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online
基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML转Markdown在线工具，online