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-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查看完整帮助信息
方式二:源码安装升级
适合希望先查看仓库内容、在本地执行脚本,或希望更灵活控制安装流程的场景。 先拉取仓库: 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 关掉前台日志。 正常执行脚本到最后会输出日志:
方式三: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 成功加载。但并不能说明通道一定连上了。 QQBot 通道是否正常连通 执行以下命令查看通道状态: openclawchannelsstatus 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、百度等。