通过 QQ 开放平台创建企业自建机器人，将 OpenClaw 接入 QQ 平台，实现与 QQ 机器人的单聊、群聊等功能。
前置准备
在开始配置前，请确认以下事项已准备完成：
- 您已拥有一个完成实名认证的腾讯 QQ 账号
- 已完成 OpenClaw 的部署和基础配置
接入 QQ
第一步：注册 QQ 开放平台
前往腾讯 QQ 开放平台 官网，默认无法使用 QQ 账号直接登录，需要新注册 QQ 开放平台账号。
首次注册后，按照指引设置超级管理员。
手机 QQ 扫码成功后，继续填写主体相关信息。此处以"个人"为例，依次输入姓名、身份证号、手机号、验证码，点击继续进入人脸认证。
使用手机 QQ 扫码进行人脸认证。
人脸识别审核通过后，即可登录进入 QQ 开放平台。
第二步：创建 QQ Bot 机器人
在 QQ 开放平台的 QQ 机器人页面，点击创建机器人。
机器人创建完成后，点击进入管理页面。
在管理页面获取当前机器人的 AppID 和 AppSecret，复制并保存到记事本中（注意数据安全，勿泄露），后续配置步骤中需要使用。
第三步：沙箱配置
在 QQ 机器人的"开发管理"页面，在"沙箱配置"中设置单独聊天或群聊。
设置与 QQ 机器人单独聊天
进入"沙箱配置"页面，选择"在消息列表配置"，先添加成员，再通过该成员的 QQ 扫码来添加机器人。
添加成员成功后，还需要使用 QQ 扫码完成添加。
（可选）可以参考前述步骤添加更多成员：在成员管理页面中添加新成员，然后在沙箱配置页面中添加，之后新成员即可通过 QQ 扫码添加该机器人。
设置将 QQ 机器人加入群聊
在"沙箱配置"页面，找到"在 QQ 群配置"，在"QQ 群 ID"下拉框中选择希望添加机器人的群聊。
在 QQ 软件的群聊管理页面，选择"群机器人"。
在群机器人列表中选择"其他"，找到前面创建的 QQ 机器人，点击添加。
第四步：为 OpenClaw 配置模型和通道
进入 OpenClaw 管理后台，完成模型 API Key 配置，然后在"通道配置"中选择 QQ 机器人，输入前面获取的 App ID 和 App Secret，点击应用并确认，等待提示"保存成功"即完成配置。
与 QQ 机器人互动
配置完成后，即可在 QQ 中与已接入 OpenClaw 的机器人进行单独聊天或群聊。机器人能够以 AI 方式对话则说明接入成功。
支持的消息类型
将 OpenClaw 接入 QQ 后，QQ 机器人支持以下消息类型：
| QQ 机器人支持的消息类型 | 是否支持 |
|---|---|
| 接收文本信息 | ✅ 已支持 |
| 接收图片 | ✅ 已支持 |
| 接收文件 | ✅ 已支持 |
| 回复文本信息 | ✅ 已支持 |
| 回复图片 | ✅ 已支持 |
| 回复内容支持 Markdown 格式 | ✅ 已支持 |
| 主动发送消息（如定时发送提醒） | ✅ 已支持 |
| 语音消息 | ✅ 已支持 |
| 历史消息引用 | ✅ 已支持 |
| 回复文件 | ❌ 暂不支持 |
常见问题
| 报错提示 | 可能原因 | 解决方式 |
|---|---|---|
| 机器人回复"该机器人去火星了，稍后再试吧" | 未配置或配置了错误的 App ID / App Secret | 重新检查并配置正确的 App ID 和 App Secret |