@ryantest/openclaw-qqbot 0.0.3 → 1.6.6-alpha.0

package/scripts/upgrade-via-npm.sh

@@ -1,24 +1,30 @@
 #!/bin/bash
 
-# qqbot 通过 npm 包升级（纯文件操作版本）
+# qqbot 通过 openclaw 原生插件指令升级
 #
-# 默认只做文件替换，不修改 openclaw.json 配置文件。
-# 但如果提供了 --appid/--secret 参数（首次安装场景），
-# 则在文件安装完成后自动写入通道配置。
+# 使用 openclaw plugins install/update 原生命令进行安装和升级，
+# 保留 appid/secret 配置写入、热更新 (--no-restart)、结构化输出等功能。
+#
+# 升级策略：
+#   1. 已安装（plugins.installs 有记录）→ openclaw plugins update
+#   2. 未安装 / update 失败 → 删除旧目录 + openclaw plugins install
 #
 # 用法:
 #   upgrade-via-npm.sh                                    # 升级到 latest（默认）
 #   upgrade-via-npm.sh --version <version>                # 升级到指定版本
 #   upgrade-via-npm.sh --self-version                     # 升级到当前仓库 package.json 版本
 #   upgrade-via-npm.sh --appid <appid> --secret <secret>  # 首次安装时配置 appid/secret
-#   upgrade-via-npm.sh --no-restart                        # 只做文件替换，不重启 gateway（供热更指令使用）
+#   upgrade-via-npm.sh --no-restart                       # 只做文件替换，不重启 gateway（供热更指令使用）
 
 set -eo pipefail
 
 PKG_NAME="@tencent-connect/openclaw-qqbot"
+PLUGIN_ID="openclaw-qqbot"
 INSTALL_SRC=""
+TARGET_VERSION=""
 APPID=""
 SECRET=""
+STREAMING=""
 NO_RESTART=false
 SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
 PROJECT_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"
@@ -45,6 +51,7 @@ print_usage() {
     echo ""
     echo "  --appid <appid>       QQ机器人 appid（首次安装时必填）"
     echo "  --secret <secret>     QQ机器人 secret（首次安装时必填）"
+    echo "  --streaming <yes|no>  是否启用流式消息（默认: no，仅 C2C 私聊）"
     echo ""
     echo "也可以通过环境变量设置:"
     echo "  QQBOT_APPID           QQ机器人 appid"
@@ -56,16 +63,19 @@ while [[ $# -gt 0 ]]; do
     case "$1" in
         --tag)
             [ -z "$2" ] && echo "❌ --tag 需要参数" && exit 1
+            TARGET_VERSION="$2"
             INSTALL_SRC="${PKG_NAME}@$2"
             shift 2
             ;;
         --version)
             [ -z "$2" ] && echo "❌ --version 需要参数" && exit 1
+            TARGET_VERSION="$2"
             INSTALL_SRC="${PKG_NAME}@$2"
             shift 2
             ;;
         --self-version)
             [ -z "$LOCAL_VERSION" ] && echo "❌ 无法从 package.json 读取版本" && exit 1
+            TARGET_VERSION="$LOCAL_VERSION"
             INSTALL_SRC="${PKG_NAME}@${LOCAL_VERSION}"
             shift 1
             ;;
@@ -79,6 +89,11 @@ while [[ $# -gt 0 ]]; do
             SECRET="$2"
             shift 2
             ;;
+        --streaming)
+            [ -z "$2" ] && echo "❌ --streaming 需要参数" && exit 1
+            STREAMING="$2"
+            shift 2
+            ;;
         --no-restart)
             NO_RESTART=true
             shift 1
@@ -100,7 +115,7 @@ if [ -z "$APPID" ] && [ -z "$SECRET" ] && [ -n "$QQBOT_TOKEN" ]; then
     SECRET="${QQBOT_TOKEN#*:}"
 fi
 
-# 检测 CLI（仅用于确定 extensions 目录路径）
+# 检测 CLI
 CMD=""
 for name in openclaw clawdbot moltbot; do
     command -v "$name" &>/dev/null && CMD="$name" && break
@@ -109,113 +124,267 @@ done
 
 EXTENSIONS_DIR="$HOME/.$CMD/extensions"
 
