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

shell 复制代码
安装最新版本,命令如下
openclaw plugins install @tencent-connect/openclaw-qqbot@latest

# 老的安装方式为:openclaw plugins install @sliverp/qqbot@latest


配置通道 也可以通过下面的openclaw.json配置文件配置
openclaw channels add --channel qqbot --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机器人支持多种消息类型:

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

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

相关推荐
MayBaymax5 小时前
Spring AI Alibaba Graph 实战:客服工单智能处理
java·ai·ai编程
sky_8106135 小时前
AI Agent 2026编程类客户端调研报告
人工智能·ai
海宇大数据5 小时前
零信任架构实战:基于海宇学历证书核验构建自动化教育资质网关
人工智能·ai·工具分享
代码方舟6 小时前
零信任架构实战:基于天远二手车VIN估值构建自动化车险承保网关
人工智能·ai·工具分享
liulilittle6 小时前
mock 规范总纲
ai·自动化·llm·mock·测试·tools
VIP_CQCRE7 小时前
把 Coze 接入 Ace Data Cloud:用 OpenAI Responses 协议快速扩展你的 AI Agent 模型能力
ai·大模型·agent·coze·acedatacloud
luteres7 小时前
大模型AI应用开发
ai
OxYGC7 小时前
[AI工程] Spring AI 第十四篇:Agent 五种模式在 2.0 里怎么写
java·spring·ai·ai编程
我是小邵8 小时前
长对话先收口:用“工作记忆 vs 长期记忆“管理 AI 上下文
人工智能·ai·llm·长期记忆·中间迷失·上下文收口
liulilittle8 小时前
麻将结算全链路语义(SETTLE_SEMANTICS)
ai·自动化·llm·mock·lua·测试