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

安装最新版本，命令如下 openclaw pluginsinstall@tencent-connect/openclaw-qqbot@latest# 老的安装方式为：openclaw plugins install @sliverp/qqbot@latest配置通道 也可以通过下面的openclaw.json配置文件配置 openclaw channelsadd--channelqqbot--token"AppID:AppSecret"启动 / 重启 openclaw gateway restart

通道配置（配置QQ机器人App ID和App Secret）

在"openclaw.json"配置文件中找到"Channel配置"，配置如下。

配置完后重启网关服务。

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

在QQ中与QQ机器人互动

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

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

支持的消息类型

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

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