QQ 机器人接入 OpenClaw 配置指南
腾讯开放平台提供了便捷的 OpenClaw 接入入口，通过几条命令即可完成集成。
⚠️ 网络环境警告
重要提示：家用宽带若无固定 IP，不建议使用此方案。QQ 开发平台的白名单限制会导致机器人频繁掉线。建议使用云服务器或有固定 IP 的环境部署。
环境推荐
| 环境 | 推荐程度 | 说明 |
|---|---|---|
| 云服务器（阿里云/腾讯云） | ✅ 推荐 | 有固定 IP，稳定 |
| 企业宽带（固定 IP） | ✅ 推荐 | 稳定，但成本高 |
| 家用宽带（动态 IP） | ❌ 不推荐 | 不稳定，频繁掉线 |
第一步：准备工作
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
