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

方式二：命令行参数

直接带上 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. 发送消息测试。

群聊模式下通常需要 @机器人 才能触发回复。

功能支持情况

常见问题排查

Q：机器人显示离线？

• 检查服务器 IP 是否已加入白名单。
• 确认 IP 是否发生变化。
• 检查 OpenClaw 网关进程是否正常运行。

Q：收不到群消息？

• 确认是否在群内 @机器人。
• 确认机器人已在沙箱模式中添加为测试用户。
• 查看网关日志是否有报错信息。

Q：IP 频繁变更怎么办？

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

Q：如何升级插件？

可以通过 npm 进行热更新：

npx -y @sliverp/[email protected] upgrade

总结

QQ 机器人接入 OpenClaw 本身并不复杂，核心难点在于网络环境的稳定性。如果你有云服务器，配置好 IP 白名单后基本可以稳定使用。但如果只有家用宽带，频繁的 IP 变更会让你疲于奔命，白名单永远跟不上变化。

部署建议：

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