前置准备
本地已安装 OpenClaw Windows 版本，程序可正常启动运行
附一键装机包如下图
OpenClaw 顶部 Gateway 服务状态保持在线，确保基础服务正常
准备可正常登录的 QQ 账号，用于登录 QQ 开放平台后台
手机端安装 QQ 客户端，用于扫码授权及后续机器人消息测试
图文配置步骤
步骤 1：打开 QQ 机器人授权页面并扫码登录
访问 QQ 机器人专属登录地址：
https://q.qq.com/qqbot/openclaw/login.html
进入网页后，使用手机 QQ 扫描页面二维码，完成账号登录授权。
步骤 2：勾选协议并确认授权登录
扫码完成后，页面右下角会出现授权确认区域。
先勾选我已阅读并同意《QQ 开放平台服务协议》，再点击同意，完成平台登录流程。
步骤 3：进入后台创建全新机器人
登录成功自动跳转至 QQ 开放平台机器人管理中心。
在「我的机器人」板块右侧，点击创建机器人，开始新建专属机器人应用。
步骤 4：复制保存 AppID 与 AppSecret
机器人创建完成后，页面会展示两组核心对接参数：
AppID
AppSecret
及时完整复制并妥善留存，这两组参数是 OpenClaw 与 QQ 机器人对接的关键。
温馨提示：AppSecret 属于应用敏感密钥，平台不会长期明文展示，建议创建完成立刻复制备份，切勿随意外泄。
步骤 5：进入 OpenClaw 配置页 安装 QQ 机器人插件
切回 OpenClaw 主界面，点击右上角设置，进入左侧聊天配置板块，找到 QQ 机器人配置卡片。
若卡片显示安装插件按钮，说明当前环境未内置 QQ 渠道依赖，直接点击安装，等待插件自动部署完成后再进行参数配置。
步骤 6：填写密钥参数并保存渠道配置
将之前从 QQ 开放平台复制的参数依次对应填写：
App ID：粘贴平台给出的 AppID
App Secret：粘贴平台给出的 AppSecret
确认配置项右侧启用开关为开启状态，点击右上角保存渠道配置，完成参数绑定。
步骤 7：发送消息测试接入是否成功
配置保存生效后，打开手机 QQ，找到刚创建的机器人账号，发送一条测试消息，例如：你好。
若机器人可以正常自动回复内容，代表 QQ 机器人已成功接入 OpenClaw，整条配置流程完成。
接入完成自检清单
已正常登录 QQ 开放平台后台
成功创建专属 QQ 机器人应用
完整复制并妥善保管 AppID、AppSecret
OpenClaw 端 QQ 机器人插件已安装完毕
密钥参数无多余空格、字符填写无误
QQ 机器人渠道启用开关已打开
已手动保存渠道配置信息
发送测试消息可正常收到机器人回复
常见问题解答
- OpenClaw 为什么显示需要安装插件？
OpenClaw 默认不会内置全部第三方聊天渠道能力，QQ 机器人属于扩展渠道，需要单独安装对应插件才能启用配置，按页面指引一键安装即可。 - AppID 和 AppSecret 分别对应填什么？
QQ 开放平台创建机器人生成的两组参数，直接一一对应：
平台 AppID → 填写到 OpenClaw 的 App ID
平台 AppSecret → 填写到 OpenClaw 的 App Secret - 为什么平台提示尽快保存 AppSecret？
AppSecret 是机器人通信核心密钥，为保障安全，平台不会长期明文展示，建议创建完成第一时间复制填写或备份留存。 - 配置保存后机器人无回复怎么处理？
按顺序逐项排查：
检查 OpenClaw 顶部 Gateway 是否为在线状态
确认 QQ 机器人插件已完整安装
核对 AppID、AppSecret 有无填错、带多余空格
确认已点击保存渠道配置
确认聊天对象为当前绑定的新建机器人
仍异常可重启 OpenClaw 或重启 Gateway 服务后重新测试。
参考官方地址
QQ 机器人登录入口：https://q.qq.com/qqbot/openclaw/login.html
附openclaw一键装机包如图下载