+# 检测 openclaw 版本
+OPENCLAW_VERSION="$($CMD --version 2>/dev/null | grep -oE '[0-9]+\.[0-9]+(\.[0-9]+)?' | head -1 || true)"
+
 echo "==========================================="
-echo "  qqbot npm 升级: $INSTALL_SRC"
+echo "  qqbot 升级: $INSTALL_SRC"
+echo "  openclaw 版本: ${OPENCLAW_VERSION:-unknown}"
 echo "==========================================="
 echo ""
 
-# [1/3] 下载并安装新版本到临时目录
-echo "[1/3] 下载新版本..."
-TMPDIR_PACK=$(mktemp -d)
-EXTRACT_DIR=$(mktemp -d)
-trap "rm -rf '$TMPDIR_PACK' '$EXTRACT_DIR'" EXIT
-
-cd "$TMPDIR_PACK"
-# 多 registry fallback：npmjs.org → npmmirror（国内镜像）→ 默认 registry
-PACK_OK=false
-for _registry in "https://registry.npmjs.org/" "https://registry.npmmirror.com/" ""; do
-    if [ -n "$_registry" ]; then
-        echo "  尝试 registry: $_registry"
-        npm pack "$INSTALL_SRC" --registry "$_registry" --quiet 2>&1 && PACK_OK=true && break
-    else
-        echo "  尝试默认 registry..."
-        npm pack "$INSTALL_SRC" --quiet 2>&1 && PACK_OK=true && break
+# 记录升级前的版本
+OLD_VERSION=""
+OLD_PKG="$EXTENSIONS_DIR/$PLUGIN_ID/package.json"
+if [ -f "$OLD_PKG" ]; then
+    OLD_VERSION="$(node -e "
+      try {
+        const v = JSON.parse(require('fs').readFileSync('$OLD_PKG', 'utf8')).version;
+        if (v) process.stdout.write(String(v));
+      } catch {}
+    " 2>/dev/null || true)"
+    echo "  当前版本: ${OLD_VERSION:-unknown}"
+fi
+
+# [1/4] 通过 openclaw 原生指令安装/升级
+echo ""
+echo "[1/4] 安装/升级插件..."
+
+# ── 兼容 openclaw 3.23+ 配置严格校验 ──
+# 3.23+ 在 plugins install/update 时会校验整个配置文件，
+# 如果 channels.qqbot 已存在但 qqbot 插件尚未加载，校验会失败。
+# 解决：install/update 前临时移除 channels.qqbot，成功后恢复。
+CONFIG_FILE="$HOME/.$CMD/$CMD.json"
+QQBOT_CHANNEL_BACKUP=""
+if [ -f "$CONFIG_FILE" ]; then
+    QQBOT_CHANNEL_BACKUP="$(node -e "
+      try {
+        const fs = require('fs');
+        const cfg = JSON.parse(fs.readFileSync('$CONFIG_FILE', 'utf8'));
+        if (cfg.channels && cfg.channels.qqbot) {
+          process.stdout.write(JSON.stringify(cfg.channels.qqbot));
+          delete cfg.channels.qqbot;
+          if (Object.keys(cfg.channels).length === 0) delete cfg.channels;
+          fs.writeFileSync('$CONFIG_FILE', JSON.stringify(cfg, null, 4) + '\n');
+        }
+      } catch {}
+    " 2>/dev/null || true)"
+    if [ -n "$QQBOT_CHANNEL_BACKUP" ]; then
+        echo "  [兼容] 临时移除 channels.qqbot 以通过配置校验"
     fi
