OpenClaw 对接 QQ

安装插件

openclaw plugins install @sliverp/qqbot@latest

• 对应的插件地址:

https://github.com/sliverp/qqbot

创建QQ机器人

注册账号

• QQ机器人

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

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

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

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

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

• 第二步

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

在QQ机器人管理页面获取当前机器人的AppID和AppSecret，复制并将其保存到个人记事本或备忘录中（请注意数据安全，勿泄露），后续在“步骤3中配置OpenClaw“中需要使用。 注意：出于安全考虑，QQ机器人的AppSecret不支持明文保存，首次查看或忘记AppSecret需要重新生成。

• 最后结果

• 设置IP白名单，通过访问https://tool.hiofd.com/ip/，获取本地公网 IP：

填写到此处：

配置OpenClaw

通过配置文件配置，编辑 ~/.openclaw/openclaw.json:

{
  "channels": {
    "qqbot": {
      "enabled": true,
      "appId": "你的AppID",
      "clientSecret": "你的AppSecret"
    }
  }
}

• 启动与测试，启动gateway

openclaw gateway start

沙箱测试

在QQ机器人的“开发管理”页面，在“沙箱配置”中，设置单独聊天（选择“在消息列表配置”）。

注意

注意： 此处已创建的QQ机器人无需进行发布上架对所有QQ用户公开使用，在开发者私人的（沙箱）调试下使用体验即可。

添加成员

添加成员后，该成员使用QQ扫码来和机器人对话：

接着对话

• 沙盒环境下的对话演示：