OpenClaw 接入 QQ 机器人完整图文教程 从零配置可直接复制使用

admin2026-10-05 19:18:31【玩家论坛】

前置准备本地已安装 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机器人创建完成后，页面会展示两组核心对接参数：AppIDAppSecret及时完整复制并妥善留存，这两组参数是 OpenClaw 与 QQ 机器人对接的关键。温馨提示：AppSecret 属于应用敏感密钥，平台不会长期明文展示，建议创建完成立刻复制备份，切勿随意外泄。

步骤 5：进入 OpenClaw 配置页 安装 QQ 机器人插件切回 OpenClaw 主界面，点击右上角设置，进入左侧聊天配置板块，找到 QQ 机器人配置卡片。若卡片显示安装插件按钮，说明当前环境未内置 QQ 渠道依赖，直接点击安装，等待插件自动部署完成后再进行参数配置。

步骤 6：填写密钥参数并保存渠道配置将之前从 QQ 开放平台复制的参数依次对应填写：App ID：粘贴平台给出的 AppIDApp Secret：粘贴平台给出的 AppSecret确认配置项右侧启用开关为开启状态，点击右上角保存渠道配置，完成参数绑定。

步骤 7：发送消息测试接入是否成功配置保存生效后，打开手机 QQ，找到刚创建的机器人账号，发送一条测试消息，例如：你好。若机器人可以正常自动回复内容，代表 QQ 机器人已成功接入 OpenClaw，整条配置流程完成。接入完成自检清单已正常登录 QQ 开放平台后台成功创建专属 QQ 机器人应用完整复制并妥善保管 AppID、AppSecretOpenClaw 端 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一键装机包如图下载