腾讯技术工程官方宣布，QQ 机器人接入 OpenClaw

腾讯技术工程官方宣布，QQ 机器人接入 OpenClaw，官方还同步发布了“养虾”指南。

据介绍，QQ 机器人开放平台提供了快捷创建 QQ 机器人的通道，用于接入 OpenClaw。机器人创建成功后，此时 BOT 会给用户 QQ 发一条成功消息，头像昵称可按喜好自定义编辑。

不过，机器人创建成功后，此时的 BOT 还没有“灵魂”，需要接入到自己的 OpenClaw 运行环境。QQ 作为 OpenClaw 通讯渠道，需要在 OpenClaw 安装配置 QQBot 插件，才能与 QQBot 通信。QQ Bot 插件消息收发能力总览：

腾讯技术工程官方宣布，QQ 机器人接入 OpenClaw

用户可以根据使用习惯，选择远程一键执行、本地脚本执行，或手动在原生 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 <id> –secret <secret> 配置通道。首次安装必填，或在更换凭证时使用

–version <版本号> 安装指定版本

–self-version 升级到当前仓库 package.json 里声明的版本

-h / –help 查看完整帮助信息

参数	说明
–appid <id> –secret <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 分钟前还有出站消息