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