腾讯官宣：QQ机器人正式接入OpenClaw，三种配置方法附详细教程

腾讯技术工程官方近日发布重磅更新：QQ机器人开放平台已支持接入OpenClaw，同时同步推出了详尽的“养虾”指南，手把手教用户完成QQBot插件的安装、配置与升级，实现QQ与OpenClaw的互联互通。

先搞懂：接入前的核心前提

QQ机器人开放平台提供了快捷创建QQ机器人的通道，创建成功后，BOT会向用户QQ发送成功提示，头像、昵称可自定义编辑。但此时的BOT还没有“灵魂”——必须接入个人的OpenClaw运行环境，且在OpenClaw中安装配置QQBot插件，才能让QQ作为通讯渠道与OpenClaw正常通信。

三种安装升级方式，按需选择

用户可根据使用习惯、操作场景，选择远程一键执行、本地源码执行或手动npm安装，以下是详细步骤：

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

适合场景：想快速完成安装/升级，无需手动克隆仓库

1. 首次安装（需配置通道凭证）

执行以下命令，替换YOUR_APPID和YOUR_SECRET为实际凭证：

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使用。

2. 后续升级（已配置过通道）

curl -fsSL https://raw.githubusercontent.com/tencent-connect/openclaw-qqbot/main/scripts/upgrade-via-npm.sh | bash

3. 安装指定版本

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

常用参数说明

方式二：源码安装升级

适合场景：想查看仓库内容、灵活控制安装流程

1. 拉取仓库

git clone https://github.com/tencent-connect/openclaw-qqbot.git
cd openclaw-qqbot

2. 本地脚本安装/升级

bash ./scripts/upgrade-via-source.sh --appid YOUR_APPID --secret YOUR_SECRET

注意事项

• 脚本执行后期会提示“是否后台重启openclaw网关服务？[Y/n]”，建议选择Y；
• 后台启动后会自动输出运行日志，看到日志持续输出即代表启动正常，可按Ctrl+C关闭前台日志（不影响升级流程）。

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

适合场景：想完全手动控制步骤、排查安装问题

1. 首次安装

# （可选）卸载旧插件
openclaw plugins uninstall qqbot
openclaw plugins uninstall openclaw-qqbot

# 安装最新版本
openclaw plugins install @tencent-connect/openclaw-qqbot@latest

# 配置通道（必填）
openclaw channels add --channel qqbot --token "AppID:AppSecret"

# 启动/重启服务
openclaw gateway restart

2. 版本升级

# 升级插件版本
openclaw plugins update openclaw-qqbot

# 重启服务
openclaw gateway restart

安装结果检查：两步确认是否配置成功

1. 检查QQBot插件是否加载

执行命令：

openclaw plugins list | grep openclaw-qqbot

若输出包含对应插件条目，且状态为loaded，说明插件已成功加载（不代表通道连通）。

2. 检查QQBot通道是否连通

执行命令：

openclaw channels status

若QQ Bot通道显示为enabled, configured, running，且机器人能正常收发消息（in/out时间持续更新），则代表通道连通成功。

• in:2m ago：2分钟前有入站消息
• out:2m ago：2分钟前有出站消息

补充说明

1. QQBot插件仅作为消息通道，负责中转QQ与OpenClaw之间的消息，不直接提供图像理解、语音转录、绘图等功能；
2. 上述功能取决于用户配置的AI模型，以及OpenClaw内部已安装的技能；
3. 插件支持富媒体收发，可实现图片、语音、视频、文件的双向交互。