OpenClaw QQ集成教程

通过 QQ 开放平台创建企业自建机器人，将 OpenClaw 接入 QQ 平台，实现与 QQ 机器人的单聊、群聊等功能。

一、所需资料

• 您已拥有一个完成实名认证的腾讯 QQ 账号
• 已完成 OpenClaw 的部署和基础配置。（OpenClaw 环境搭建教程）

二、接入 QQ 教程

第一步：注册 QQ 开放平台

前往腾讯 QQ 开放平台 官网，默认无法使用 QQ 账号直接登录，需要新注册 QQ 开放平台账号。

QQ 开放平台登录页面

首次注册后，按照指引设置超级管理员。

设置超级管理员

手机 QQ 扫码成功后，继续填写主体相关信息。此处以”个人”为例，依次输入姓名、身份证号、手机号、验证码，点击继续进入人脸认证。

填写主体相关信息

使用手机 QQ 扫码进行人脸认证。

手机 QQ 扫码进行人脸认证

人脸识别审核通过后，即可登录进入 QQ 开放平台。

人脸认证通过后进入 QQ 开放平台

第二步：创建 QQ Bot 机器人

在 QQ 开放平台的 QQ 机器人页面，点击创建机器人。

QQ 机器人页面

创建 QQ 机器人

机器人创建完成后，点击进入管理页面。

选择机器人进入管理页面

在管理页面获取当前机器人的 AppID 和 AppSecret，复制并保存到记事本中（注意数据安全，勿泄露），后续配置步骤中需要使用。

获取 AppID

获取 AppSecret

第三步：沙箱配置

在 QQ 机器人的”开发管理”页面，在”沙箱配置”中设置单独聊天或群聊。

设置与 QQ 机器人单独聊天

进入”沙箱配置”页面，选择”在消息列表配置”，先添加成员，再通过该成员的 QQ 扫码来添加机器人。

沙箱配置 – 在消息列表配置

添加成员

添加成员成功后，还需要使用 QQ 扫码完成添加。

使用 QQ 扫码添加机器人

机器人尚未与 OpenClaw 打通时的提示

（可选）可以参考前述步骤添加更多成员：在成员管理页面中添加新成员，然后在沙箱配置页面中添加，之后新成员即可通过 QQ 扫码添加该机器人。

成员管理页面

在沙箱配置中添加成员

新成员通过 QQ 扫码添加机器人

设置将 QQ 机器人加入群聊

在”沙箱配置”页面，找到”在 QQ 群配置”，在”QQ 群 ID”下拉框中选择希望添加机器人的群聊。

在 QQ 群配置中选择群聊

在 QQ 软件的群聊管理页面，选择”群机器人”。

QQ 群聊管理页面 – 选择”群机器人”

在群机器人列表中选择”其他”，找到前面创建的 QQ 机器人，点击添加。

在群机器人列表中添加机器人

第四步：为 OpenClaw 配置模型和通道

进入 OpenClaw 管理后台，完成模型 API Key 配置，然后在”通道配置”中选择 QQ 机器人，输入前面获取的 App ID 和 App Secret，点击应用并确认，等待提示”保存成功”即完成配置。

进入 OpenClaw 管理后台

配置模型 API Key

通道配置 – 输入 QQ 机器人 App ID 和 App Secret

三、与 QQ 机器人互动

配置完成后，即可在 QQ 中与已接入 OpenClaw 的机器人进行单独聊天或群聊。机器人能够以 AI 方式对话则说明接入成功。

与接入 OpenClaw 的 QQ 机器人进行聊天

支持的消息类型

将 OpenClaw 接入 QQ 后，QQ 机器人支持以下消息类型：

QQ 机器人支持的消息类型	是否支持
接收文本信息	✅ 已支持
接收图片	✅ 已支持
接收文件	✅ 已支持
回复文本信息	✅ 已支持
回复图片	✅ 已支持
回复内容支持 Markdown 格式	✅ 已支持
主动发送消息（如定时发送提醒）	✅ 已支持
语音消息	✅ 已支持
历史消息引用	✅ 已支持
回复文件	❌ 暂不支持

QQ 机器人接收图片示例

QQ 机器人回复图片示例

四、常见问题

报错提示	可能原因	解决方式
机器人回复”该机器人去火星了，稍后再试吧”	未配置或配置了错误的 App ID / App Secret	重新检查并配置正确的 App ID 和 App Secret