OpenClaw QQ 机器人接入实战指南
不得不承认腾讯进步的速度很快,几条命令就能接入 OpenClaw,而且不再强制要求设置 IP 白名单(但在实际部署中仍需注意)。在 QQ 开放平台甚至增加了专门的 OpenClaw 入口。

没啥好说的,很简单。安装完 OpenClaw 之后,执行如下命令即可快速拉起服务:
openclaw plugins install @sliverp/[email protected]
openclaw channels add --channel qqbot --token "AppID:AppSecret"
openclaw gateway restart
⚠️ 重要提示:如果是家用宽带且没有固定 IP,建议慎重考虑。由于 QQ 开发平台的网络机制限制,动态 IP 会导致机器人频繁掉线。强烈建议使用云服务器或有固定公网 IP 的环境部署。
环境准备与注意事项
在完成 OpenClaw 基础安装后,除了飞书,我们还可以通过 QQ 机器人来控制你的 AI 助手。但在此之前,必须提醒大家:QQ 机器人对网络环境要求极高。
家用宽带用户的劝退警告
在开始之前,得坦诚地告诉你几个现实问题:
- IP 白名单机制:QQ 开放平台通常要求配置服务器 IP 到白名单中。
- 家用宽带痛点:绝大多数家庭宽带没有固定 IP,运营商每天甚至每小时都会更换地址。一旦 IP 变更,机器人就会离线,需要反复手动更新白名单。
- 实际体验:消息收发不稳定,维护成本远高于收益。
| 环境 | 推荐程度 | 说明 |
|---|---|---|
| 云服务器(阿里云/腾讯云) | ✅ 推荐 | 有固定 IP,稳定性高 |
| 企业宽带(固定 IP) | ✅ 推荐 | 稳定,但成本较高 |
| 家用宽带(动态 IP) | ❌ 不推荐 | 极不稳定,频繁掉线 |
如果你使用的是家用宽带,建议直接放弃 QQ 机器人方案,改用飞书或其他方式会更省心。
接入步骤详解
1. 访问 QQ 开放平台
打开浏览器访问 QQ 开放平台,使用你的 QQ 号登录。进入「应用管理」页面,点击「创建机器人」。填写应用名称(例如 OpenClaw-QQ),提交审核。沙箱模式下可以添加测试用户进行调试。
2. 获取凭证信息
创建成功后,在应用详情页获取关键信息:
AppIDAppSecret(ClientSecret)
💡 Token 格式通常为:
AppID:AppSecret(中间用冒号连接)。
3. 安装 QQ Bot 插件
在终端执行以下命令安装插件。这一步可能需要一点时间,小内存机器请耐心等待。
openclaw plugins install @sliverp/[email protected]


