如果你已经把 OpenClaw 部署在云服务器上,那么接入 QQ 的整体流程其实并不复杂:先去 QQ 开放平台创建一个 QQ 机器人,拿到 AppID 和 AppSecret,再回到云上 OpenClaw 的管理面板完成模型配置与通道配置,最后在 QQ 里验证机器人是否可以正常回复。腾讯云这套接入方式走的是可视化面板,不需要你再额外跑原生命令。
1. 开始前先准备好这几样东西
正式操作前,先确认你已经具备下面几个条件:
- 有一个完成实名认证的 QQ 账号。
- 已经在 Lighthouse 轻量应用服务器里部署好 OpenClaw。
- 如果你的 OpenClaw 实例是较早版本创建的,最好先更新到较新的应用版本再继续配置。
- 如果你打算长期使用 QQ 通道,优先选择国内服务器和可稳定调用的模型服务。
2. 注册并登录 QQ 开放平台

先进入 QQ 开放平台,使用手机 QQ 扫码登录。如果你之前没有注册过,扫码并授权后,平台会自动帮你完成注册并把当前 QQ 账号绑定到开放平台。完成后,你会进入 QQ 机器人的管理页面。

3. 创建你的 QQ 机器人

进入 QQ 机器人页面后,点击“创建机器人”,按页面提示新建一个机器人。创建完成后,系统会生成两个非常关键的参数:
AppIDAppSecret

把这两个值立刻复制并保存好,后面配置 OpenClaw 时必须用到。这里尤其要注意,AppSecret 出于安全原因通常不会长期明文展示,之后再查看时可能需要重置,所以第一次出现时一定要妥善保存。

创建完成后,你在 QQ 客户端里一般已经能看到这个机器人出现在消息列表中。不过此时它通常还不能正常工作,因为它只是“建好了”,还没有真正和你的 OpenClaw 实例连通。原文里提到,如果还没完成云端配置,和机器人对话时可能会看到“该机器人去火星了,稍后再试吧”这类提示。

4. 进入 OpenClaw 管理页面
接下来回到腾讯云控制台,找到你部署 OpenClaw 的 Lighthouse 实例,进入实例详情,再进入“应用管理”页面。后面的模型设置和 QQ 通道设置,都在这里完成。

5. 先把模型配置好

QQ 只是消息进出的入口,真正负责理解和回复内容的,还是你给 OpenClaw 配置的模型。所以在接通 QQ 之前,先确认模型 API Key 已经正确填写,模型本身也能正常调用。

这一点非常重要,因为很多人以为“QQ 不回复”是通道没配好,实际上更常见的原因之一是模型没配通、Key 填错,或者模型服务本身不可用。原文也特别提醒过,模型配置是必需步骤,查看模型热门模型注册地址。
6. 配置 QQ 通道
模型确认没问题后,再去做通道配置。
在“应用管理”页面里找到 Channel 配置区域,新增一个 QQ 通道,然后把你刚才保存的 AppID 和 AppSecret 填进去,保存并应用配置。系统处理完成后,页面出现保存成功,就说明 QQ 通道已经正式接入到 OpenClaw。

这一步如果参数填错,最典型的现象就是你回到 QQ 后,机器人依旧无法正常回答,或者继续提示异常状态。所以一旦失败,第一时间检查的就是这两个值有没有复制错误、有没有漏填、有没有把旧的 Secret 填进去。
7. 回到 QQ 测试是否接入成功
完成模型配置和 QQ 通道配置以后,就可以回到手机 QQ 或电脑版 QQ,直接给机器人发送消息进行测试。只要它能像 AI 助手一样正常理解并回复,就说明整条链路已经打通了。

这里有个细节需要注意:不建议把这个 QQ 机器人直接拉进群里做互动,至少在当前场景下,优先以单聊方式测试和使用会更稳妥。
8. 接入成功后能做什么
在接通 QQ 之后,机器人不只是能收发普通文字。原文给出的能力范围还包括:
- 接收文本
- 接收图片
- 接收文件
- 回复文本
- 回复图片
- Markdown 格式回复
- 主动发送消息
- 语音消息
- 回复文件
不过“历史消息引用”当前是不支持的。
另一个很关键的提醒是:QQ 只是通道,真正能不能识别图片、生成图片、处理文件,仍然取决于你背后的模型能力。

比如你想让机器人看图,就要给 OpenClaw 配置支持视觉理解的模型;你想让它出图,就要接支持图像生成的模型。

9. 两类最常见的问题
9.1. 机器人提示异常,无法对话
如果机器人回复类似“去火星了,稍后再试吧”,优先检查下面两项:
- 是否根本没有在 OpenClaw 里填写 QQ 机器人的
AppID和AppSecret - 是否填入了错误的
AppID或AppSecret
9.2. 看起来接通了,但机器人就是不回消息
这种情况通常不是 QQ 通道本身的问题,而是模型配置异常。比如 API Key 没配好、模型不可用、模型调用失败,都可能导致机器人收得到消息却回不出来。解决思路就是回到 OpenClaw 的模型配置页,重新检查模型接入状态。
10. 总结
把 OpenClaw 接到 QQ 上,核心就四步:
- 部署好 OpenClaw
- 在 QQ 开放平台创建机器人
- 保存好
AppID和AppSecret - 在云端面板里完成模型配置和 QQ 通道配置
只要这四步都做对,基本就能顺利把 QQ 机器人变成你的 OpenClaw 对话入口。后面无论是做个人助理、文件处理、图文问答,还是定时提醒,都是在这个基础上继续扩展。
