@ryantest/openclaw-qqbot 0.0.1

package/scripts/upgrade-via-alt-pkg.sh

@@ -0,0 +1,307 @@
+#!/bin/bash
+
+# qqbot 测试脚本：自由切换不同的 QQBot npm 包
+#
+# 支持从任意 npm 包安装指定版本到 openclaw extensions 目录。
+# 可用于在不同包之间切换测试，如 @sliverp/qqbot、@tencent-connect/openclaw-qqbot 等。
+#
+# 用法:
+#   upgrade-via-alt-pkg.sh --pkg <包名> --version <version>   # 指定包+版本
+#   upgrade-via-alt-pkg.sh --pkg <包名>                        # 指定包，安装 latest
+#   upgrade-via-alt-pkg.sh --appid <appid> --secret <secret>   # 首次安装时配置
+#   upgrade-via-alt-pkg.sh --no-restart                        # 只做文件替换，不重启
+#
+# 示例:
+#   bash scripts/upgrade-via-alt-pkg.sh --pkg @sliverp/qqbot --version 1.5.1
+#   bash scripts/upgrade-via-alt-pkg.sh --pkg @sliverp/qqbot --version 1.5.4
+#   bash scripts/upgrade-via-alt-pkg.sh --pkg @tencent-connect/openclaw-qqbot --version 1.6.4
+#   bash scripts/upgrade-via-alt-pkg.sh --pkg @sliverp/qqbot
+#   bash scripts/upgrade-via-alt-pkg.sh --pkg @sliverp/qqbot --version 1.5.4 --appid 12345 --secret abc123
+
+set -eo pipefail
+
+PKG_NAME=""
+VERSION=""
+INSTALL_SRC=""
+APPID=""
+SECRET=""
+NO_RESTART=false
+
+print_usage() {
+    echo "用法:"
+    echo "  upgrade-via-alt-pkg.sh --pkg <包名> --version <版本号>"
+    echo "  upgrade-via-alt-pkg.sh --pkg <包名>                      # 安装 latest"
+    echo ""
+    echo "选项:"
+    echo "  --pkg <name>          npm 包名（必填，如 @sliverp/qqbot、@tencent-connect/openclaw-qqbot）"
+    echo "  --version <version>   指定版本号（如 1.5.1, 1.5.4, 1.6.4）"
+    echo "  --appid <appid>       QQ机器人 appid（首次安装时必填）"
+    echo "  --secret <secret>     QQ机器人 secret（首次安装时必填）"
+    echo "  --no-restart          只做文件替换，不重启 gateway"
+    echo "  -h, --help            显示帮助信息"
+    echo ""
+    echo "环境变量:"
+    echo "  QQBOT_APPID           QQ机器人 appid"
+    echo "  QQBOT_SECRET          QQ机器人 secret"
+    echo "  QQBOT_TOKEN           QQ机器人 token (appid:secret)"
+    echo ""
+    echo "示例:"
+    echo "  # 从 @sliverp/qqbot 包安装 v1.5.1"
+    echo "  bash scripts/upgrade-via-alt-pkg.sh --pkg @sliverp/qqbot --version 1.5.1"
+    echo ""
+    echo "  # 从 @sliverp/qqbot 包安装 v1.5.4"
+    echo "  bash scripts/upgrade-via-alt-pkg.sh --pkg @sliverp/qqbot --version 1.5.4"
+    echo ""
+    echo "  # 从官方包安装 v1.6.4"
+    echo "  bash scripts/upgrade-via-alt-pkg.sh --pkg @tencent-connect/openclaw-qqbot --version 1.6.4"
+    echo ""
+    echo "  # 切回 @sliverp/qqbot 包的 latest"
+    echo "  bash scripts/upgrade-via-alt-pkg.sh --pkg @sliverp/qqbot"
+}
+
+while [[ $# -gt 0 ]]; do
+    case "$1" in
+        --pkg|--package)
+            [ -z "$2" ] && echo "❌ --pkg 需要参数" && exit 1
+            PKG_NAME="$2"
+            shift 2
+            ;;
+        --version)
+            [ -z "$2" ] && echo "❌ --version 需要参数" && exit 1
+            VERSION="$2"
+            shift 2
+            ;;
+        --tag)
+            [ -z "$2" ] && echo "❌ --tag 需要参数" && exit 1
+            VERSION="$2"
+            shift 2
+            ;;
+        --appid)
+            [ -z "$2" ] && echo "❌ --appid 需要参数" && exit 1
+            APPID="$2"
+            shift 2
+            ;;
+        --secret)
+            [ -z "$2" ] && echo "❌ --secret 需要参数" && exit 1
+            SECRET="$2"
+            shift 2
+            ;;
+        --no-restart)
+            NO_RESTART=true
+            shift 1
+            ;;
+        -h|--help)
+            print_usage
+            exit 0
+            ;;
+        *) echo "未知选项: $1"; print_usage; exit 1 ;;
+    esac
+done
+
+# --pkg 必填
+if [ -z "$PKG_NAME" ]; then
+    echo "❌ 必须指定 --pkg 参数"
+    echo ""
+    print_usage
+    exit 1
+fi
+
+if [ -n "$VERSION" ]; then
+    INSTALL_SRC="${PKG_NAME}@${VERSION}"
+else
+    INSTALL_SRC="${PKG_NAME}@latest"
+fi
+
+# 环境变量 fallback
+APPID="${APPID:-$QQBOT_APPID}"
+SECRET="${SECRET:-$QQBOT_SECRET}"
+if [ -z "$APPID" ] && [ -z "$SECRET" ] && [ -n "$QQBOT_TOKEN" ]; then
+    APPID="${QQBOT_TOKEN%%:*}"
+    SECRET="${QQBOT_TOKEN#*:}"
+fi
+
+# 检测 CLI（仅用于确定 extensions 目录路径）
+CMD=""
+for name in openclaw clawdbot moltbot; do
+    command -v "$name" &>/dev/null && CMD="$name" && break
+done
+[ -z "$CMD" ] && echo "❌ 未找到 openclaw / clawdbot / moltbot" && exit 1
+
+EXTENSIONS_DIR="$HOME/.$CMD/extensions"
+
+echo "==========================================="
+echo "  qqbot 测试升级: $INSTALL_SRC"
+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
+    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 目录
+STAGING_DIR="$(dirname "$EXTENSIONS_DIR")/.qqbot-upgrade-staging"
+rm -rf "$STAGING_DIR"
+mkdir -p "$STAGING_DIR"
+cp -R "$PACKAGE_DIR/." "$STAGING_DIR/"
+
+# 依赖处理
+if [ -d "$STAGING_DIR/node_modules" ]; then
+    BUNDLED_COUNT=$(find "$STAGING_DIR/node_modules" -mindepth 1 -maxdepth 2 -type d | wc -l | tr -d ' ')
+    echo "  bundled 依赖已就绪（${BUNDLED_COUNT} 个包）"
+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"
+fi
+
+# 清理下载临时文件
+rm -rf "$TMPDIR_PACK" "$EXTRACT_DIR"
+cd "$HOME"
+
+# [2/3] 原子替换插件目录
+echo ""
+echo "[2/3] 原子替换插件目录..."
+TARGET_DIR="$EXTENSIONS_DIR/openclaw-qqbot"
+OLD_DIR="$(dirname "$EXTENSIONS_DIR")/.qqbot-upgrade-old"
+
+rm -rf "$OLD_DIR"
+
+STAGING_IN_EXT="$EXTENSIONS_DIR/.openclaw-qqbot-new"
+rm -rf "$STAGING_IN_EXT"
+mv "$STAGING_DIR" "$STAGING_IN_EXT"
+
+if [ -d "$TARGET_DIR" ]; then
+    mv "$TARGET_DIR" "$OLD_DIR" && mv "$STAGING_IN_EXT" "$TARGET_DIR"
+else
+    mv "$STAGING_IN_EXT" "$TARGET_DIR"
+fi
+rm -rf "$OLD_DIR"
+
+# 清理可能残留的旧版 staging 目录
+rm -rf "$EXTENSIONS_DIR/openclaw-qqbot.staging"
+rm -rf "$EXTENSIONS_DIR/.qqbot-upgrade-staging"
+rm -rf "$EXTENSIONS_DIR/.qqbot-upgrade-old"
+
+# 清理历史遗留的其他目录名
+for dir_name in qqbot openclaw-qq; do
+    [ -d "$EXTENSIONS_DIR/$dir_name" ] && rm -rf "$EXTENSIONS_DIR/$dir_name"
+done
+echo "  已安装到: $TARGET_DIR"
+
+# [3/3] 输出新版本号和升级报告
+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 "QQBOT_NEW_VERSION=${NEW_VERSION:-unknown}"
+
+if [ -n "$NEW_VERSION" ] && [ "$NEW_VERSION" != "unknown" ]; then
+    echo "QQBOT_REPORT=✅ QQBot 升级完成 ($PKG_NAME): v${NEW_VERSION}"
+else
+    echo "QQBOT_REPORT=⚠️ QQBot 升级异常，无法确认新版本"
+fi
+
+echo ""
+echo "==========================================="
+echo "  ✅ 文件安装完成"
+echo "==========================================="
+
+# --no-restart 模式
+if [ "$NO_RESTART" = "true" ]; then
+    echo ""
+    echo "[跳过重启] --no-restart 已指定，脚本立即退出以便调用方触发 gateway restart"
+    exit 0
+fi
+
+# [4/4] 配置 appid/secret（仅在提供了参数时执行）
+if [ -n "$APPID" ] && [ -n "$SECRET" ]; then
+    echo ""
+    echo "[配置] 写入 qqbot 通道配置..."
+    DESIRED_TOKEN="${APPID}:${SECRET}"
+
+    CURRENT_TOKEN=""
+    for _app in openclaw clawdbot moltbot; do
+        _cfg="$HOME/.$_app/$_app.json"
+        if [ -f "$_cfg" ]; then
+            CURRENT_TOKEN=$(node -e "
+                const cfg = JSON.parse(require('fs').readFileSync('$_cfg', 'utf8'));
+                const keys = ['qqbot', 'openclaw-qqbot', 'openclaw-qq'];
+                for (const key of keys) {
+                    const ch = cfg.channels && cfg.channels[key];
+                    if (!ch) continue;
+                    if (ch.token) { process.stdout.write(ch.token); process.exit(0); }
+                    if (ch.appId && ch.clientSecret) { process.stdout.write(ch.appId + ':' + ch.clientSecret); process.exit(0); }
+                }
+            " 2>/dev/null || true)
+            [ -n "$CURRENT_TOKEN" ] && break
+        fi
+    done
+
+    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 失败，尝试直接编辑配置文件..."
+        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 = {};
+            cfg.channels.qqbot.appId = '$APPID';
+            cfg.channels.qqbot.clientSecret = '$SECRET';
+            fs.writeFileSync('$CONFIG_FILE', JSON.stringify(cfg, null, 4) + '\n');
+        " 2>&1; then
+            echo "  ✅ 通道配置写入成功（直接编辑配置文件）"
+        else
+            echo "  ❌ 配置写入失败，请手动配置:"
+            echo "     $CMD channels add --channel qqbot --token \"${APPID}:${SECRET}\""
+        fi
+    fi
+elif [ -n "$APPID" ] || [ -n "$SECRET" ]; then
+    echo ""
+    echo "⚠️  --appid 和 --secret 必须同时提供"
+fi
+
+# [5/5] 重启 gateway 使新版本生效
+echo ""
+echo "[重启] 重启 gateway 使新版本生效..."
+if $CMD gateway restart 2>&1; then
+    echo "  ✅ gateway 已重启"
+else
+    echo "  ⚠️  gateway 重启失败，请手动执行: $CMD gateway restart"
+fi

package/scripts/upgrade-via-npm.ps1

@@ -0,0 +1,296 @@
+# qqbot upgrade via npm package (Windows PowerShell)
+#
+# Windows-native equivalent of upgrade-via-npm.sh.
+# No bash / Git Bash / WSL required.
+#
+# Usage:
+#   .\upgrade-via-npm.ps1                                    # upgrade to latest (default)
+#   .\upgrade-via-npm.ps1 -Version <version>                 # upgrade to specific version
+#   .\upgrade-via-npm.ps1 -SelfVersion                       # upgrade to local package.json version
+#   .\upgrade-via-npm.ps1 -AppId <appid> -Secret <secret>    # configure on first install
+#   .\upgrade-via-npm.ps1 -NoRestart                         # file replacement only (for hot-upgrade)
+
+param(
+    [string]$Version = "",
+    [switch]$SelfVersion,
+    [string]$AppId = "",
+    [string]$Secret = "",
+    [switch]$NoRestart,
+    [string]$Tag = "",
+    [switch]$Help
+)
+
+$ErrorActionPreference = "Stop"
+$PKG_NAME = "@tencent-connect/openclaw-qqbot"
+$SCRIPT_DIR = Split-Path -Parent $MyInvocation.MyCommand.Definition
+$PROJECT_DIR = Split-Path -Parent $SCRIPT_DIR
+
+# Read local version
+$LOCAL_VERSION = ""
+try {
+    $pkgPath = Join-Path $PROJECT_DIR "package.json"
+    if (Test-Path $pkgPath) {
+        $pkg = Get-Content $pkgPath -Raw | ConvertFrom-Json
+        $LOCAL_VERSION = $pkg.version
+    }
+} catch {}
+
+if ($Help) {
+    Write-Host "Usage:"
+    Write-Host "  .\upgrade-via-npm.ps1                              # upgrade to latest (default)"
+    Write-Host "  .\upgrade-via-npm.ps1 -Version [version]           # upgrade to specific version"
+    Write-Host "  .\upgrade-via-npm.ps1 -SelfVersion                 # upgrade to repo version ($LOCAL_VERSION)"
+    Write-Host ""
+    Write-Host "  -AppId [appid]       QQ bot appid (required on first install)"
+    Write-Host "  -Secret [secret]     QQ bot secret (required on first install)"
+    exit 0
+}
+
+# Determine install source
+$INSTALL_SRC = ""
+if ($Tag) {
+    $INSTALL_SRC = "${PKG_NAME}@${Tag}"
+} elseif ($Version) {
+    $INSTALL_SRC = "${PKG_NAME}@${Version}"
+} elseif ($SelfVersion) {
+    if (-not $LOCAL_VERSION) {
+        Write-Host "[ERROR] Cannot read version from package.json" -ForegroundColor Red
+        exit 1
+    }
+    $INSTALL_SRC = "${PKG_NAME}@${LOCAL_VERSION}"
+} else {
+    $INSTALL_SRC = "${PKG_NAME}@latest"
+}
+
+# Environment variable fallback
+if (-not $AppId) { $AppId = $env:QQBOT_APPID }
+if (-not $Secret) { $Secret = $env:QQBOT_SECRET }
+if ((-not $AppId) -and (-not $Secret) -and $env:QQBOT_TOKEN) {
+    $parts = $env:QQBOT_TOKEN -split ":", 2
+    $AppId = $parts[0]
+    $Secret = $parts[1]
+}
+
+# Detect CLI
+$CMD = ""
+foreach ($name in @("openclaw", "clawdbot", "moltbot")) {
+    try {
+        $null = Get-Command $name -ErrorAction Stop
+        $CMD = $name
+        break
+    } catch {}
+}
+if (-not $CMD) {
+    Write-Host "[ERROR] openclaw / clawdbot / moltbot not found" -ForegroundColor Red
+    exit 1
+}
+
+$HOME_DIR = $env:USERPROFILE
+if (-not $HOME_DIR) { $HOME_DIR = [Environment]::GetFolderPath("UserProfile") }
+$EXTENSIONS_DIR = Join-Path (Join-Path $HOME_DIR ".$CMD") "extensions"
+
+Write-Host "==========================================="
+Write-Host "  qqbot npm upgrade: $INSTALL_SRC"
+Write-Host "==========================================="
+Write-Host ""
+
+# [1/3] Download and extract new version
+Write-Host "[1/3] Downloading new version..."
+$TMPDIR_PACK = Join-Path ([System.IO.Path]::GetTempPath()) "qqbot-pack-$([guid]::NewGuid().ToString('N').Substring(0,8))"
+$EXTRACT_DIR = Join-Path ([System.IO.Path]::GetTempPath()) "qqbot-extract-$([guid]::NewGuid().ToString('N').Substring(0,8))"
+New-Item -ItemType Directory -Path $TMPDIR_PACK -Force | Out-Null
+New-Item -ItemType Directory -Path $EXTRACT_DIR -Force | Out-Null
+
+try {
+    Push-Location $TMPDIR_PACK
+
+    # Multi-registry fallback
+    $PACK_OK = $false
+    $registries = @("https://registry.npmjs.org/", "https://registry.npmmirror.com/", "")
+    foreach ($registry in $registries) {
+        try {
+            if ($registry) {
+                Write-Host "  Trying registry: $registry"
+                & npm pack $INSTALL_SRC --registry $registry --quiet 2>&1 | Out-Null
+            } else {
+                Write-Host "  Trying default registry..."
+                & npm pack $INSTALL_SRC --quiet 2>&1 | Out-Null
+            }
+            if ($LASTEXITCODE -eq 0) {
+                $PACK_OK = $true
+                break
+            }
+        } catch {}
+    }
+
+    if (-not $PACK_OK) {
+        Write-Host "[ERROR] npm pack failed (all registries unavailable)" -ForegroundColor Red
+        exit 1
+    }
+
+    $TGZ_FILE = Get-ChildItem -Path $TMPDIR_PACK -Filter "*.tgz" | Select-Object -First 1
+    if (-not $TGZ_FILE) {
+        Write-Host "[ERROR] Downloaded tgz file not found" -ForegroundColor Red
+        exit 1
+    }
+    Write-Host "  Downloaded: $($TGZ_FILE.Name)"
+
+    # Extract tgz (tar is built-in on Windows 10+)
+    & tar xzf $TGZ_FILE.FullName -C $EXTRACT_DIR
+    $PACKAGE_DIR = Join-Path $EXTRACT_DIR "package"
+    if (-not (Test-Path $PACKAGE_DIR)) {
+        Write-Host "[ERROR] Extraction failed, package directory not found" -ForegroundColor Red
+        exit 1
+    }
+
+    Pop-Location
+
+    # Prepare staging directory
+    $STAGING_DIR = Join-Path (Split-Path $EXTENSIONS_DIR -Parent) ".qqbot-upgrade-staging"
+    if (Test-Path $STAGING_DIR) { Remove-Item -Recurse -Force $STAGING_DIR }
+    Copy-Item -Recurse -Force $PACKAGE_DIR $STAGING_DIR
+
+    # Check bundled dependencies
+    $nmDir = Join-Path $STAGING_DIR "node_modules"
+    if (Test-Path $nmDir) {
+        $bundledCount = (Get-ChildItem -Directory $nmDir -ErrorAction SilentlyContinue | Measure-Object).Count
+        # Count scoped packages
+        Get-ChildItem -Directory $nmDir -Filter "@*" -ErrorAction SilentlyContinue | ForEach-Object {
+            $bundledCount += (Get-ChildItem -Directory $_.FullName -ErrorAction SilentlyContinue | Measure-Object).Count - 1
+        }
+        Write-Host "  Bundled dependencies ready (${bundledCount} packages)"
+    } else {
+        Write-Host "  [WARN] Bundled node_modules not found, installing dependencies..."
+        Push-Location $STAGING_DIR
+        try { & npm install --omit=dev --omit=peer --ignore-scripts --quiet 2>&1 | Out-Null } catch {}
+        Pop-Location
+    }
+
+} finally {
+    # Clean up temp files
+    if (Test-Path $TMPDIR_PACK) { Remove-Item -Recurse -Force $TMPDIR_PACK -ErrorAction SilentlyContinue }
+    if (Test-Path $EXTRACT_DIR) { Remove-Item -Recurse -Force $EXTRACT_DIR -ErrorAction SilentlyContinue }
+}
+
+# [2/3] Replace plugin directory (in-place overwrite to avoid file-lock issues)
+Write-Host ""
+Write-Host "[2/3] Replacing plugin directory..."
+$TARGET_DIR = Join-Path $EXTENSIONS_DIR "openclaw-qqbot"
+
+if (-not (Test-Path $TARGET_DIR)) {
+    # Fresh install: just move staging into place
+    Move-Item -Path $STAGING_DIR -Destination $TARGET_DIR
+} else {
+    # In-place overwrite using robocopy /MIR (mirrors source to dest, works even with locked files)
+    Write-Host "  Overwriting in-place with robocopy /MIR ..."
+    $roboArgs = @($STAGING_DIR, $TARGET_DIR, "/MIR", "/NFL", "/NDL", "/NJH", "/NJS", "/NP", "/R:3", "/W:2")
+    $roboResult = & robocopy @roboArgs 2>&1
+    $roboExit = $LASTEXITCODE
+    # robocopy exit codes: 0-7 = success (various levels of copy), 8+ = error
+    if ($roboExit -ge 8) {
+        Write-Host "  robocopy failed (exit $roboExit), falling back to Copy-Item..." -ForegroundColor Yellow
+        # Fallback: recursive Copy-Item -Force (overwrites files even if target exists)
+        try {
+            Copy-Item -Path (Join-Path $STAGING_DIR "*") -Destination $TARGET_DIR -Recurse -Force -ErrorAction Stop
+            Write-Host "  Copy-Item fallback succeeded"
+        } catch {
+            Write-Host "  [ERROR] Copy-Item also failed: $($_.Exception.Message)" -ForegroundColor Red
+            exit 1
+        }
+    } else {
+        Write-Host "  robocopy completed (exit $roboExit)"
+    }
+    # Clean up staging
+    Remove-Item -Recurse -Force $STAGING_DIR -ErrorAction SilentlyContinue
+}
+
+# Clean up leftover directories
+foreach ($leftover in @("openclaw-qqbot.staging", ".qqbot-upgrade-staging", ".qqbot-upgrade-old", ".openclaw-qqbot-new")) {
+    $p = Join-Path $EXTENSIONS_DIR $leftover
+    if (Test-Path $p) { Remove-Item -Recurse -Force $p -ErrorAction SilentlyContinue }
+}
+$oldDir = Join-Path (Split-Path $EXTENSIONS_DIR -Parent) ".qqbot-upgrade-old"
+if (Test-Path $oldDir) { Remove-Item -Recurse -Force $oldDir -ErrorAction SilentlyContinue }
+foreach ($legacyName in @("qqbot", "openclaw-qq")) {
+    $p = Join-Path $EXTENSIONS_DIR $legacyName
+    if (Test-Path $p) { Remove-Item -Recurse -Force $p -ErrorAction SilentlyContinue }
+}
+Write-Host "  Installed to: $TARGET_DIR"
+
+# [3/3] Verify installation
+Write-Host ""
+Write-Host "[3/3] Verifying installation..."
+$NEW_VERSION = "unknown"
+try {
+    $newPkgPath = Join-Path $TARGET_DIR "package.json"
+    if (Test-Path $newPkgPath) {
+        $newPkg = Get-Content $newPkgPath -Raw | ConvertFrom-Json
+        if ($newPkg.version) { $NEW_VERSION = $newPkg.version }
+    }
+} catch {}
+
+Write-Host "QQBOT_NEW_VERSION=$NEW_VERSION"
+
+if ($NEW_VERSION -ne "unknown") {
+    Write-Host "QQBOT_REPORT=QQBot upgrade complete: v${NEW_VERSION}"
+} else {
+    Write-Host "QQBOT_REPORT=[WARN] QQBot upgrade status unknown, cannot confirm new version"
+}
+
+Write-Host ""
+Write-Host "==========================================="
+Write-Host "  File installation complete"
+Write-Host "==========================================="
+
+# --NoRestart mode
+if ($NoRestart) {
+    Write-Host ""
+    Write-Host "[Skip restart] -NoRestart specified, exiting for caller to trigger gateway restart"
+    exit 0
+}
+
+# [4/4] Configure appid/secret
+if ($AppId -and $Secret) {
+    Write-Host ""
+    Write-Host "[Config] Writing qqbot channel config..."
+    $DESIRED_TOKEN = "${AppId}:${Secret}"
+
+    try {
+        & $CMD channels add --channel qqbot --token $DESIRED_TOKEN 2>&1 | Out-Null
+        if ($LASTEXITCODE -eq 0) {
+            Write-Host "  Channel config saved"
+        } else { throw "channels add failed" }
+    } catch {
+        Write-Host "  [WARN] $CMD channels add failed, trying direct config edit..." -ForegroundColor Yellow
+        $CONFIG_FILE = Join-Path (Join-Path $HOME_DIR ".$CMD") "$CMD.json"
+        if (Test-Path $CONFIG_FILE) {
+            try {
+                $cfg = Get-Content $CONFIG_FILE -Raw | ConvertFrom-Json
+                if (-not $cfg.channels) { $cfg | Add-Member -NotePropertyName channels -NotePropertyValue @{} }
+                if (-not $cfg.channels.qqbot) { $cfg.channels | Add-Member -NotePropertyName qqbot -NotePropertyValue @{} }
+                $cfg.channels.qqbot | Add-Member -NotePropertyName appId -NotePropertyValue $AppId -Force
+                $cfg.channels.qqbot | Add-Member -NotePropertyName clientSecret -NotePropertyValue $Secret -Force
+                $cfg | ConvertTo-Json -Depth 10 | Set-Content $CONFIG_FILE -Encoding UTF8
+                Write-Host "  Channel config saved (direct file edit)"
+            } catch {
+                Write-Host "  [ERROR] Config write failed, please configure manually:" -ForegroundColor Red
+                Write-Host "     $CMD channels add --channel qqbot --token `"${AppId}:${Secret}`""
+            }
+        }
+    }
+} elseif ($AppId -or $Secret) {
+    Write-Host ""
+    Write-Host "[WARN] -AppId and -Secret must be provided together" -ForegroundColor Yellow
+}
+
+# [5/5] Restart gateway
+Write-Host ""
+Write-Host "[Restart] Restarting gateway..."
+try {
+    & $CMD gateway restart 2>&1 | Out-Null
+    if ($LASTEXITCODE -eq 0) {
+        Write-Host "  Gateway restarted"
+    } else { throw "restart failed" }
+} catch {
+    Write-Host "  [WARN] Gateway restart failed, please run manually: $CMD gateway restart" -ForegroundColor Yellow
+}