前置准备工作

在正式开始为OpenClaw（Clawdbot）配置接入QQ机器人之前，请依次检查如下事项是否准备完成：

• 您已经拥有一个完成实名认证的腾讯QQ账号。

• 是否已经在 Lighthouse服务器实例 部署且配置好了OpenClaw，且 为2026.1.30或更高版本 。如果暂时还没有，建议：

  • 如果您希望新购一台 Lighthouse 服务器来安装运行OpenClaw，可以前往腾讯云Lighthouse产品的 购买页 选购，或者前往腾讯云 OpenClaw专属活动 进行优惠下单。

  • 如果已有之前部署的OpenClaw，但不是最新版本的应用模板，可以参考教程进行版本更新： 如何更新服务器OpenClaw应用版本 。

接入QQ

注意：以下步骤针对已在腾讯云Lighthouse服务器中部署OpenClaw，从零开始配置接入QQ的情况，如果有部分步骤已完成，可酌情跳过。

注册QQ开放平台

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

首次注册之后，可以按照QQ开放平台的指引 设置超级管理员 。

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

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

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

创建一个QQBot机器人

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

QQ机器人创建完成之后，可选择机器人点击进入管理页面。

在QQ机器人管理页面获取当前机器人的AppID和AppSecret，复制并将其保存到个人记事本或备忘录中（请注意数据安全，勿泄露），后续在“为OpenClaw配置QQ机器人AppID和AppSecret”步骤中需要使用。

“ 注意：出于安全考虑，QQ机器人的AppSecret不支持明文保存，首次查看或忘记AppSecret需要重新生成。

沙箱配置

在QQ机器人的“开发管理”页面，在“沙箱配置”中，设置单独聊天（选择“在消息列表配置”）。您可以按照自己的使用场景进行配置，也可以完成后续步骤之后再回到本步骤进行操作。

注意：
此处已创建的QQ机器人 无需 进行发布上架对所有QQ用户公开使用，在开发者私人的（沙箱）调试下使用体验即可。
QQ开放平台 不支持机器人的“在QQ群配置”操作 ，只支持单独和QQ机器人聊天。

注意：选择“在消息列表配置”时，需要先添加成员，再通过该成员的QQ扫码来添加机器人。

此处注意添加成员成功之后，还需要使用QQ扫码添加。

此时您的QQ账号添加机器人之后，还不能与该机器人正常进行对话，会提示“该机器人去火星了，稍后再试吧”，因为QQ机器人此时尚未与OpenClaw应用打通。您需要继续后面的步骤，为OpenClaw应用配置QQ机器人的AppID和AppSecret。

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

为OpenClaw配置模型和Channel

接下来需要为已经完成部署的OpenClaw配置模型和Channel（如QQ）。

进入腾讯云 控制台 ，选中对应的已部署OpenClaw的Lighthouse服务器，点击服务器卡片进入“管理实例”页面。

模型配置

为OpenClaw配置模型API Key可以在Lighthouse服务器的应用管理页面进行操作。详情可参考 云上OpenClaw(原Clawdbot)一键秒级部署指南 -配置模型APIKey，此处不再赘述。

Channel配置（配置QQ机器人App ID和App Secret）

进入“应用管理”页签，在“Channel配置”输入框，选择“QQ机器人”并输入在前面步骤中获取的QQ机器人App ID和App Secret，并点击 应用 并确定操作，等待几十秒后页面提示“保存成功”即完成配置。

提示：OpenClaw支持同一台服务器配置多个Channel，例如支持同时接入QQ机器人和飞书机器人。因此，如果当前正在配置的服务器之前已经接入了其他Channel，也可以继续添加更多Channel。

“ 提示：

1、点击“应用”按钮完成Channel配置之后，当面版本的Lighthouse服务器应用管理页面中并不会展示已配置的APP ID和App Secret。

2、如果在和QQ机器人对话时，回复“该机器人去火星了，稍后再试吧”，原因也可以是因为未正确配置App ID和App Secret，可以重试。

模型配置和Channel配置都完成之后就初步完成了OpenClaw配置，在手机QQ和电脑版上均可以开始与已接入OpenClaw的QQ机器人进行聊天。

在QQ中与QQ机器人互动

配置QQ机器人的App ID和App Secret之后，您可以在QQ软件中尝试和已经打通OpenClaw的QQ机器人进行单独聊天。如果QQ机器人能够以AI的方式对话，则说明您已经成功完成OpenClaw应用接入QQ机器人。

接下来您就可以开始进一步解锁OpenClaw接入QQ机器人之后的更多使用场景。例如，创建两台部署OpenClaw并且接入同一个QQ机器人…

常见问题及解决方法