不得不承认腾讯的进步速度很快,几条命令就能完成 OpenClaw 的接入,甚至不再强制要求设置 IP 白名单。在 QQ 开放平台 也专门增加了 OpenClaw 入口,操作路径非常清晰。

安装完 OpenClaw 后,直接执行系统生成的命令即可快速集成:
openclaw plugins install @tencent-connect/openclaw-qqbot@latest
openclaw channels add --channel qqbot --token "AppID:AppSecret"
openclaw gateway restart
⚠️ 网络环境的关键提示
虽然接入流程简化了,但 QQ 机器人对网络环境的稳定性要求依然很高。如果你使用的是家用宽带且没有固定 IP,建议慎重考虑。
QQ 开放平台的机制决定了服务器 IP 必须稳定。绝大多数家庭宽带的 IP 是动态的,运营商可能会每天甚至每小时更换地址。一旦 IP 变更,机器人就会离线,需要反复手动更新白名单,实际体验中消息收发极不稳定。
| 环境 | 推荐程度 | 说明 |
|---|---|---|
| 云服务器(阿里云/腾讯云) | ✅ 推荐 | 拥有固定公网 IP,连接稳定 |
| 企业宽带(固定 IP) | ✅ 推荐 | 稳定可靠,但成本较高 |
| 家用宽带(动态 IP) | ❌ 不推荐 | IP 频繁变动,维护成本高 |
如果只有家用宽带,建议优先考虑飞书或其他对网络依赖较低的方案。
配置步骤详解
1. 获取凭证信息
访问 QQ 开放平台并登录,进入「应用管理」创建机器人应用。提交审核通过后,在详情页获取 AppID 和 AppSecret。
Token 格式为 AppID:AppSecret,中间用冒号连接。注意不要遗漏冒号,否则会导致鉴权失败。
2. 安装与配置插件
在终端执行以下命令安装官方插件:
openclaw plugins install @tencent-connect/openclaw-qqbot@latest
等待 1-2 分钟,小内存机器可能需要稍长时间。安装完成后,通过命令行添加通道:
openclaw channels add --channel qqbot --token "你的 AppID:你的 AppSecret"
或者编辑配置文件 ~/.openclaw/openclaw.json 进行手动配置:
{
"channels": {
"qqbot": {

