OpenClaw 接入 QQ 机器人完整教程｜腾讯云 Lighthouse 一键部署

前置准备工作

1. 你已拥有完成实名认证的腾讯 QQ 账号。
2. 已在腾讯云 Lighthouse 实例中部署好 OpenClaw：
   • 新购服务器：可前往腾讯云 Lighthouse 购买页，或 OpenClaw 专属优惠活动页下单，按官方指南完成部署。
   • 旧版本更新：若你的 OpenClaw 应用模板创建时间早于 2026 年 2 月 11 日，请先更新版本，参考《如何更新服务器 OpenClaw 应用版本》。
3. OpenClaw 接入 QQ 推荐使用国内服务器 + 国内模型服务，以保证稳定性。

一、注册 QQ 开放平台

1. 打开 QQ 开放平台官网，完成账号注册。
2. 按指引设置超级管理员，使用手机 QQ 扫码授权。
3. 选择主体类型（本文以个人为例），填写姓名、身份证号、手机号、验证码。
4. 完成人脸认证。
5. 认证通过后，即可进入 QQ 开放平台控制台。

二、创建 QQ Bot 机器人

1. 在 QQ 开放平台，进入 QQ 机器人 页面，点击创建机器人。
2. 填写机器人基本信息，完成创建。
3. 进入机器人管理页，获取两个关键信息：
   • AppID
   • AppSecret

安全提醒：AppSecret 只显示一次，泄露会导致机器人被冒用。

三、沙箱配置（私人使用无需上架）

1. 设置单独聊天（推荐）

1. 进入机器人 开发管理 → 沙箱配置。
2. 选择 在消息列表配置。
3. 添加测试成员 QQ 号。
4. 使用该成员的手机 QQ 扫码，添加机器人为好友。

2.（可选）设置群聊机器人

1. 在沙箱配置中选择 在 QQ 群配置。
2. 选择要加入的 QQ 群。
3. 在 QQ 群管理 → 群机器人 → 其他，找到你的机器人并添加。

提示：目前 QQ 群机器人能力有限，更推荐单独聊天模式。

四、为 OpenClaw 配置 QQ 机器人通道

1. 进入腾讯云控制台，打开已部署 OpenClaw 的 Lighthouse 实例。
2. 进入 应用管理 页面。

1. 模型配置

2. 通道配置（关键步骤）

1. 在 Channel 配置 中选择 QQ 机器人。
2. 填入之前保存的：
   • AppID
   • AppSecret
3. 点击 添加并应用 → 确认。
4. 等待几秒提示 保存成功 即完成对接。

OpenClaw 支持多通道同时运行（QQ、企微、飞书等），可随意叠加。

五、在 QQ 中与 AI 机器人互动

• 给机器人发消息
• 支持文字、图片、文件、语音、引用回复

六、QQ 机器人支持的消息类型

• 接收文本 ✅
• 接收图片 ✅
• 接收文件 ✅
• 回复文本 ✅
• 回复图片 ✅
• Markdown 格式回复 ✅
• 主动发送消息 ✅
• 语音消息 ✅
• 历史消息引用 ✅
• 回复文件 ❌（暂不支持）

注意：图片识别、文件理解等能力，需要你在 OpenClaw 中配置具备多模态能力的模型。

七、常见问题与解决方法

问题：机器人提示 “该机器人去火星了，稍后再试吧”

1. 未配置 AppID / AppSecret
2. AppID 或 AppSecret 填写错误