-done
-$PACK_OK || { echo "❌ npm pack 失败（所有 registry 均不可用）"; exit 1; }
-TGZ_FILE=$(ls -1 *.tgz 2>/dev/null | head -1)
-[ -z "$TGZ_FILE" ] && echo "❌ 未找到下载的 tgz 文件" && exit 1
-echo "  已下载: $TGZ_FILE"
-
-tar xzf "$TGZ_FILE" -C "$EXTRACT_DIR"
-PACKAGE_DIR="$EXTRACT_DIR/package"
-[ ! -d "$PACKAGE_DIR" ] && echo "❌ 解压失败，未找到 package 目录" && exit 1
-
-# 准备 staging 目录：放在 ~/.openclaw/ 下（extensions 的父目录），
-# 同一文件系统保证 mv 原子操作，同时避免 OpenClaw 扫描 extensions/ 时发现它。
-STAGING_DIR="$(dirname "$EXTENSIONS_DIR")/.qqbot-upgrade-staging"
-rm -rf "$STAGING_DIR"
-mkdir -p "$STAGING_DIR"
-cp -R "$PACKAGE_DIR/"* "$STAGING_DIR/"
-
-# 依赖处理：所有 production dependencies 都声明为 bundledDependencies，
-# npm pack 时已打包进 tgz，解压后 node_modules/ 已包含全部依赖，无需 npm install。
-# 注意：不能执行 npm install，否则会安装 peerDependencies（openclaw 平台及其 400+ 传递依赖），
-# 导致插件目录膨胀到 900MB+，而这些依赖在运行时由宿主 openclaw 提供。
-if [ -d "$STAGING_DIR/node_modules" ]; then
-    BUNDLED_COUNT=$(ls -d "$STAGING_DIR/node_modules"/*/ "$STAGING_DIR/node_modules"/@*/*/ 2>/dev/null | wc -l | tr -d ' ')
-    echo "  bundled 依赖已就绪（${BUNDLED_COUNT} 个包）"
+fi
+
+# 恢复 channels.qqbot 的函数（install/update 完成后调用）
+restore_qqbot_channel() {
+    if [ -n "$QQBOT_CHANNEL_BACKUP" ] && [ -f "$CONFIG_FILE" ]; then
+        node -e "
+          try {
+            const fs = require('fs');
+            const cfg = JSON.parse(fs.readFileSync('$CONFIG_FILE', 'utf8'));
+            if (!cfg.channels) cfg.channels = {};
+            cfg.channels.qqbot = $QQBOT_CHANNEL_BACKUP;
+            fs.writeFileSync('$CONFIG_FILE', JSON.stringify(cfg, null, 4) + '\n');
+          } catch {}
+        " 2>/dev/null || true
+        echo "  [兼容] 已恢复 channels.qqbot 配置"
+    fi
+}
+
+UPGRADE_OK=false
+
+# 检测安装状态：同时检查配置记录和磁盘目录
+HAS_INSTALL_RECORD="$(node -e "
+  try {
+    const fs = require('fs');
+    const p = '$HOME/.$CMD/$CMD.json';
+    const cfg = JSON.parse(fs.readFileSync(p, 'utf8'));
+    const inst = cfg.plugins && cfg.plugins.installs && cfg.plugins.installs['$PLUGIN_ID'];
+    if (inst) process.stdout.write('yes');
+  } catch {}
+" 2>/dev/null || true)"
+HAS_PLUGIN_DIR=false
+[ -d "$EXTENSIONS_DIR/$PLUGIN_ID" ] && [ -f "$EXTENSIONS_DIR/$PLUGIN_ID/package.json" ] && HAS_PLUGIN_DIR=true
+
+# 决策矩阵：
+#   配置有记录 + 目录存在 → update（最佳路径）
+#   配置有记录 + 目录不存在 → 清理残留记录，走 install
+#   配置无记录 + 目录存在 → 删目录，走 install（配置与文件不一致）
+#   配置无记录 + 目录不存在 → 走 install（全新安装）
+#
+# 指定了具体版本（--version/--tag/--self-version）时：
+#   update 不支持指定版本，直接走 删除 + install
+
+USE_UPDATE=false
+
+if [ "$HAS_INSTALL_RECORD" = "yes" ] && [ "$HAS_PLUGIN_DIR" = "true" ] && [ -z "$TARGET_VERSION" ]; then
+    # 配置和目录都齐全，且未指定版本 → 走 update
+    USE_UPDATE=true
+    echo "  [检测] 配置记录 ✓ | 插件目录 ✓ | 未指定版本 → 使用 update"
+elif [ "$HAS_INSTALL_RECORD" = "yes" ] && [ "$HAS_PLUGIN_DIR" = "true" ]; then
+    echo "  [检测] 配置记录 ✓ | 插件目录 ✓ | 指定版本 $TARGET_VERSION → 使用 reinstall"
+elif [ "$HAS_INSTALL_RECORD" = "yes" ]; then
+    echo "  [检测] 配置记录 ✓ | 插件目录 ✗ → 配置与文件不一致，使用 install"
+elif [ "$HAS_PLUGIN_DIR" = "true" ]; then
+    echo "  [检测] 配置记录 ✗ | 插件目录 ✓ → 目录残留，清理后 install"
 else
