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

# 🔥玩转OpenClaw｜云上OpenClaw快速接入QQ指南 > 重磅更新：QQ 现已支持在腾讯云轻量应用服务器 Lighthouse 控制台中扫码一键接入云上 OpenClaw。无需手动创建 QQBot，也无需复制 AppID / AppSecret。 本文将介绍如何在腾讯云轻量应用服务器 Lighthouse 中完成 OpenClaw 部署后，通过 **QQ 扫码授权** 的方式快速接入 **QQ ClawBot**。 如果您还不了解 OpenClaw（原名 Clawdbot，中文名俗称“龙虾”），或尚未完成云端部署，建议先参考[云上 OpenClaw（原 Clawdbot）一键秒级部署指南](https://cloud.tencent.com/developer/article/2624003)，完成基础部署后再继续本文操作。 ## 适用场景 本文适合以下用户： - 已经在 Lighthouse 中部署了 OpenClaw。 - 希望通过 QQ 与云端 OpenClaw 进行对话。 - 希望使用更简单的扫码方式完成 QQ 通道接入。 - 不想再手动进入 QQ 开放平台创建机器人、复制 AppID / AppSecret。 ## 前置准备 开始前，请确认以下事项已经完成： - 拥有一个可正常登录和扫码的腾讯 QQ 账号。 - 已参考[云上 OpenClaw 一键秒级部署指南](https://cloud.tencent.com/developer/article/2624003)完成云端 OpenClaw 部署。 - 如果您的 OpenClaw 实例基于较早版本的应用镜像创建，建议先参考[如何更新服务器 OpenClaw 应用版本](https://cloud.tencent.com/developer/article/2627964)完成升级。 - 已为 OpenClaw 配置可用的模型 API Key。模型配置方式可参考[云上 OpenClaw 一键秒级部署指南](https://cloud.tencent.com/developer/article/2624003)中的“配置模型 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 产品[控制台](https://console.cloud.tencent.com/lighthouse)的应用管理页面进行操作。详情可参考[云上 OpenClaw（原 Clawdbot）一键秒级部署指南](https://cloud.tencent.com/developer/article/2624003)中的“配置模型 API Key”部分，此处不再赘述。  > \*\*实用技巧：\*\*如果担心模型配置未生效，可以登录轻量应用服务器，通过 OpenClaw TUI 工具进行验证。具体步骤可参考[云上 OpenClaw（原 Clawdbot）一键秒级部署指南](https://cloud.tencent.com/developer/article/2624003)中的“使用 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）最全实践教程合辑](https://cloud.tencent.com/developer/article/2624973)。