QQ 开放平台提供了专门的 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 "AppID:AppSecret"
方式三:手动编辑
编辑 ~/.openclaw/openclaw.json:
{
"channels"


