乐于分享
好东西不私藏

OpenClaw快速接入QQ指南

OpenClaw快速接入QQ指南

注册QQ开放平台


前往腾讯QQ开放平台官网,您可以用手机QQ扫描图中二维码进行注册/登录。
在手机QQ扫码后选择同意,即完成注册,进入QQ机器人配置页。

创建一个QQBot机器人


在QQ开放平台的QQ机器人页面,可以单击创建机器人,即可直接新建一个QQ机器人。
机器人创建完成后,在页面中找到 “AppID” 和 “AppSecret” 两个参数,将其保存到个人记事本或备忘录中(请妥善保存勿泄露,注意数据安全),后续步骤中需要使用。
回到QQ软件,可以看到新建的QQ机器人已经被添加至您的消息列表中,并将会发送第一条消息,证明机器人成功创建了。

OpenClaw端配置


  1. 安装QQ机器人插件

    openclaw plugins install @openclaw/qqbot

  2. 填入之前机器人的AppID和Token

    openclaw config set qqbot.appId "1024xxxxxx"
    openclaw config set qqbot.token "XXXXXXXXXX"

  3. 设置回调地址

    openclaw config set qqbot.callbackUrl "http://你的IP:3000/webhooks/qqbot"
  4. 重启服务

    openclaw restart

QQ开放平台配置回调


回到QQ开放平台 → 开发设置

填写回调URL:`http://你的IP:3000/webhooks/qqbot`
添加IP白名单(你的服务器公网IP)
点击"验证连通性"

开始对话测试


手机QQ搜索你的机器人名称
进入私聊,发送:"你好"
机器人应在3秒内回复
恭喜你! QQ机器人已跑通。