-    echo "  ⚠️  未找到 bundled node_modules，尝试安装依赖..."
-    NPM_TMP_CACHE=$(mktemp -d)
-    (cd "$STAGING_DIR" && npm install --omit=dev --omit=peer --ignore-scripts --cache="$NPM_TMP_CACHE" --quiet 2>&1) || echo "  ⚠️  依赖安装失败"
-    rm -rf "$NPM_TMP_CACHE"
+    echo "  [检测] 配置记录 ✗ | 插件目录 ✗ → 全新安装"
 fi
 
-# 清理下载临时文件
-rm -rf "$TMPDIR_PACK" "$EXTRACT_DIR"
-cd "$HOME"
+if [ "$USE_UPDATE" = "true" ]; then
+    echo "  尝试 update..."
+    if $CMD plugins update "$PLUGIN_ID" 2>&1; then
+        UPGRADE_OK=true
+        echo "  ✅ update 成功"
+    else
+        echo "  ⚠️  update 失败，回退到 reinstall..."
+    fi
+fi
+
+if [ "$UPGRADE_OK" != "true" ]; then
+    # 备份旧目录（而非直接删除），install 失败时可回滚
+    BACKUP_DIR=""
+    if [ -d "$EXTENSIONS_DIR/$PLUGIN_ID" ]; then
+        BACKUP_DIR="$EXTENSIONS_DIR/.openclaw-qqbot-backup-$$"
+        mv "$EXTENSIONS_DIR/$PLUGIN_ID" "$BACKUP_DIR"
+        echo "  已备份旧目录: $BACKUP_DIR"
+    fi
 
-# [2/3] 原子替换：使用 mv -T/rename 确保目录切换尽可能原子
-# 策略：先把 staging 放到 extensions/ 同级的临时名，再做单次 mv 替换
+    # 清理历史遗留名称（这些不需要回滚）
+    for dir_name in qqbot openclaw-qq; do
+        [ -d "$EXTENSIONS_DIR/$dir_name" ] && rm -rf "$EXTENSIONS_DIR/$dir_name" && echo "  已清理历史目录: $EXTENSIONS_DIR/$dir_name"
+    done
+
+    echo "  执行 install: $INSTALL_SRC"
+    if $CMD plugins install "$INSTALL_SRC" --pin 2>&1; then
+        UPGRADE_OK=true
+        echo "  ✅ install 成功"
+        # install 成功，清理备份
+        if [ -n "$BACKUP_DIR" ] && [ -d "$BACKUP_DIR" ]; then
+            rm -rf "$BACKUP_DIR"
+            echo "  已清理旧版备份"
+        fi
+        # 清理 openclaw CLI install 可能留下的额外 backup 目录
+        find "$EXTENSIONS_DIR" -maxdepth 1 -name ".openclaw-qqbot-backup-*" -exec rm -rf {} + 2>/dev/null || true
+    else
+        echo "  ❌ install 失败"
+        # 回滚：恢复旧目录
+        if [ -n "$BACKUP_DIR" ] && [ -d "$BACKUP_DIR" ]; then
+            mv "$BACKUP_DIR" "$EXTENSIONS_DIR/$PLUGIN_ID"
+            echo "  ↩️  已回滚到旧版本"
+        fi
+        restore_qqbot_channel
+        echo "QQBOT_NEW_VERSION=unknown"
+        echo "QQBOT_REPORT=❌ QQBot 安装失败（已回滚到旧版本），请检查网络和 npm registry"
+        exit 1
+    fi
+fi
+
+# install/update 完成，恢复 channels.qqbot
+restore_qqbot_channel
+
+# [2/4] 验证安装
 echo ""
-echo "[2/3] 原子替换插件目录..."
-TARGET_DIR="$EXTENSIONS_DIR/openclaw-qqbot"
-OLD_DIR="$(dirname "$EXTENSIONS_DIR")/.qqbot-upgrade-old"
+echo "[2/4] 验证安装..."
 
