OpenClaw v2.7.9 对接 QQ 机器人完整图文实操教程

前期必备条件

1. 本地设备已完成 OpenClaw v2.7.9 部署，程序可正常启动运行
2. Windows 整合包下载地址：https://xiake.yun/api/download/package/18?promoCode=IV4E9B04A80C
3. 苹果系统整合包下载地址：https://openclaw.ikidi.top/api/download/package/35?promoCode=IV4E9B04A80C
4. OpenClaw 界面顶部 Gateway 服务处于在线状态，避免配置失效
5. 准备可正常登录的 QQ 账号，用于 QQ 开放平台扫码授权
6. 手机端安装 QQ 客户端，用于扫码登录、后续机器人消息测试

完整图文操作流程

步骤 1：进入机器人登录页面，完成扫码验证

打开 QQ 机器人专属登录页面： https://q.qq.com/qqbot/openclaw/login.html 页面加载完成后，使用手机 QQ 扫描页面展示的二维码，完成账号登录校验。

步骤 2：勾选平台协议，确认授权登录

扫码识别成功后，页面右下角会弹出授权确认弹窗。 先勾选「我已阅读并同意《QQ 开放平台服务协议》」，再点击同意按钮，进入机器人管理后台。

步骤 3：后台创建全新机器人实例

登录成功跳转至机器人管理主页，在「我的机器人」分区找到创建按钮，点击创建机器人，自定义机器人头像与名称。

步骤 4：复制留存平台密钥参数

机器人创建完毕后页面会展示两组核心凭证：AppID、AppSecret。 将两组参数完整复制妥善保存，后续需要填入 OpenClaw 渠道配置栏。 注意 AppSecret 属于隐私凭证，平台不会长期明文展示，创建完成后尽快备份。

步骤 5：返回 OpenClaw，安装 QQ 渠道配套插件

切换回 OpenClaw v2.7.9 主程序，点击页面右上角设置按钮，在左侧菜单栏找到聊天配置板块，定位 QQ 机器人功能卡片。 若卡片显示安装插件按钮，代表本地未部署对应渠道组件，点击按钮完成插件自动安装，等待安装进度结束再进行参数填写。

步骤 6：录入密钥参数并保存渠道配置

将之前从 QQ 开放平台复制的两组凭证，分别填入对应输入框： App ID 栏粘贴平台生成的 AppID App Secret 栏粘贴平台生成的 AppSecret 确认渠道启用开关处于开启状态，点击页面右上角保存按钮，留存当前配置。

步骤 7：发送测试消息，验证联动效果

配置保存完成后，打开手机 QQ，找到刚刚创建完成的机器人账号，发送任意测试文字，例如 “你好”。 若配置流程无错误，机器人会自动推送对应回复内容，代表 QQ 机器人与 OpenClaw 联动搭建完成。

接入完成自检清单

完成全部配置后，可对照以下条目逐项核对，规避隐性故障：

1. 已使用有效 QQ 账号登录 QQ 开放平台后台
2. 成功创建专属机器人实例，自定义基础信息
3. 完整复制并妥善保管 AppID、AppSecret 两组凭证
4. OpenClaw 内部 QQ 机器人配套插件安装完毕
5. 两组密钥参数无多余空格、字符缺失，填写无误
6. QQ 机器人渠道启用开关保持开启状态
7. 点击保存渠道配置，参数成功写入程序
8. 向机器人发送测试消息，正常收到智能回复

高频故障排查方案

1. QQ 渠道卡片存在安装插件按钮是什么原因？

OpenClaw 整合包不会预装全部第三方对话渠道组件，QQ 机器人需要单独安装配套插件，点击按钮等待自动下载部署即可。

2. AppID 与 AppSecret 需要填写哪些内容？

两组参数均来自 QQ 开放平台创建机器人后的展示页面，AppID 对应程序内 App ID 输入框，AppSecret 对应程序内 App Secret 输入框，两组参数一一对应填写。

3. 平台提示尽快保存 AppSecret 的原因？

AppSecret 属于高敏感访问凭证，平台出于安全设计不会长期明文展示，创建机器人后立刻复制备份，避免刷新页面后无法查看。

4. 参数保存完成后，机器人无法回复消息如何处理？

按照顺序逐项排查：

1. 查看 OpenClaw 顶部 Gateway 服务是否维持在线；
2. 确认 QQ 机器人配套插件完整安装；
3. 核对 AppID、AppSecret 无多余空格、字符填写错误；
4. 确认已点击保存渠道配置，参数生效；
5. 确认 QQ 内联系的机器人为当前绑定实例； 排查完毕仍无效果，可重启 Gateway 服务或重启 OpenClaw 程序后再次测试。

配套平台参考链接

QQ 机器人登录访问地址：https://q.qq.com/qqbot/openclaw/login.html