打造你的家庭 AI 助手（三）：QQ 机器人接入你的 OpenClaw

不得不承认腾讯进步的速度太快了，几条命令就可以接入Openclaw，也不用设置IP白名单了，在 QQ开放平台还增加了专门的Openclaw入口：

没啥好说的，很简单，安装完Openclaw之后，执行如下命令（命令也是生成好的）：

openclaw plugins install @tencent-connect/openclaw-qqbot@latest openclaw channels add--channel qqbot --token"" openclaw gateway restart 

以下内容已经过时了，留作纪念
以下内容已经过时了，留作纪念
以下内容已经过时了，留作纪念

⚠️ 重要提示：如果是家用宽带，没有申请固定 IP 地址的话，大可以放弃这种方式。由于 QQ 开发平台的白名单限制，机器人会非常不稳定，频繁掉线。建议使用云服务器或有固定 IP 的环境部署。

前言

在完成 OpenClaw 安装后，除了飞书，我们还可以通过 QQ 机器人来控制你的 AI 助手。本文将介绍如何将 OpenClaw 接入 QQ 机器人平台。

但在此之前，必须提醒大家：QQ 机器人对网络环境要求极高。

⚠️ 家用宽带用户的劝退警告

在开始之前，必须坦诚地告诉你：

QQ 机器人接入的限制

IP 白名单机制：QQ 开放平台要求配置服务器 IP 到白名单中
家用宽带问题：
绝大多数家庭宽带没有固定 IP
运营商每天会更换 IP 地址（甚至每小时）
每当 IP 变更，机器人就会离线
需要反复手动更新白名单
实际体验：
机器人频繁掉线
消息收发不稳定
需要额外的动态 DNS 工具配合

建议方案

如果你使用的是家用宽带，建议直接放弃 QQ 机器人方案，改用飞书或其他方式。

第一步：准备工作

1.1 访问 QQ 开放平台

打开浏览器，访问：QQ 开放平台

使用你的 QQ 号登录。

1.2 创建机器人应用

进入「应用管理」页面
点击「创建机器人」
填写应用名称（如：OpenClaw-QQ）
提交审核（沙箱模式下可添加测试用户）

1.3 获取凭证信息

创建成功后，在应用详情页获取：
AppID
AppSecret（ClientSecret）

💡 Token 格式为：AppID:AppSecret（用冒号连接）

1.4 配置 IP 白名单（关键步骤）

在 QQ 开放平台的应用设置中，找到「服务器配置」或「白名单设置」：
添加你的服务器公网 IP
如果是云服务器，确保安全组已开放相应端口

⚠️ 如果你的 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”: {
“enabled”: true,
“appId”: “你的AppID”,
“clientSecret”: “你的AppSecret”
}
}
}

第四步：启动服务

重启网关（后台运行）

openclaw gateway restart

或前台运行查看日志

openclaw gateway --port 18789 --verbose

第五步：测试连接

在 QQ 开放平台添加你的 QQ 号为测试用户
在 QQ 中搜索你的机器人名称
将机器人加入群聊或发起私聊
在群聊中 @机器人 发送消息测试

⚠️ 群聊中需要 @机器人 才能触发回复

功能特性

常见问题

Q：机器人显示离线？
检查服务器 IP 是否已加入白名单
确认 IP 是否发生变化
检查 OpenClaw 网关是否正常运行
Q：收不到群消息？
检查是否在群内 @机器人
确认机器人已在沙箱模式中添加为测试用户
查看网关日志是否有报错
Q：IP 频繁变更怎么办？
方案一：申请云服务器（推荐）
方案二：使用动态 DNS 服务 + 脚本自动更新白名单（复杂，不推荐）
方案三：放弃 QQ，改用飞书（最省心）
Q：如何升级插件？

npm 热更新

npx -y @sliverp/[email protected] upgrade

总结

QQ 机器人接入 OpenClaw 本身并不复杂，但网络环境的限制是最大的痛点。

如果你有云服务器，配置好 IP 白名单后基本可以稳定使用。但如果你只有家用宽带，建议直接放弃这个方案——频繁的 IP 变更会让你疲于奔命，白名单永远跟不上变化。

省心的选择：
云服务器部署 → 推荐
家用宽带 + 动态 IP → 不推荐
改用飞书 → 省心稳定

系列文章：
打造你的家庭 AI 助手（一）：OpenClaw 安装与配置
打造你的家庭 AI 助手（二）：飞书机器人接入你的 OpenClaw
打造你的家庭 AI 助手（三）：QQ 机器人接入你的 OpenClaw（本文）