-rm -rf "$OLD_DIR"
+PKG_JSON="$EXTENSIONS_DIR/$PLUGIN_ID/package.json"
+if [ -f "$PKG_JSON" ]; then
+  NEW_VERSION="$(node -e "process.stdout.write(JSON.parse(require('fs').readFileSync(process.argv[1],'utf8')).version||'')" "$PKG_JSON" 2>/dev/null || true)"
+fi
 
-# 先把 staging 目录移到 extensions/ 下的临时位置（同文件系统，确保 mv 是 rename 操作）
-STAGING_IN_EXT="$EXTENSIONS_DIR/.openclaw-qqbot-new"
-rm -rf "$STAGING_IN_EXT"
-mv "$STAGING_DIR" "$STAGING_IN_EXT"
+# Preflight 检查
+PREFLIGHT_OK=true
+TARGET_DIR="$EXTENSIONS_DIR/$PLUGIN_ID"
 
-if [ -d "$TARGET_DIR" ]; then
-    # 使用连续两个 mv 但中间零操作，最小化目录不存在的时间窗口
-    mv "$TARGET_DIR" "$OLD_DIR" && mv "$STAGING_IN_EXT" "$TARGET_DIR"
+if [ -z "$NEW_VERSION" ]; then
+    echo "  ❌ 无法读取新版本号"
+    PREFLIGHT_OK=false
 else
-    mv "$STAGING_IN_EXT" "$TARGET_DIR"
+    echo "  ✅ 版本号: $NEW_VERSION"
 fi
-rm -rf "$OLD_DIR"
 
-# 清理可能残留的旧版 staging 目录（extensions 内外都清理）
-rm -rf "$EXTENSIONS_DIR/openclaw-qqbot.staging"
-rm -rf "$EXTENSIONS_DIR/.qqbot-upgrade-staging"
-rm -rf "$EXTENSIONS_DIR/.qqbot-upgrade-old"
+# 入口文件
+ENTRY_FILE=""
+for candidate in "dist/index.js" "index.js"; do
+    if [ -f "$TARGET_DIR/$candidate" ]; then
+        ENTRY_FILE="$candidate"
+        break
+    fi
+done
+if [ -z "$ENTRY_FILE" ]; then
+    echo "  ❌ 缺少入口文件（dist/index.js 或 index.js）"
+    PREFLIGHT_OK=false
+else
+    echo "  ✅ 入口文件: $ENTRY_FILE"
+fi
 
-# 同时清理历史遗留的其他目录名
-for dir_name in qqbot openclaw-qq; do
-    [ -d "$EXTENSIONS_DIR/$dir_name" ] && rm -rf "$EXTENSIONS_DIR/$dir_name"
+# 核心目录
+if [ -d "$TARGET_DIR/dist/src" ]; then
+    CORE_JS_COUNT=$(find "$TARGET_DIR/dist/src" -name "*.js" -type f 2>/dev/null | wc -l | tr -d ' ')
+    echo "  ✅ dist/src/ 包含 ${CORE_JS_COUNT} 个 JS 文件"
+    if [ "$CORE_JS_COUNT" -lt 5 ]; then
+        echo "  ❌ JS 文件数量异常偏少（预期 ≥ 5，实际 ${CORE_JS_COUNT}）"
+        PREFLIGHT_OK=false
+    fi
+else
+    echo "  ❌ 缺少核心目录 dist/src/"
+    PREFLIGHT_OK=false
+fi
+
+# 关键模块
+MISSING_MODULES=""
+for module in "dist/src/gateway.js" "dist/src/api.js" "dist/src/admin-resolver.js"; do
+    if [ ! -f "$TARGET_DIR/$module" ]; then
+        MISSING_MODULES="$MISSING_MODULES $module"
+    fi
 done
