腾讯开放平台提供了便捷的 OpenClaw 接入入口,无需设置复杂的 IP 白名单即可快速集成。
OpenClaw 接入 QQ 机器人配置教程
OpenClaw 支持通过 QQ 机器人控制 AI 助手。本文介绍接入步骤,包括创建应用获取凭证、安装插件、配置 Token 及重启网关。重点提示家用宽带因动态 IP 导致连接不稳定,建议使用云服务器或固定 IP 环境部署,否则推荐改用飞书方案。

OpenClaw 支持通过 QQ 机器人控制 AI 助手。本文介绍接入步骤,包括创建应用获取凭证、安装插件、配置 Token 及重启网关。重点提示家用宽带因动态 IP 导致连接不稳定,建议使用云服务器或固定 IP 环境部署,否则推荐改用飞书方案。

腾讯开放平台提供了便捷的 OpenClaw 接入入口,无需设置复杂的 IP 白名单即可快速集成。
如果是家用宽带且没有申请固定 IP 地址,建议放弃这种方式。由于 QQ 开发平台的白名单限制,机器人会非常不稳定,频繁掉线。建议使用云服务器或有固定 IP 的环境部署。
| 环境 | 推荐程度 | 说明 |
|---|---|---|
| 云服务器(阿里云/腾讯云) | ✅ 推荐 | 有固定 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 频繁变更怎么办?
Q:如何升级插件?
npx -y @sliverp/[email protected] upgrade
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