OpenClaw 接入 QQ 机器人配置指南
腾讯开放平台提供了便捷的接入方式，几条命令即可接入 OpenClaw，无需设置 IP 白名单（注：部分环境仍需配置）。在 QQ 开放平台增加了专门的 OpenClaw 入口。
安装完 OpenClaw 之后，执行如下命令：
openclaw plugins install @sliverp/[email protected]
openclaw channels add --channel qqbot --token "AppID:AppSecret"
openclaw gateway restart
⚠️ 重要提示：如果是家用宽带且没有申请固定 IP 地址，建议放弃这种方式。由于 QQ 开发平台的白名单限制，机器人会非常不稳定，频繁掉线。建议使用云服务器或有固定 IP 的环境部署。
前言
在完成 OpenClaw 安装后，除了飞书，我们还可以通过 QQ 机器人来控制你的 AI 助手。本文将介绍如何将 OpenClaw 接入 QQ 机器人平台。
但在此之前，必须提醒大家：QQ 机器人对网络环境要求极高。
⚠️ 家用宽带用户的劝退警告
QQ 机器人接入的限制
- IP 白名单机制：QQ 开放平台要求配置服务器 IP 到白名单中
- 家用宽带问题：
- 绝大多数家庭宽带没有固定 IP
- 运营商每天会更换 IP 地址（甚至每小时）
- 每当 IP 变更，机器人就会离线
- 需要反复手动更新白名单
- 实际体验：
- 机器人频繁掉线
- 消息收发不稳定
- 需要额外的动态 DNS 工具配合
建议方案
| 环境 | 推荐程度 | 说明 |
|---|---|---|
| 云服务器（阿里云/腾讯云） | ✅ 推荐 | 有固定 IP，稳定 |
| 企业宽带（固定 IP） | ✅ 推荐 | 稳定，但成本高 |
| 家用宽带（动态 IP） | ❌ 不推荐 | 不稳定，频繁掉线 |
如果你使用的是家用宽带，建议直接放弃 QQ 机器人方案，改用飞书或其他方式。
第一步：准备工作
1.1 访问 QQ 开放平台
打开浏览器，访问 QQ 开放平台，使用你的 QQ 号登录。
1.2 创建机器人应用
进入「应用管理」页面，点击「创建机器人」，填写应用名称（如：OpenClaw-QQ），提交审核（沙箱模式下可添加测试用户）。
1.3 获取凭证信息
创建成功后，在应用详情页获取：
- AppID
- AppSecret（ClientSecret）
💡 Token 格式为：
AppID:AppSecret（用冒号连接）
1.4 配置 IP 白名单（关键步骤）
在 QQ 开放平台的应用设置中，找到「服务器配置」或「白名单设置」：
- 添加你的服务器公网 IP
- 如果是云服务器，确保安全组已开放相应端口
⚠️ 如果你的 IP 会变化，每次变更后都需要来这里更新白名单。
第二步：安装 QQ Bot 插件
在终端执行以下命令：
openclaw plugins install @sliverp/[email protected]
等待 1-2 分钟，插件会自动下载安装。
⚠️ 安装过程需要一些时间，小内存机器请耐心等待
第三步：配置 QQ 机器人
方式一：交互式配置
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
第五步：测试连接
- 在 QQ 开放平台添加你的 QQ 号为测试用户
- 在 QQ 中搜索你的机器人名称
- 将机器人加入群聊或发起私聊
- 在群聊中 @机器人 发送消息测试
⚠️ 群聊中需要 @机器人 才能触发回复
功能特性
| 功能 | 支持情况 |
|---|---|
| C2C 私聊 | ✅ 支持 |
| 群聊 @消息 | ✅ 支持 |
| 频道消息 | ✅ 支持 |
| 图片收发 | ✅ 支持 |
| 文件发送 | ✅ 支持 |
| Markdown 格式 | ✅ 支持 |
| 定时推送 | ✅ 支持 |
| 输入状态提示 | ✅ 支持 |
常见问题
Q：机器人显示离线？
- 检查服务器 IP 是否已加入白名单
- 确认 IP 是否发生变化
- 检查 OpenClaw 网关是否正常运行
Q：收不到群消息？
- 检查是否在群内 @机器人
- 确认机器人已在沙箱模式中添加为测试用户
- 查看网关日志是否有报错
Q：IP 频繁变更怎么办？
- 方案一：申请云服务器（推荐）
- 方案二：使用动态 DNS 服务 + 脚本自动更新白名单（复杂，不推荐）
- 方案三：放弃 QQ，改用飞书（最省心）
Q：如何升级插件？
npx -y @sliverp/[email protected] upgrade
总结
QQ 机器人接入 OpenClaw 本身并不复杂，但网络环境的限制是最大的痛点。
如果你有云服务器，配置好 IP 白名单后基本可以稳定使用。但如果你只有家用宽带，建议直接放弃这个方案——频繁的 IP 变更会让你疲于奔命，白名单永远跟不上变化。
- 云服务器部署 → 推荐
- 家用宽带 + 动态 IP → 不推荐
- 改用飞书 → 省心稳定
