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

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（本文）