QQ 是一款覆盖广泛用户群体的即时通讯平台,提供文字、语音、图片、文件等多种沟通能力,并支持群聊、频道等协作场景,适用于个人交流与团队协同。
该接入方式可将 OpenClaw 与 QQ Bot 进行连接,通过平台的长连接事件订阅机制接收消息与事件回调,从而在不对外暴露公网 Webhook 地址的情况下实现稳定、安全的消息收发与自动化能力集成。
OpenClaw plugins命令安装
```
openclaw plugins install @sliverp/qqbot@latest
使用源码安装:
``
git clone https://github.com/sliverp/qqbot.git && cd qqbot
openclaw plugins install .
首次注册之后,可以按照QQ开放平台的指引设置超级管理员。
手机QQ扫码成功后,继续下一步填写主体相关信息。
此处以“个人”为例,按照指引依次输入姓名、身份证号、手机号、验证码,点击继续进入下一步人脸认证。
使用手机QQ扫码进行人脸认证。
人脸识别审核通过后,即可登录进入QQ开放平台。
QQ机器人创建完成之后,可选择机器人点击进入管理页面。
在QQ机器人管理页面获取当前机器人的AppID和AppSecret,复制并将其保存到个人记事本或备忘录中(请注意数据安全,勿泄露),后续在“步骤3中配置OpenClaw“中需要使用。
注意:出于安全考虑,QQ机器人的AppSecret不支持明文保存,首次查看或忘记AppSecret需要重新生成。
您可以按照自己的使用场景进行配置,也可以完成后续步骤之后再回到本步骤进行操作。
⚠️ 注意:
此处已创建的QQ机器人无需进行发布上架对所有QQ用户公开使用,在开发者私人的(沙箱)调试下使用体验即可。
QQ开放平台不支持机器人的“在QQ群配置”操作,只支持单独和QQ机器人聊天。
注意:选择“在消息列表配置”时,需要先添加成员,再通过该成员的QQ扫码来添加机器人。
此处注意添加成员成功之后,还需要使用QQ扫码添加
此时您的QQ账号添加机器人之后,还不能与该机器人正常进行对话,会提示“该机器人去火星了,稍后再试吧”,因为QQ机器人此时尚未与OpenClaw应用打通。
您需要继续后面的步骤,为OpenClaw应用配置QQ机器人的AppID和AppSecret。
(可选)您也可以参考前述步骤添加更多成员:首先在成员管理页面中添加新成员,然后在沙箱配置页面中添加成员,之后新成员即可通过QQ扫码添加该QQ机器人。
添加qqbot channel 并将步骤2中获取的AppID和AppSecret
``
openclaw channels add --channel qqbot --token "AppID:AppSecret"方式二:通过配置文件配置
编辑 ~/.openclaw/openclaw.json:
` json`
{
"channels": {
"qqbot": {
"enabled": true,
"appId": "你的AppID",
"clientSecret": "你的AppSecret"
}
}
}
```
openclaw gateway