-echo "  已安装到: $TARGET_DIR"
+if [ -n "$MISSING_MODULES" ]; then
+    echo "  ❌ 缺少关键模块:$MISSING_MODULES"
+    PREFLIGHT_OK=false
+else
+    echo "  ✅ 关键模块完整"
+fi
+
+# bundled 依赖
+if [ -d "$TARGET_DIR/node_modules" ]; then
+    BUNDLED_OK=true
+    for dep in "ws" "silk-wasm"; do
+        if [ ! -d "$TARGET_DIR/node_modules/$dep" ]; then
+            echo "  ⚠️  bundled 依赖缺失: $dep"
+            BUNDLED_OK=false
+        fi
+    done
+    if $BUNDLED_OK; then
+        echo "  ✅ 核心 bundled 依赖完整"
+    fi
+fi
+
+if [ "$PREFLIGHT_OK" != "true" ]; then
+    echo ""
+    echo "❌ 验证未通过"
+    echo "QQBOT_NEW_VERSION=unknown"
+    echo "QQBOT_REPORT=⚠️ QQBot 升级异常，验证未通过"
+    exit 1
+fi
+echo "  ✅ 验证全部通过"
+
+# 确保 openclaw/plugin-sdk 可解析：
+# openclaw plugins install 不会执行 npm lifecycle scripts，
+# 需要手动调用 postinstall-link-sdk.js 创建 node_modules/openclaw → 全局 openclaw 的符号链接
+POSTINSTALL_SCRIPT="$TARGET_DIR/scripts/postinstall-link-sdk.js"
+if [ -f "$POSTINSTALL_SCRIPT" ]; then
+    echo "  执行 postinstall-link-sdk..."
+    if node "$POSTINSTALL_SCRIPT" 2>&1; then
+        echo "  ✅ plugin-sdk 链接就绪"
+    else
+        echo "  ⚠️  postinstall-link-sdk 失败，插件可能无法加载"
+    fi
+fi
 
-# [3/3] 输出新版本号和升级报告（供调用方解析）
+# [3/4] 输出结构化信息（供 TS handler 解析）
 echo ""
-echo "[3/3] 验证安装..."
-NEW_VERSION="$(node -e "
-  try {
-    const fs = require('fs');
-    const path = require('path');
-    const p = path.join('$EXTENSIONS_DIR', 'openclaw-qqbot', 'package.json');
-    if (fs.existsSync(p)) {
-      const v = JSON.parse(fs.readFileSync(p, 'utf8')).version;
-      if (v) { process.stdout.write(v); process.exit(0); }
-    }
-  } catch {}
-" 2>/dev/null || true)"
+echo "[3/4] 升级结果..."
 echo "QQBOT_NEW_VERSION=${NEW_VERSION:-unknown}"
 
-# 输出结构化升级报告（QQBOT_REPORT=...），供 TS handler 解析后直接回复用户
 if [ -n "$NEW_VERSION" ] && [ "$NEW_VERSION" != "unknown" ]; then
     echo "QQBOT_REPORT=✅ QQBot 升级完成: v${NEW_VERSION}"
 else
@@ -224,13 +393,10 @@ fi
 
 echo ""
 echo "==========================================="
-echo "  ✅ 文件安装完成"
+echo "  ✅ 安装完成"
 echo "==========================================="
 
-# --no-restart 模式（热更新场景）：文件替换完成后立即退出，
-# 让调用方尽快触发 gateway restart，避免 openclaw 配置轮询
-# 在旧进程中检测到插件变更产生 "plugin not found" warning 刷屏。
-# appid/secret 配置在热更新场景下已经存在，无需重新写入。
+# --no-restart 模式（热更新场景）：立即退出，让调用方触发 gateway restart
 if [ "$NO_RESTART" = "true" ]; then
     echo ""
     echo "[跳过重启] --no-restart 已指定，脚本立即退出以便调用方触发 gateway restart"
@@ -239,7 +405,7 @@ fi
 
 # 以下步骤仅在非热更新（手动执行）场景中执行
 
-# [4/4] 配置 appid/secret（仅在提供了参数时执行）
+# [配置] appid/secret（仅在提供了参数时执行）
 if [ -n "$APPID" ] && [ -n "$SECRET" ]; then
     echo ""
     echo "[配置] 写入 qqbot 通道配置..."
@@ -266,10 +432,9 @@ if [ -n "$APPID" ] && [ -n "$SECRET" ]; then
 
     if [ "$CURRENT_TOKEN" = "$DESIRED_TOKEN" ]; then
         echo "  ✅ 当前配置已是目标值，跳过写入"
-    elif $CMD channels add --channel qqbot --token "$DESIRED_TOKEN" 2>&1; then
-        echo "  ✅ 通道配置写入成功"
     else
