前言
腾讯的开放能力迭代很快,几条命令就能让 OpenClaw 接入 QQ 机器人,省去了繁琐的 IP 白名单配置。在 QQ 开放平台 也能找到专门的入口。

安装完 OpenClaw 后,执行以下命令即可快速集成:
openclaw plugins install @sliverp/[email protected]
openclaw channels add --channel qqbot --token "AppID:AppSecret"
openclaw gateway restart
⚠️ 重要提示:家用宽带用户请慎重。QQ 开发平台的白名单机制对网络环境要求极高。如果没有固定 IP,机器人会频繁掉线,维护成本远高于收益。建议优先使用云服务器或企业固定 IP 环境。
准备工作
1. 获取应用凭证
访问 QQ 开放平台并登录,进入「应用管理」创建机器人应用。填写名称如 OpenClaw-QQ,提交审核(沙箱模式可添加测试用户)。成功后在详情页获取 AppID 和 AppSecret。Token 格式为 AppID:AppSecret。
2. 网络环境确认
确保服务器公网 IP 已记录。如果是云服务器,检查安全组是否开放了相应端口。若使用动态 IP,每次变更后需手动更新白名单,体验较差。
| 环境 | 推荐程度 | 说明 |
|---|---|---|
| 云服务器(阿里云/腾讯云) | ✅ 推荐 | 有固定 IP,稳定 |
| 企业宽带(固定 IP) | ✅ 推荐 | 稳定,但成本高 |
| 家用宽带(动态 IP) | ❌ 不推荐 | 不稳定,频繁掉线 |
安装与配置
安装插件
在终端执行安装命令,等待插件自动下载完成。小内存机器可能需要稍等片刻。
openclaw plugins install @sliverp/[email protected]
配置通道
支持交互式、命令行或手动编辑三种方式。推荐直接使用命令行,效率更高:
openclaw channels add --channel qqbot --token "AppID:AppSecret"
或者手动编辑 ~/.openclaw/openclaw.json:
{
"channels": {
"qqbot": {


