QQ 机器人接入 OpenClaw v2.7.9：从平台注册到功能测试的图文手册（含安装包）

1. 先搞清楚这套链路到底在做什么QQ 机器人接入 OpenClaw v2.7.9本质上是把 QQ 开放平台当成一个消息通道把 OpenClaw 当成后端大脑。用户在 QQ 里发一句话QQ 开放平台通过回调把消息推给 OpenClaw 的 QQ 渠道插件插件调用本地模型生成回复再原路返回给 QQ。整条链路里AppID 和 AppSecret 是身份凭证插件是协议翻译层Gateway 是消息总线。适合谁看这篇已经在本地跑起 OpenClaw v2.7.9、想让自己的 QQ 号变成一个能对话的机器人、又不想从零读官方文档的人。你需要准备的东西不多——一台能正常启动 OpenClaw 的电脑、一个能扫码登录的 QQ 账号、手机端 QQ 客户端用来扫码和测试。Windows 和 macOS 都有对应的整合包装完能打开界面、顶部 Gateway 显示在线就算满足前置条件了。我试过在 Windows 和 macOS 上各跑一遍流程基本一致差异只在安装包和解压路径。下面按“平台注册 → 拿密钥 → 装插件 → 填配置 → 发消息验证”的顺序走每一步都给可复制的配置骨架和验证动作。你照着做大概二十分钟能从零到机器人回你第一句话。2. TaoToken 前置把模型通道先打通OpenClaw 本身不带模型它需要你给它一个能调用的模型服务。QQ 机器人只是入口真正生成回复的是背后的模型。所以在配 QQ 渠道之前先把模型通道配好否则机器人能收到消息但回不出内容。TaoToken 在这里的角色是模型聚合入口你拿一个 API Key就能在 OpenClaw 里调用多种模型。注册和拿 Key 的路径很短打开官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 进控制台创建 API Key。API 地址是 https://taotoken.net/api 这个地址在 OpenClaw 的模型配置里会用到。具体操作登录后进控制台左侧找 API Keys点新建复制生成的 Key。这个 Key 只显示一次跟后面 QQ 的 AppSecret 一样先存到本地文本里。然后在 OpenClaw 的设置里找模型配置把 API 地址填成 https://taotoken.net/api 把 Key 填进对应输入框模型名按你实际要用的填。保存后回主界面看 Gateway 是否还在线。注意模型通道和 QQ 渠道是两条独立的配置线。模型通道不通QQ 机器人会“已读不回”QQ 渠道不通模型再好也收不到消息。建议先把模型通道用对话测试跑通再动 QQ 渠道。如果你只是想先验证模型能不能用可以直接在模型对话页面发一条测试消息确认有回复再继续。长期做编码或 Agent 场景的话可以看下 Coding Plan但本篇聚焦 QQ 接入模型侧只要保证能调通即可。3. 平台注册与 AppID/AppSecret 获取这一步在 QQ 开放平台完成。打开机器人登录页 https://q.qq.com/qqbot/openclaw/login.html 用手机 QQ 扫码。扫码成功后右下角会弹授权确认勾选《QQ 开放平台服务协议》点同意进入机器人管理后台。在「我的机器人」分区点创建机器人自定义头像和名称。创建完成后页面会展示两组核心凭证AppID 和 AppSecret。把这两组完整复制出来存到本地。AppSecret 属于高敏感凭证平台不会长期明文展示刷新页面后可能就看不到了所以创建完立刻备份。这里有个容易踩的坑复制的时候容易带上首尾空格。AppID 一般是纯数字或字母数字组合AppSecret 是一串较长的字符。粘到 OpenClaw 之前先在文本编辑器里看一眼有没有多余空格或换行。我见过有人因为 AppSecret 末尾多了一个空格排查了半小时。注意AppID 和 AppSecret 是一一对应的不要拿 A 机器人的 AppID 配 B 机器人的 AppSecret。如果你创建了多个机器人实例确认当前要接入的是哪一个。4. 安装 QQ 渠道插件并写入配置回到 OpenClaw v2.7.9 主程序。点右上角设置左侧菜单找聊天配置定位到 QQ 机器人功能卡片。如果卡片上显示「安装插件」按钮说明本地还没装 QQ 渠道组件点一下等它自动下载安装。安装进度结束后卡片会变成可填写参数的状态。下面是配置骨架你可以对照着填# OpenClaw QQ 渠道配置骨架示意字段名以实际界面为准 qq: enabled: true app_id: 你的AppID app_secret: 你的AppSecret gateway: local reconnect_interval: 5界面上对应两个输入框App ID 填平台生成的 AppIDApp Secret 填 AppSecret。确认渠道启用开关处于开启状态点右上角保存。保存后建议回主界面看一眼 Gateway 状态如果它从在线变成重连中说明配置写入触发了服务重载等几秒恢复即可。如果你更习惯用配置文件方式管理OpenClaw 的配置目录一般在用户目录下的.openclaw或安装目录的config文件夹里。找到渠道配置文件按上面的骨架填保存后重启 OpenClaw。两种方式效果一样界面填更直观配置文件更适合批量部署。5. 验证请求与成功结果配置保存后打开手机 QQ找到你刚创建的机器人账号发一条测试消息比如“你好”。如果链路通机器人会自动回复内容。第一次回复可能有几秒延迟因为插件要建立连接、模型要生成。验证成功的标志有三个QQ 里收到回复、OpenClaw 界面日志里出现 QQ 渠道的消息记录、Gateway 保持在线。三个都满足说明从 QQ 到 OpenClaw 再到模型的整条链路打通了。如果想让验证更严谨可以发一条带上下文的消息比如先问“我叫小明”再问“我叫什么”看机器人能不能记住。能记住说明会话管理也正常。这一步过了QQ 机器人接入就算完成后面可以按需调模型参数、加知识库、改回复风格。6. 本篇常见错排查QQ 渠道卡片一直显示安装插件按钮整合包不预装全部第三方渠道组件QQ 渠道需要单独装。点按钮等自动下载如果一直失败检查网络是否能访问插件源或者手动下载插件包放到指定目录。AppID 和 AppSecret 填了但机器人不回按顺序排查——Gateway 是否在线插件是否装完两组参数有没有多余空格渠道开关是否开启是否点了保存QQ 里联系的机器人是不是当前绑定的实例。排查完还不行重启 Gateway 或重启 OpenClaw 再试。AppSecret 刷新后看不到了平台出于安全设计不长期明文展示创建时没备份就只能重置。在开放平台后台找重置密钥的入口重置后旧密钥失效记得同步更新 OpenClaw 里的配置。机器人回复很慢或超时先看模型通道是否正常用模型对话页面发一条测试。如果模型侧就慢那是模型服务的问题如果模型侧快但 QQ 侧慢检查本地网络到 QQ 开放平台的连通性以及 Gateway 的负载。多个机器人实例串了确认 OpenClaw 里填的 AppID 和 QQ 里测试的机器人是同一个。如果你创建了多个实例每个实例的凭证不同配错就会导致消息发到 A 但回复来自 B。排障时如果怀疑是模型通道的问题可以去 API Keys 页面确认 Key 是否有效、额度是否充足接入细节可以对照接入文档核对字段。验证模型本身是否正常用模型对话最快。长期跑编码或 Agent 场景Coding Plan 会更省心。7. 配完之后可以做的事链路通了之后QQ 机器人就是一个入口背后能挂什么取决于你在 OpenClaw 里怎么配。你可以给它加系统提示词让它用特定语气回复可以接知识库让它回答领域问题也可以挂工具调用让它查天气、算数、执行本地脚本。安装包获取方面Windows 和 macOS 都有整合包下载后解压、启动、确认 Gateway 在线即可。如果你还没装 OpenClaw先去官网拿包装完再回来走这篇的流程。整个流程里最关键的三个点模型通道先通、AppSecret 及时备份、配置保存后看 Gateway 状态。这三点守住基本不会卡住。