还没有一台OpenClaw云服务器？点此即可享一键秒级部署：
curl.qcloud.com/OZhKMTQh
支持快速接入QQ、企微、飞书、钉钉等IM软件。
动手前的准备
在着手给 OpenClaw (Clawdbot) 接入 QQ 机器人之前，咱们先把基础工作核对一遍，确保万无一失：
- 你手里得有一个已经通过实名认证的腾讯 QQ 号。
- 确认你的 Lighthouse 服务器 已经装好了 OpenClaw，而且版本得是 2026.2.3 或者更新的。如果还没弄好，建议按下面说的做：
- 要是你打算新买个服务器来跑 OpenClaw，直接去腾讯云 Lighthouse 的购买页面挑一个，或者去 OpenClaw 的专属活动页看看有没有优惠。具体的安装配置步骤，找找那篇“云上 OpenClaw 一键秒级部署指南”照着做就行。
- 要是你之前已经部署过旧版的 OpenClaw，那就参照更新教程把版本升上来。
小建议：在国内环境接入 QQ，服务器和模型服务最好也都选国内的，速度和稳定性更有保障。
还没有一台OpenClaw云服务器？点此即可享一键秒级部署：
curl.qcloud.com/OZhKMTQh
支持快速接入QQ、企微、飞书、钉钉等IM软件。
连接 QQ
注意：下面的教程是假设你在腾讯云 Lighthouse 服务器上从头开始配置 OpenClaw 接入 QQ 的。如果你之前已经搞定了一部分，这部分步骤直接跳过就行。
搞定 QQ 开放平台账号
先去腾讯的 QQ 开放平台官网。注意，这里不能直接用你平时的 QQ 密码登录，得先注册一个开放平台的开发者账号。
注册完进去了，按照平台的提示先把超级管理员设置好。
用手机 QQ 扫码确认后，下一步就是填主体信息。咱们以“个人”开发者为例，按要求填好姓名、身份证、手机号和验证码，点继续去做人脸识别。
拿出手机 QQ 扫一下码，配合做个人脸认证。
审核通过之后，就能正式登录 QQ 开放平台了。
还没有一台OpenClaw云服务器？点此即可享一键秒级部署：
curl.qcloud.com/OZhKMTQh
支持快速接入QQ、企微、飞书、钉钉等IM软件。
建个 QQ 机器人
在平台的 QQ 机器人页面，找找创建机器人的入口。
建好之后，点一下你的机器人卡片，进到它的管理后台。
在管理页面里找到 AppID 和 AppSecret，把这两个串码复制下来，存到你的记事本或者备忘录里（千万别发给别人，注意保密）。后面我们在 OpenClaw 里配置的时候要用到。
提醒一下：为了安全，QQ 机器人的 AppSecret 只有在第一次生成时显示明文，系统不会帮你保存。要是你忘了或者没记下来，就只能重新生成一个新的了。
还没有一台OpenClaw云服务器？点此即可享一键秒级部署：
curl.qcloud.com/OZhKMTQh
支持快速接入QQ、企微、飞书、钉钉等IM软件。
配置沙箱测试
在机器人的“开发管理”菜单里，找到“沙箱配置”。我们需要设置单独聊天（选那个“在消息列表配置”）。你可以现在弄，也可以等后面步骤做完了再回来弄。
⚠️ 注意： 咱们创建的这个 QQ 机器人不需要发布上线给所有人用，咱们自己作为开发者在沙箱环境里私下测试体验就行。 目前 QQ 开放平台不支持把机器人加到 QQ 群里，只能进行一对一的私聊。
注意：如果选的是“在消息列表配置”，你得先把要测试的 QQ 号加为成员，然后用这个 QQ 号扫码去添加机器人。
这里千万别忘了，成员添加成功后，还得用手机 QQ 扫码操作一下才算加上。
这时候虽然你的 QQ 加上了机器人，但你跟它说话它还不会理你，系统会弹个提示说“该机器人去火星了，稍后再试吧”。这是正常的，因为我们还没把机器人和 OpenClaw 应用连起来。别急，接着往下看怎么配置 AppID 和 AppSecret。
（可选）如果你想让朋友也能试用，可以按上面的流程添加更多成员：先在成员管理里加人，再去沙箱配置里把人加进去，最后让他们扫码添加机器人就行。
给 OpenClaw 配置模型和连接通道
现在我们把跑在服务器上的 OpenClaw 和刚才申请的 QQ 机器人（通道）连起来。
去腾讯云控制台，找到你部署了 OpenClaw 的那台 Lighthouse 服务器，点进去进入“管理实例”界面。
配置模型
关于怎么在应用管理页面填模型 API Key，这里就不啰嗦了，直接参考之前的“云上 OpenClaw 一键秒级部署指南”里的配置部分就行。
配置通道（填 QQ 机器人的 App ID 和 App Secret）
切到“应用管理”标签页，找到“Channel 配置”这一块。在下拉菜单里选“QQ 机器人”，然后把之前记在小本本上的 App ID 和 App Secret 填进去，点一下应用并确认。等个几十秒，看到页面提示“保存成功”就算搞定了。
小贴士：OpenClaw 允许一台服务器接好几个通道。比如你之前已经接过飞书机器人了，现在再加个 QQ 机器人也是完全没问题的。
提示：
如果配置完跟机器人说话，它还是回“该机器人去火星了”，多半是 App ID 或者 App Secret 填错了或者没保存上，检查一下重新配一次试试。
等模型和通道都配好了，基础工作就算完成了。拿出手机 QQ 或者打开电脑版 QQ，跟你的机器人聊两句试试吧。
还没有一台OpenClaw云服务器？点此即可享一键秒级部署：
curl.qcloud.com/OZhKMTQh
支持快速接入QQ、企微、飞书、钉钉等IM软件。
在 QQ 上跟机器人聊两句
填好 ID 和 Secret 后，在 QQ 里给机器人发个消息。如果机器人能像 AI 一样回你话，那就恭喜你，OpenClaw 已经成功接入 QQ 了！
既然通了，接下来就可以慢慢挖掘 OpenClaw 在 QQ 里的更多玩法了。
还能干啥？
「重要」2026.2.6 更新速递： Lighthouse 服务器上的新版 OpenClaw 镜像已经升级了接入 QQ 的插件和配置面板。 如果你想尝鲜新功能，记得去看那篇“如何更新服务器 OpenClaw 应用版本”的教程升一下级。
接好 QQ 之后，这个机器人可不光能收发文字，它还能干不少事儿：
| QQ 机器人能干的事 | 支不支持 |
|---|---|
| 收图片 | ✅ 没问题 |
| 收文件 | ✅ 没问题 |
| 发图片 | ✅ 没问题 |
| 回复 Markdown 格式 | ✅ 没问题 |
| 主动推消息 | ✅ 没问题 |
| 语音消息 | 🚧 马上就来 |
| 引用历史消息 | 🚧 马上就来 |
提醒：上面的表只代表 QQ 机器人这个“管道”能传什么，具体能不能看懂图片或者处理文件，还得看你后台接的那个 AI 模型有没有这个本事。
QQ 机器人接收图片和文件的样子大概是这样：
再次提醒：QQ 只是个传话筒。如果你想让 OpenClaw 分析图片，你配置的模型必须得具备视觉分析能力才行。
QQ 机器人发图片的效果如下（目前还不支持对外发文件）：
同样：想让机器人发图，你得给 OpenClaw 配一个能画图的模型。
常见坑点和解决办法
| 报错提示 | 啥原因 | 咋解决 |
|---|---|---|
能对话，但在正式回复前老是弹一句：[ClawdBot] QQ响应正常，但未收到clawdbot响应，请检查大模型是否正确配置 | 大模型脑子转得慢，OpenClaw 等不及了先报个信。 | 甭理它，等着 AI 回复就行。2026.2.3 版本里这个提示已经优化过了。 |
| QQ 机器人回复：“该机器人去火星了，稍后再试吧” | 俩可能：1. 没填 QQ 机器人的 App ID 和 Secret。2. 填错数了。 | 仔细对照上面的教程步骤，把那俩码重新填一遍。 |
还没有一台OpenClaw云服务器？点此即可享一键秒级部署：
curl.qcloud.com/OZhKMTQh
支持快速接入QQ、企微、飞书、钉钉等IM软件。
