家庭 AI 助手实战：QQ 机器人接入 OpenClaw

不得不承认，腾讯开放平台的接入效率确实提升了不少。现在通过几条命令就能把 OpenClaw 接入 QQ 机器人，甚至不需要额外配置复杂的 IP 白名单（尽管网络环境依然关键）。在 QQ 开放平台首页，也能看到专门的 OpenClaw 入口，集成度很高。

不过，在动手之前有个重要提醒：家用宽带用户请谨慎。虽然接入流程简单，但 QQ 机器人的稳定性高度依赖网络环境。

⚠️ 网络环境建议

QQ 机器人对 IP 变动非常敏感。如果你使用的是没有固定公网 IP 的家用宽带，可能会遇到频繁掉线的问题。

环境	推荐程度	说明
云服务器（阿里云/腾讯云）	✅ 推荐	拥有固定 IP，连接稳定
企业宽带（固定 IP）	✅ 推荐	稳定，但成本较高
家用宽带（动态 IP）	❌ 不推荐	IP 变更会导致离线，需手动更新白名单

如果只有家用宽带，建议优先考虑飞书或其他方案，避免后续维护精力消耗。

第一步：准备工作

1.1 访问 QQ 开放平台

打开浏览器进入 QQ 开放平台，使用你的 QQ 号登录。

1.2 创建机器人应用

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

1.3 获取凭证信息

创建成功后，在详情页记录以下信息：

• AppID
• AppSecret（ClientSecret）

Token 格式通常为 AppID:AppSecret（冒号连接）。

1.4 配置 IP 白名单

在应用设置的「服务器配置」中，添加你的服务器公网 IP。如果是云服务器，请确保安全组已开放相应端口。

注意：如果 IP 发生变化，必须及时在此处更新白名单，否则机器人将离线。

第二步：安装 QQ Bot 插件

在终端执行以下命令安装插件：

openclaw plugins install @sliverp/[email protected]

等待 1-2 分钟，插件会自动下载安装。小内存机器可能需要稍长一点时间。

第三步：配置 QQ 机器人

这里提供三种配置方式，任选其一即可。

方式一：交互式配置

运行命令后按提示输入 Token：

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

第五步：测试连接

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

注意：群聊中通常需要 @机器人 才能触发回复。

功能特性

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

常见问题

Q：机器人显示离线？ 检查服务器 IP 是否已加入白名单，确认 IP 是否发生变化，以及 OpenClaw 网关是否正常运行。

Q：收不到群消息？ 检查是否在群内 @机器人，确认机器人已在沙箱模式中添加为测试用户，查看网关日志是否有报错。

Q：IP 频繁变更怎么办？ 方案一：申请云服务器（推荐）。 方案二：使用动态 DNS 服务 + 脚本自动更新白名单（复杂，不推荐）。 方案三：放弃 QQ，改用飞书（最省心）。

Q：如何升级插件？

npx -y @sliverp/[email protected] upgrade

总结

QQ 机器人接入 OpenClaw 本身并不复杂，核心难点在于网络环境的稳定性。如果你有云服务器，配置好 IP 白名单后基本可以稳定使用。但如果你只有家用宽带，频繁的 IP 变更会让你疲于奔命，建议直接放弃这个方案，改用飞书或其他更稳定的渠道。

省心的选择：

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