不得不承认，腾讯开放平台的接入效率确实提升了不少。现在通过几条命令就能把 OpenClaw 接入 QQ 机器人，甚至不需要额外配置复杂的 IP 白名单（尽管网络环境依然关键）。在 QQ 开放平台首页，也能看到专门的 OpenClaw 入口，集成度很高。
不过，在动手之前有个重要提醒：家用宽带用户请谨慎。虽然接入流程简单，但 QQ 机器人的稳定性高度依赖网络环境。
⚠️ 网络环境建议
QQ 机器人对 IP 变动非常敏感。如果你使用的是没有固定公网 IP 的家用宽带，可能会遇到频繁掉线的问题。
| 环境 | 推荐程度 | 说明 |
|---|---|---|
| 云服务器（阿里云/腾讯云） | ✅ 推荐 | 拥有固定 IP，连接稳定 |
| 企业宽带（固定 IP） | ✅ 推荐 | 稳定，但成本较高 |
| 家用宽带（动态 IP） | ❌ 不推荐 | IP 变更会导致离线，需手动更新白名单 |
如果只有家用宽带，建议优先考虑飞书或其他方案，避免后续维护精力消耗。
第一步：准备工作
1.1 访问 QQ 开放平台
打开浏览器进入 QQ 开放平台，使用你的 QQ 号登录。
1.2 创建机器人应用
在「应用管理」页面点击「创建机器人」，填写应用名称（例如：OpenClaw-QQ）。提交审核，沙箱模式下可直接添加测试用户。
1.3 获取凭证信息
创建成功后，在详情页记录以下信息：
- AppID
- AppSecret（ClientSecret）
Token 格式通常为 AppID:AppSecret（冒号连接）。
1.4 配置 IP 白名单
在应用设置的「服务器配置」中，添加你的服务器公网 IP。如果是云服务器，请确保安全组已开放相应端口。
注意：如果 IP 发生变化，必须及时在此处更新白名单，否则机器人将离线。
第二步：安装 QQ Bot 插件
在终端执行以下命令安装插件：
openclaw plugins install @sliverp/[email protected]
等待 1-2 分钟，插件会自动下载安装。小内存机器可能需要稍长一点时间。
第三步：配置 QQ 机器人
这里提供三种配置方式，任选其一即可。
方式一：交互式配置
运行命令后按提示输入 Token：
openclaw channels add
# 选择 qqbot，按提示输入 Token
方式二：命令行直接配置
openclaw channels add --channel qqbot --token "AppID:AppSecret"
