腾讯QQ机器人接入OpenClaw：官方养虾实践指南

首页

科技数码

热心网友

转载

2026-03-16

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 内部已安装的技能，而非本插件本身。