OpenClaw 接入 QQ 机器人实战指南
不得不承认腾讯的开放能力进步很快，几条命令就能把 OpenClaw 接入 QQ 机器人。在 QQ 开放平台甚至专门增加了 OpenClaw 入口，配置起来比以前方便不少。
不过，在动手之前，我得先泼盆冷水：网络环境是这里最大的坑。
⚠️ 关于网络环境的真心话
如果你打算用家用宽带部署，建议直接放弃这个方案。QQ 开发平台对 IP 白名单有严格要求，而绝大多数家庭宽带没有固定 IP，运营商甚至会每小时更换一次地址。一旦 IP 变动，机器人就会离线，你需要反复去后台更新白名单，体验极差。
推荐方案对比：
| 环境 | 推荐程度 | 说明 |
|---|---|---|
| 云服务器（阿里云/腾讯云） | ✅ 强烈推荐 | 拥有固定公网 IP，稳定性高 |
| 企业宽带（固定 IP） | ✅ 推荐 | 稳定，但成本较高 |
| 家用宽带（动态 IP） | ❌ 不推荐 | 频繁掉线，维护成本高 |
如果你只有家用宽带，建议改用飞书或其他支持内网穿透的方案。
准备工作
1. 创建应用
访问 QQ 开放平台，使用你的 QQ 号登录。进入「应用管理」页面，点击「创建机器人」。填写应用名称（例如 OpenClaw-QQ），提交审核。沙箱模式下可以添加测试用户进行调试。
2. 获取凭证
应用创建成功后，在详情页找到以下信息：
- AppID
- AppSecret (ClientSecret)
Token 格式通常为 AppID:AppSecret（中间用冒号连接）。
3. 配置白名单
在 QQ 开放平台的应用设置中，找到「服务器配置」或「白名单设置」，填入你的服务器公网 IP。如果是云服务器，请确保安全组已开放相应端口。这一步至关重要，IP 一变就得重来。
安装与配置
安装插件
在终端执行以下命令安装 QQ Bot 插件：
openclaw plugins install @sliverp/[email protected]
等待 1-2 分钟，插件会自动下载安装。小内存机器可能需要多等一会儿。
配置通道
这里有三种方式配置 Token，任选其一即可：
方式一：交互式配置 运行命令后按提示输入：
openclaw channels add
选择 qqbot，然后粘贴你的 Token。
方式二：命令行直接指定
openclaw channels add --channel qqbot --token
