OpenClaw QQ 机器人插件安装 & 升级

通过 scripts/upgrade-plugin.sh 在 agent 内直接完成插件的安装或升级，无需用户在终端手动操作。

核心脚本

scripts/upgrade-plugin.sh — 通用插件安装/升级脚本。

用法: upgrade-plugin.sh [选项]

必填：
npm 包名，如 openclaw-qqbot
插件目录名，如 openclaw-qqbot

选项：
--version 指定版本（跳过 update，走 reinstall）
--no-restart 不重启 gateway（热更新场景）
--verify-files 逗号分隔的相对路径，验证这些文件存在
--legacy-dirs 逗号分隔的旧目录名，安装前清理

执行逻辑

1. 1. 策略判断：有安装记录 + 有目录 + 未指定版本 → plugins update（升级）；否则 → backup + plugins install --pin（全新安装）
2. 文件验证：读取 package.json 版本号，检查 --verify-files 指定的关键文件
3. postinstall：若存在 scripts/postinstall-link-sdk.js 自动执行
4. 重启：执行 gateway restart 使插件生效（--no-restart 跳过）

QQ 机器人插件（openclaw-qqbot）

安装或升级到最新版：
bash
bash /scripts/upgrade-plugin.sh \
openclaw-qqbot \
openclaw-qqbot \
--verify-files dist/index.js,dist/src/gateway.js,dist/src/api.js,dist/src/admin-resolver.js \
--legacy-dirs qqbot,openclaw-qq

安装或升级到指定版本：
bash
bash /scripts/upgrade-plugin.sh \
openclaw-qqbot \
openclaw-qqbot \
--version 1.2.3 \
--verify-files dist/index.js,dist/src/gateway.js,dist/src/api.js,dist/src/admin-resolver.js \
--legacy-dirs qqbot,openclaw-qq

= 本 skill 文件所在目录，即 SKILL.md 的 dirname。
执行前需用 exec 运行脚本，并将输出展示给用户。

执行后处理

脚本输出包含结构化行：

• - PLUGINNEWVERSION=1.2.3 → 新版本号
• PLUGIN_REPORT=✅ ... → 结果摘要（直接转发给用户）

若脚本退出码非 0，告知用户操作失败并粘贴输出，建议检查网络和 npm registry。

通用插件（非 qqbot）

bash
bash /scripts/upgrade-plugin.sh \
my-org/my-openclaw-plugin \
my-plugin-id