腾讯 QQ 机器人接入 OpenClaw，官方“养虾”指南发布

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

腾讯 QQ 机器人接入 OpenClaw，官方“养虾”指南发布 width=”1080″ height=”412″>

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

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

腾讯 QQ 机器人接入 OpenClaw，官方“养虾”指南发布 width=”1080″ height=”267″>

用户可以根据使用习惯，选择远程一键执行、本地脚本执行，或手动在原生 OpenClaw 环境中安装或升级 QQBot 插件。IT之家附各方法如下：

方式一：远程一键安装升级（推荐）

适合希望快速完成安装或升级的场景，无需手动 clone 仓库。

首次安装时，需提供 QQBot 通道凭证：
curl-fsSLhttps://raw.githubusercontent.com/tencent-connect/openclaw-qqbot/main/scripts/upgrade-via-npm.sh\|bash-s----appidYOUR_APPID--secretYOUR_SECRET
该命令会自动完成以下步骤：

下载安装脚本

清理旧插件

安装新插件

配置 QQBot 通道

启动或重启 OpenClaw 服务

完成后即可打开 QQ 开始使用。

如果此前已经完成过通道配置，后续升级可直接执行：
curl-fsSLhttps://raw.githubusercontent.com/tencent-connect/openclaw-qqbot/main/scripts/upgrade-via-npm.sh|bash
说明：如果想要升级 QQBot 官方插件版本，也可以执行该脚本，这个脚本是带升级能力的，而且默认行为是升级到 npm 上的 latest 版本。如果是想安装指定版本，后面可以跟–version 命令：
curl-fsSLhttps://raw.githubusercontent.com/tencent-connect/openclaw-qqbot/main/scripts/upgrade-via-npm.sh|bash-s----version1.5.7--appidYOUR_APPID--secretYOUR_SECRET
常用参数如下：

参数说明

–appid –secret 配置通道。首次安装必填，或在更换凭证时使用

–version 安装指定版本

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

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

参数	说明
–appid –secret	配置通道。首次安装必填，或在更换凭证时使用
–version	安装指定版本
–self-version	升级到当前仓库 package.json 里声明的版本
-h / –help	查看完整帮助信息

方式二：源码安装升级

适合希望先查看仓库内容、在本地执行脚本，或希望更灵活控制安装流程的场景。

先拉取仓库：
gitclonehttps://github.com/tencent-connect/openclaw-qqbot.gitcdopenclaw-qqbot
通过本地脚本进行源码安装或升级（该脚本同样具有升级到最新版本的能力）：
bash./scripts/upgrade-via-source.sh--appidYOUR_APPID--secretYOUR_SECRET
说明：脚本执行到后面会让选择是否后台重启 openclaw 网关服务？[Y/n]，一般选择 Y。如果后台启动正常，会执行 openclaw logs –follow 持续输出 OpenClaw 运行日志。后面看到有日志持续输出代表已经正常启动了，不代表还没升级完，可以 Ctrl+C 关掉前台日志。

正常执行脚本到最后会输出日志：

width=”1080″ height=”397″>

方式三：npm 方式手动安装升级

适合希望完全手动控制安装步骤，或需要排查安装问题的场景。

安装命令：

#（首次安装可跳过）卸载qqbot旧插件，卸载openclaw-qqbot旧版本插件openclawpluginsuninstallqqbotopenclawpluginsuninstallopenclaw-qqbot#安装openclaw-qqbot最新版本openclawpluginsinstall@tencent-connect/openclaw-qqbot@latest#配置通道（首次安装必做）openclawchannelsadd--channelqqbot--token"AppID:AppSecret"#启动/重启服务openclawgatewayrestart

已安装官方 openclaw-qqbot，升级版本命令：

#通过npm包升级（适用于之前插件本身就是通过可更新来源安装的情况：openclawpluginsinstall@tencent-connect/openclaw-qqbot）openclawpluginsupdateopenclaw-qqbot#启动/重启服务openclawgatewayrestart

安装结果检查

QQBot 插件是否正常加载

安装完成后，可通过以下命令检查插件是否已成功加载：
openclawpluginslist|grepopenclaw-qqbot
如果输出中存在对应插件条目，且状态为 loaded，说明 QQBot 插件已经安装好了，而且已经被 OpenClaw 成功加载。但并不能说明通道一定连上了。

width=”1080″ height=”86″>

QQBot 通道是否正常连通

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

width=”1080″ height=”601″>

这里的 in:2m ago, out:2m ago 说明：

in:2m ago：2 分钟前还有入站消息

out:2m ago：2 分钟前还有出站消息