-        echo "  ⚠️  $CMD channels add 失败，尝试直接编辑配置文件..."
+        # qqbot 是插件自定义通道，openclaw channels add --channel 不支持，
+        # 直接编辑配置文件写入 channels.qqbot
         CONFIG_FILE="$HOME/.$CMD/$CMD.json"
         if [ -f "$CONFIG_FILE" ] && node -e "
             const fs = require('fs');
@@ -280,10 +445,10 @@ if [ -n "$APPID" ] && [ -n "$SECRET" ]; then
             cfg.channels.qqbot.clientSecret = '$SECRET';
             fs.writeFileSync('$CONFIG_FILE', JSON.stringify(cfg, null, 4) + '\n');
         " 2>&1; then
-            echo "  ✅ 通道配置写入成功（直接编辑配置文件）"
+            echo "  ✅ 通道配置写入成功"
         else
-            echo "  ❌ 配置写入失败，请手动配置:"
-            echo "     $CMD channels add --channel qqbot --token \"${APPID}:${SECRET}\""
+            echo "  ❌ 配置写入失败，请手动编辑 $CONFIG_FILE 添加 channels.qqbot:"
+            echo "     { \"channels\": { \"qqbot\": { \"appId\": \"$APPID\", \"clientSecret\": \"...\" } } }"
         fi
     fi
 elif [ -n "$APPID" ] || [ -n "$SECRET" ]; then
@@ -291,11 +456,53 @@ elif [ -n "$APPID" ] || [ -n "$SECRET" ]; then
     echo "⚠️  --appid 和 --secret 必须同时提供"
 fi
 
-# [5/5] 重启 gateway 使新版本生效
+# [配置] streaming（流式消息）
+if [ -n "$STREAMING" ]; then
+    echo ""
+    echo "[配置] 写入 streaming（流式消息）配置..."
+    STREAMING_VALUE=""
+    if [ "$STREAMING" = "yes" ] || [ "$STREAMING" = "y" ] || [ "$STREAMING" = "true" ]; then
+        STREAMING_VALUE="true"
+    else
+        STREAMING_VALUE="false"
+    fi
+
+    CONFIG_FILE="$HOME/.$CMD/$CMD.json"
+    if [ -f "$CONFIG_FILE" ] && node -e "
+        const fs = require('fs');
+        const cfg = JSON.parse(fs.readFileSync('$CONFIG_FILE', 'utf8'));
+        if (!cfg.channels) cfg.channels = {};
+        if (!cfg.channels.qqbot) cfg.channels.qqbot = {};
+        const target = $STREAMING_VALUE;
+        if (cfg.channels.qqbot.streaming === target) process.exit(0);
+        cfg.channels.qqbot.streaming = target;
+        fs.writeFileSync('$CONFIG_FILE', JSON.stringify(cfg, null, 4) + '\n');
+    " 2>&1; then
+        echo "  ✅ streaming 配置写入成功 (streaming=$STREAMING_VALUE)"
+    else
+        echo "  ⚠️  streaming 配置写入失败，不影响后续运行"
+    fi
+fi
+
+# [4/4] 重启 gateway 使新版本生效
 echo ""
+
+# 手动升级场景：提前写入 startup-marker，阻止重启后 bot 重复推送升级通知
+if [ -n "$NEW_VERSION" ] && [ "$NEW_VERSION" != "unknown" ]; then
+    MARKER_DIR="$HOME/.openclaw/qqbot/data"
+    mkdir -p "$MARKER_DIR"
+    MARKER_FILE="$MARKER_DIR/startup-marker.json"
+    NOW="$(date -u +%Y-%m-%dT%H:%M:%S.000Z 2>/dev/null || date +%Y-%m-%dT%H:%M:%SZ)"
+    echo "{\"version\":\"$NEW_VERSION\",\"startedAt\":\"$NOW\",\"greetedAt\":\"$NOW\"}" > "$MARKER_FILE"
+fi
+
 echo "[重启] 重启 gateway 使新版本生效..."
 if $CMD gateway restart 2>&1; then
     echo "  ✅ gateway 已重启"
+    echo ""
+    if [ -n "$NEW_VERSION" ] && [ "$NEW_VERSION" != "unknown" ]; then
+        echo "🎉 QQBot 插件已更新至 v${NEW_VERSION}，在线等候你的吩咐。"
+    fi
 else
     echo "  ⚠️  gateway 重启失败，请手动执行: $CMD gateway restart"
 fi