
在正式开始为OpenClaw(Clawdbot)配置接入QQ机器人之前,请依次检查如下事项是否准备完成:
您已经拥有一个完成实名认证的腾讯QQ账号。
是否已经在Lighthouse服务器实例部署且配置好了OpenClaw,且为2026.1.30或更高版本。如果暂时还没有,建议:
如果您希望新购一台Lighthouse服务器来安装运行OpenClaw,可以前往腾讯云Lighthouse产品的购买页选购,或者前往腾讯云OpenClaw专属活动进行优惠下单。
如果已有之前部署的OpenClaw,但不是最新版本的应用模板,可以参考教程进行版本更新:如何更新服务器OpenClaw应用版本。
注意:以下步骤针对已在腾讯云Lighthouse服务器中部署OpenClaw,从零开始配置接入QQ的情况,如果有部分步骤已完成,可酌情跳过。
前往腾讯QQ开放平台官网,默认无法使用您的QQ账号直接登录,需要新注册QQ开放平台账号。

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

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

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

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

在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(如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机器人的App ID和App Secret之后,您可以在QQ软件中尝试和已经打通OpenClaw的QQ机器人进行单独聊天。如果QQ机器人能够以AI的方式对话,则说明您已经成功完成OpenClaw应用接入QQ机器人。

接下来您就可以开始进一步解锁OpenClaw接入QQ机器人之后的更多使用场景。例如,创建两台部署OpenClaw并且接入同一个QQ机器人…
报错提示 | 报错原因 | 解决方式 |
可以正常和机器人对话,但是在回复前提示:[ClawdBot] QQ响应正常,但未收到clawdbot响应,请检查大模型是否正确配置 | 大模型响应比较慢,OpenClaw会进行提醒 | 不用关注,等待回复即可。 后续版本会优化。 |
QQ机器人回复:“该机器人去火星了,稍后再试吧” | 可能原因: 1、没有为OpenClaw添加QQ机器人的App ID和App Secret。 2、添加了错误的QQ机器人App ID和App Secret。 | 请参考教程对应步骤进行操作。 |

在正式开始为OpenClaw(Clawdbot)配置接入QQ机器人之前,请依次检查如下事项是否准备完成:
您已经拥有一个完成实名认证的腾讯QQ账号。
是否已经在Lighthouse服务器实例部署且配置好了OpenClaw,且为2026.1.30或更高版本。如果暂时还没有,建议:
如果您希望新购一台Lighthouse服务器来安装运行OpenClaw,可以前往腾讯云Lighthouse产品的购买页选购,或者前往腾讯云OpenClaw专属活动进行优惠下单。
如果已有之前部署的OpenClaw,但不是最新版本的应用模板,可以参考教程进行版本更新:如何更新服务器OpenClaw应用版本。
注意:以下步骤针对已在腾讯云Lighthouse服务器中部署OpenClaw,从零开始配置接入QQ的情况,如果有部分步骤已完成,可酌情跳过。
前往腾讯QQ开放平台官网,默认无法使用您的QQ账号直接登录,需要新注册QQ开放平台账号。

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

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

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

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

在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(如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机器人的App ID和App Secret之后,您可以在QQ软件中尝试和已经打通OpenClaw的QQ机器人进行单独聊天。如果QQ机器人能够以AI的方式对话,则说明您已经成功完成OpenClaw应用接入QQ机器人。

接下来您就可以开始进一步解锁OpenClaw接入QQ机器人之后的更多使用场景。例如,创建两台部署OpenClaw并且接入同一个QQ机器人…
报错提示 | 报错原因 | 解决方式 |
可以正常和机器人对话,但是在回复前提示:[ClawdBot] QQ响应正常,但未收到clawdbot响应,请检查大模型是否正确配置 | 大模型响应比较慢,OpenClaw会进行提醒 | 不用关注,等待回复即可。 后续版本会优化。 |
QQ机器人回复:“该机器人去火星了,稍后再试吧” | 可能原因: 1、没有为OpenClaw添加QQ机器人的App ID和App Secret。 2、添加了错误的QQ机器人App ID和App Secret。 | 请参考教程对应步骤进行操作。 |
<100 subscribers
<100 subscribers
Share Dialog
Share Dialog
No comments yet