腾讯开放平台这套接入流程算不上复杂,真正麻烦的是网络环境。QQ 机器人对公网 IP 和白名单的依赖很强,家用宽带一旦碰上动态 IP,掉线和反复改配置几乎是常态,所以如果你手里没有固定公网 IP,我会先把 QQ 这条路放后面。

家用宽带先别急着上
QQ 开放平台对机器人接入环境要求比较高。白名单、固定 IP、网关稳定性,这几个条件少一个都容易出问题。
| 环境 | 推荐程度 | 说明 |
|---|---|---|
| 云服务器(阿里云/腾讯云) | ✅ 推荐 | 有固定 IP,稳定 |
| 企业宽带(固定 IP) | ✅ 推荐 | 稳定,但成本高 |
| 家用宽带(动态 IP) | ❌ 不推荐 | 不稳定,频繁掉线 |
如果你现在就是家用宽带,直接改用飞书或别的渠道,通常比硬扛 QQ 机器人省时间。
准备工作
先去 QQ 开放平台登录账号,创建机器人应用。应用名可以随便起,比如 OpenClaw-QQ。
创建完成后,记下 AppID 和 AppSecret(平台里也可能叫 ClientSecret)。后面配置时用到的 Token 格式是 AppID:AppSecret,中间用冒号连起来。
接着把服务器公网 IP 加进白名单。云服务器一般没什么悬念,别忘了顺手检查安全组端口是否放行。
安装 QQ Bot 插件
openclaw plugins install @sliverp/[email protected]
安装过程通常要等一两分钟,插件会自动拉下来。
配置机器人
我更倾向于先用交互式配置,出错少一点:
openclaw channels add
按提示选 qqbot,再输入 Token 就行。
如果你习惯一次性写完,也可以直接走命令行:
openclaw channels add --channel qqbot --token "AppID:AppSecret"
手动改配置文件也可以,位置在 ~/.openclaw/openclaw.json:
{
"channels": {
"qqbot": {
"enabled": true


