腾讯开放平台提供了便捷的接口,通过几条命令即可接入 OpenClaw。本文介绍如何将 OpenClaw 接入 QQ 机器人平台。

⚠️ 家用宽带用户的劝退警告
QQ 机器人对网络环境要求极高。由于 QQ 开发平台的白名单限制,家用宽带用户(无固定 IP)会面临频繁掉线问题。
| 环境 | 推荐程度 | 说明 |
|---|---|---|
| 云服务器(阿里云/腾讯云) | ✅ 推荐 | 有固定 IP,稳定 |
| 企业宽带(固定 IP) | ✅ 推荐 | 稳定,但成本高 |
| 家用宽带(动态 IP) | ❌ 不推荐 | 不稳定,频繁掉线 |
如果你使用的是家用宽带,建议直接放弃 QQ 机器人方案,改用飞书或其他方式。
第一步:准备工作
1.1 访问 QQ 开放平台
打开浏览器,访问 QQ 开放平台并使用 QQ 号登录。
1.2 创建机器人应用
进入「应用管理」页面,点击「创建机器人」,填写应用名称(如:OpenClaw-QQ),提交审核。
1.3 获取凭证信息
创建成功后,在应用详情页获取 AppID 和 AppSecret(ClientSecret)。
💡 Token 格式为:
AppID:AppSecret(用冒号连接)
1.4 配置 IP 白名单
在 QQ 开放平台的应用设置中,找到「服务器配置」或「白名单设置」,添加你的服务器公网 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": {
"qqbot"


