家庭 AI 助手实战:QQ 机器人接入 OpenClaw
OpenClaw 的生态扩展性很强,除了飞书,接入 QQ 机器人也是控制你的家庭 AI 助手的不错选择。不过在此之前,得先聊聊网络环境——这往往是决定成败的关键。
⚠️ 网络环境预警
QQ 开放平台对 IP 白名单有严格要求。如果你使用的是家用宽带,大概率没有固定公网 IP,运营商可能会频繁更换地址(甚至每小时变动)。一旦 IP 变更,白名单失效,机器人就会离线,你需要反复手动更新配置,体验极差。
建议方案:
| 环境 | 推荐程度 | 说明 |
|---|---|---|
| 云服务器(阿里云/腾讯云) | ✅ 推荐 | 拥有固定 IP,连接稳定 |
| 企业宽带(固定 IP) | ✅ 推荐 | 稳定,但成本较高 |
| 家用宽带(动态 IP) | ❌ 不推荐 | 不稳定,频繁掉线 |
如果你只有家用宽带且无法申请固定 IP,建议直接放弃 QQ 方案,改用飞书或其他渠道。
第一步:准备工作
1. 访问 QQ 开放平台
打开浏览器进入 QQ 开放平台,使用你的 QQ 号登录。在首页通常能找到 OpenClaw 相关的入口或直接在应用管理里操作。

2. 创建机器人应用
进入「应用管理」页面,点击「创建机器人」。填写应用名称(例如 OpenClaw-QQ),提交审核。沙箱模式下你可以添加自己的 QQ 号为测试用户。
3. 获取凭证信息
创建成功后,在应用详情页找到关键信息:
- AppID
- AppSecret (ClientSecret)
Token 格式通常为 AppID:AppSecret(中间用冒号连接)。
4. 配置 IP 白名单
这是最关键的一步。在 QQ 开放平台的应用设置中,找到「服务器配置」或「白名单设置」,填入你的服务器公网 IP。如果是云服务器,请确保安全组已开放相应端口。
注意:如果 IP 发生变化,必须立刻来这里更新白名单,否则服务会中断。
第二步:安装插件
在终端执行以下命令安装 QQ Bot 插件。这里我们使用社区维护的版本:
openclaw plugins install @sliverp/[email protected]
等待 1-2 分钟,插件会自动下载安装。小内存机器可能需要多一点耐心。
第三步:配置通道
有三种方式可以配置通道,任选其一即可。
方式一:交互式配置
运行配置命令,按提示输入 Token:
openclaw channels add
# 选择 qqbot,然后粘贴 AppID:AppSecret


