乐于分享
好东西不私藏

OpenClaw快速接入QQ教程

OpenClaw快速接入QQ教程

OpenClaw是一个强大的开源AI Agent,支持通过多种聊天软件进行交互。下面将详细介绍如何在OpenClaw中接入QQ,实现QQ与AI的对话操作。

前置准备工作

在开始配置之前,请确保完成以下准备工作:

  • QQ账号
  • 部署好OpenClaw,可以看我另一篇博文有介绍如何安装。

接入QQ

注册QQ开放平台

首先需要注册QQ开放平台账号。访问QQ开放平台官网,使用手机QQ扫描页面上的二维码进行注册或登录。

QQ开放平台访问地址:https://q.qq.com/qqbot/openclaw/login.html

如果是首次使用,扫码后会自动完成注册流程,并将扫码的QQ账号与平台账号绑定。

在手机QQ扫码后选择同意,即可进入QQ机器人配置页面。

创建QQBot机器人

在QQ开放平台的QQ机器人页面,点击”创建机器人”按钮,即可新建一个QQ机器人。

机器人创建完成后,在页面中找到”AppID”和”AppSecret”两个参数。这两个参数非常重要,请务必点击右侧的”复制”按钮,将其保存到记事本或备忘录中。后续配置步骤需要使用这些信息。

重要提醒:

  • AppSecret 出于安全考虑不支持明文保存
  • 二次查看将会强制重置,建议保存好
  • 请妥善保管,避免泄露

创建机器人后,回到QQ软件,会看到新建的QQ机器人已被添加到消息列表中,并发送第一条消息。此时与机器人对话会提示”该机器人去火星了,稍后再试吧”,这是因为QQ机器人尚未与OpenClaw应用打通,需要做如下的操作。

安装QQ机器人插件

官方插件地址:https://github.com/tencent-connect/openclaw-qqbot

  1. 安装最新版本,命令如下
  2. openclaw plugins install @tencent-connect/openclaw-qqbot@latest
  3. # 老的安装方式为:openclaw plugins install @sliverp/qqbot@latest
  4. 配置通道也可以通过下面的openclaw.json配置文件配置
  5. openclaw channels add --channel qqbot --token "AppID:AppSecret"
  6. 启动/重启
  7. openclaw gateway restart

通道配置(配置QQ机器人App ID和App Secret)

在”openclaw.json”配置文件中找到”Channel配置”,配置如下。

配置完后重启网关服务。

说明: OpenClaw支持同一台服务器配置多个通道。如当前服务器已经接入了其他通道(如飞书机器人),可以继续添加更多通道。

在QQ中与QQ机器人互动

完成通道配置后,就可以在手机QQ或电脑版QQ上与已接入OpenClaw的QQ机器人进行聊天了。如果机器人能够以AI的方式对话,说明配置成功。

与QQ机器人聊天会产生一个专门的会话session

支持的消息类型

将OpenClaw接入QQ后,QQ机器人支持多种消息类型:

消息类型
是否支持
接收文本信息
已支持
接收图片
已支持
接收文件
已支持
回复文本信息
已支持
回复图片
已支持
回复内容支持 Markdown 格式
已支持
主动发送消息(如定时发送提醒)
已支持
语音消息
已支持
回复文件
已支持
历史消息引用
不支持

参考地址:https://cloud.tencent.com/developer/article/2626045