IT 之家 3 月 16 日消息,腾讯技术工程官方今日宣布,QQ 机器人接入 OpenClaw,官方还同步发布了 " 养虾 " 指南。

据介绍,QQ 机器人开放平台提供了快捷创建 QQ 机器人的通道,用于接入 OpenClaw。机器人创建成功后,此时 BOT 会给用户 QQ 发一条成功消息,头像昵称可按喜好自定义编辑。
不过,机器人创建成功后,此时的 BOT 还没有 " 灵魂 ",需要接入到自己的 OpenClaw 运行环境。QQ 作为 OpenClaw 通讯渠道,需要在 OpenClaw 安装配置 QQBot 插件,才能与 QQBot 通信。QQ Bot 插件消息收发能力总览:

用户可以根据使用习惯,选择远程一键执行、本地脚本执行,或手动在原生 OpenClaw 环境中安装或升级 QQBot 插件。IT 之家附各方法如下:
方式一:远程一键安装升级(推荐)
适合希望快速完成安装或升级的场景,无需手动 clone 仓库。
首次安装时,需提供 QQBot 通道凭证:
curl -fsSL https://raw.githubusercontent.com/tencent-connect/openclaw-qqbot/main/scripts/upgrade-via-npm.sh | bash -s -- --appid YOUR_APPID --secret YOUR_SECRET
该命令会自动完成以下步骤:
下载安装脚本
清理旧插件
安装新插件
配置 QQBot 通道
启动或重启 OpenClaw 服务
完成后即可打开 QQ 开始使用。
如果此前已经完成过通道配置,后续升级可直接执行:
curl -fsSL https://raw.githubusercontent.com/tencent-connect/openclaw-qqbot/main/scripts/upgrade-via-npm.sh | bash
说明:如果想要升级 QQBot 官方插件版本,也可以执行该脚本,这个脚本是带升级能力的,而且默认行为是升级到 npm 上的 latest 版本。如果是想安装指定版本,后面可以跟 --version 命令:
curl -fsSL https://raw.githubusercontent.com/tencent-connect/openclaw-qqbot/main/scripts/upgrade-via-npm.sh | bash -s -- --version 1.5.7 --appid YOUR_APPID --secret YOUR_SECRET
常用参数如下:
方式二:源码安装升级参数 说明 --appid --secret 配置通道。首次安装必填,或在更换凭证时使用 --version 安装指定版本 --self-version 升级到当前仓库 package.json 里声明的版本 -h / --help 查看完整帮助信息
适合希望先查看仓库内容、在本地执行脚本,或希望更灵活控制安装流程的场景。
先拉取仓库:
git clone https://github.com/tencent-connect/openclaw-qqbot.gitcd openclaw-qqbot
通过本地脚本进行源码安装或升级(该脚本同样具有升级到最新版本的能力):
bash ./scripts/upgrade-via-source.sh --appid YOUR_APPID --secret YOUR_SECRET
说明:脚本执行到后面会让选择是否后台重启 openclaw 网关服务? [ Y/n ] ,一般选择 Y。如果后台启动正常,会执行 openclaw logs --follow 持续输出 OpenClaw 运行日志。后面看到有日志持续输出代表已经正常启动了,不代表还没升级完,可以 Ctrl+C 关掉前台日志。
正常执行脚本到最后会输出日志:

方式三:npm 方式手动安装升级
适合希望完全手动控制安装步骤,或需要排查安装问题的场景。
安装命令:
# (首次安装可跳过)卸载 qqbot 旧插件,卸载 openclaw-qqbot 旧版本插件 openclaw plugins uninstall qqbotopenclaw plugins uninstall openclaw-qqbot# 安装 openclaw-qqbot 最新版本 openclaw plugins install @tencent-connect/openclaw-qqbot@latest# 配置通道(首次安装必做)openclaw channels add --channel qqbot --token "AppID:AppSecret"# 启动 / 重启服务 openclaw gateway restart
已安装官方 openclaw-qqbot,升级版本命令:
# 通过 npm 包升级(适用于之前插件本身就是通过可更新来源安装的情况:openclaw plugins install @tencent-connect/openclaw-qqbot)openclaw plugins update openclaw-qqbot# 启动 / 重启服务 openclaw gateway restart
安装结果检查
QQBot 插件是否正常加载
安装完成后,可通过以下命令检查插件是否已成功加载:
openclaw plugins list | grep openclaw-qqbot
如果输出中存在对应插件条目,且状态为 loaded,说明 QQBot 插件已经安装好了,而且已经被 OpenClaw 成功加载。但并不能说明通道一定连上了。

QQBot 通道是否正常连通
执行以下命令查看通道状态:
openclaw channels status
openclaw channels status 中 QQ Bot 通道显示为 enabled, configured, running,且机器人实际可以正常收发消息或 in / out 时间持续更新时,可认为 QQBot 通道已正常连通。

这里的 in:2m ago, out:2m ago 说明:
in:2m ago:2 分钟前还有入站消息
out:2m ago:2 分钟前还有出站消息
腾讯技术工程官方表示,OpenClaw QQBot 插件提供了富媒体收发支持,覆盖图片、语音、视频、文件的双向交互。除了接收日常的文本消息以外,QQBot 通道还支持接收多种媒体消息。
需要注意的是,QQ Bot 插件仅作为消息通道使用 —— 负责在 QQ 与 OpenClaw 之间中转消息。诸如图像理解、语音转录、绘图等功能,取决于用户所配置的 AI 模型以及 OpenClaw 内部已安装的技能,而非本插件本身。

另据 IT 之家昨日报道,GitHub 平台 Sponsor 页面显示,腾讯轻量云已成为 OpenClaw" 小龙虾 " 社区赞助商,目前位列赞助名单的国内外大厂还有 OpenAI、百度等。



登录后才可以发布评论哦
打开小程序可以发布评论哦