打造你的家庭 AI 助手（三）：QQ 机器人接入你的 OpenClaw-开发者社区

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

前言

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

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

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

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

QQ 机器人接入的限制

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

建议方案

环境	推荐程度	说明
云服务器（阿里云/腾讯云）	✅ 推荐	有固定 IP，稳定
企业宽带（固定 IP）	✅ 推荐	稳定，但成本高
家用宽带（动态 IP）	❌ 不推荐	不稳定，频繁掉线

如果你使用的是家用宽带，建议直接放弃 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/qqbot@1.3.7

等待 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 中搜索你的机器人名称
将机器人加入群聊或发起私聊
在群聊中 @机器人发送消息测试

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

功能特性

功能	支持情况
C2C 私聊	✅ 支持
群聊 @消息	✅ 支持
频道消息	✅ 支持
图片收发	✅ 支持
文件发送	✅ 支持
Markdown 格式	✅ 支持
定时推送	✅ 支持
输入状态提示	✅ 支持

常见问题

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