🔥玩转OpenClaw｜云上OpenClaw快速接入QQ指南

重磅更新：QQ 现已支持在腾讯云轻量应用服务器 Lighthouse 控制台中扫码一键接入云上 OpenClaw。无需手动创建 QQBot，也无需复制 AppID / AppSecret。

本文将介绍如何在腾讯云轻量应用服务器 Lighthouse 中完成 OpenClaw 部署后，通过 QQ 扫码授权 的方式快速接入 QQ ClawBot。

如果您还不了解 OpenClaw（原名 Clawdbot，中文名俗称“龙虾”），或尚未完成云端部署，建议先参考云上 OpenClaw（原 Clawdbot）一键秒级部署指南，完成基础部署后再继续本文操作。

适用场景

本文适合以下用户：

• 已经在 Lighthouse 中部署了 OpenClaw。
• 希望通过 QQ 与云端 OpenClaw 进行对话。
• 希望使用更简单的扫码方式完成 QQ 通道接入。
• 不想再手动进入 QQ 开放平台创建机器人、复制 AppID / AppSecret。

前置准备

开始前，请确认以下事项已经完成：

• 拥有一个可正常登录和扫码的腾讯 QQ 账号。
• 已参考云上 OpenClaw 一键秒级部署指南完成云端 OpenClaw 部署。
• 如果您的 OpenClaw 应用模板创建时间较早，建议先参考如何更新服务器 OpenClaw 应用版本更新云端 OpenClaw。
• 已为 OpenClaw 配置可用的模型 API Key。模型配置方式可参考云上 OpenClaw 一键秒级部署指南中的“配置模型 API Key”部分。

提示：云上 OpenClaw 接入 QQ 场景推荐使用国内服务器和国内模型服务，以获得更稳定的访问体验。

第一步：进入 OpenClaw 应用管理页

打开并登录腾讯云 Lighthouse 控制台，找到希望接入 QQ 的 OpenClaw 实例，单击实例卡片进入实例管理页面。

进入实例管理页面后，切换到 应用管理，打开 OpenClaw 的配置面板。

第二步：选择 QQ 通道并前往授权

在 OpenClaw 配置面板中找到 通道 / Channel 配置区域，选择 QQ 通道，然后点击 前往授权。

稍等片刻，页面会弹出 QQ 扫码接入窗口，并展示用于授权接入的二维码。

注意：二维码通常具有时效性。如页面提示二维码过期，请刷新或重新点击“前往授权”。

第三步：使用手机 QQ 扫码完成接入

在手机中打开 QQ，使用 QQ 的 扫一扫 扫描控制台页面中的二维码。

扫码后，请按照手机 QQ 页面提示完成授权或添加操作。

授权完成后，QQ ClawBot 会出现在您的 QQ 消息列表中。进入对话页后，即可开始与已经接入 OpenClaw 的 QQ ClawBot 对话。

如果 QQ ClawBot 能够正常以 AI 的方式回复，则说明您已经成功完成云上 OpenClaw 接入 QQ。

第四步：确认模型配置

为 OpenClaw 配置模型 API Key 可以在轻量应用服务器 Lighthouse 产品控制台的应用管理页面进行操作。详情可参考云上 OpenClaw（原 Clawdbot）一键秒级部署指南中的“配置模型 API Key”部分，此处不再赘述。

实用技巧：如果担心模型配置未生效，可以登录轻量应用服务器，通过 OpenClaw TUI 工具进行验证。具体步骤可参考云上 OpenClaw（原 Clawdbot）一键秒级部署指南中的“使用 TUI 与 OpenClaw 进行交互”。

QQ ClawBot 支持的消息类型

基于前述步骤将 OpenClaw 接入 QQ 后，QQ ClawBot 除了能够接收、回复基础文本信息外，还支持更多消息类型。

支持能力如下：

• ✅ 接收文本信息
• ✅ 接收图片
• ✅ 接收文件
• ✅ 回复文本信息
• ✅ 回复图片
• ✅ 回复内容支持 Markdown 格式
• ✅ 主动发送消息（如定时发送提醒）
• ✅ 语音消息
• ✅ 回复文件
• ❌ 历史消息引用：暂不支持

提示：上述列表仅代表 QQ ClawBot 能接收或回复的消息类型。实际能否处理图片、文件等内容，还取决于您接入的模型是否具备对应能力。

QQ ClawBot 可以接收图片、文件，示例如下：

QQ ClawBot 可以回复图片、文件，示例如下：

常见问题

1. 扫码后没有成功接入怎么办？

请依次检查：

• 当前 OpenClaw 应用版本是否已更新到支持 QQ 扫码接入的版本。
• Lighthouse 控制台中的 OpenClaw 应用是否正常运行。
• 是否已正确配置模型 API Key。
• 是否使用的是可正常登录和扫码的 QQ 账号。
• 二维码是否已经过期，必要时可重新点击“前往授权”。

2. QQ ClawBot 不回复怎么办？

可能原因包括：

• 模型 API Key 未配置或配置错误。
• 云端 OpenClaw 应用未正常运行。
• QQ 授权未完成或授权已失效。
• 当前模型服务不可用或响应超时。

建议回到 Lighthouse 控制台的 OpenClaw 应用管理页，检查模型配置和 QQ 通道状态；必要时重新执行一次 QQ 扫码授权。

3. 还需要去 QQ 开放平台手动创建机器人吗？

不需要。使用本文介绍的新版扫码接入流程时，无需再手动进入 QQ 开放平台注册、创建 QQBot、复制 AppID / AppSecret。扫码授权流程会自动完成接入所需配置。

4. 可以把 QQ ClawBot 拉进 QQ 群聊吗？

当前不建议将 QQ ClawBot 添加进 QQ 群聊进行对话互动。建议先在单聊场景中完成验证和体验。

更多教程

更多云上 OpenClaw 实践教程，如一键部署 OpenClaw、接入微信 / QQ / 企微 / 钉钉 / 飞书 / Discord / Telegram / WhatsApp、安装并使用 Skills 等，欢迎查看云上 OpenClaw（原 Clawdbot）最全实践教程合辑。