@tencent-connect/openclaw-qqbot 1.6.6 → 1.6.7-beta.3

package/README.md

@@ -46,6 +46,7 @@ Scan to join the QQ group chat
 | 📝 **Markdown** | Full Markdown formatting support |
 | 🛠️ **Commands** | Native OpenClaw command integration |
 | 💬 **Quoted Context** | Resolve QQ `REFIDX_*` quoted messages and inject quote body into AI context |
+| 📦 **Large File Support** | Auto chunked upload for large files (parallel upload with retry), up to 100 MB |
 
 ---
 
@@ -211,6 +212,10 @@ All commands support a `?` suffix to show usage:
 >
 > **QQBot**: 📖 /bot-upgrade usage: …
 
+#### `/bot-clear-storage` — Clear files generated through QQBot conversations and downloaded resources (stored on the host running OpenClaw)
+
+`/bot-clear-storage` lists files generated by the conversation and files in the downloaded resources directory. Use `/bot-clear-storage --force` to confirm deletion.
+
 ---
 
 ## 🚀 Getting Started

package/README.zh.md

@@ -41,6 +41,7 @@
 | 📝 **Markdown** | 完整支持 Markdown 格式消息 |
 | 🛠️ **原生命令** | 支持 OpenClaw 原生命令 |
 | 💬 **引用上下文** | 解析 QQ `REFIDX_*` 引用消息，并将引用内容注入 AI 上下文 |
+| 📦 **大文件支持** | 大文件自动分片并行上传，最大支持 100 MB |
 
 ---
 
@@ -206,6 +207,10 @@ AI 可直接发送视频，支持本地文件和公网 URL。
 >
 > **QQBot**：📖 /bot-upgrade 用法：…
 
+#### `/bot-clear-storage` — 清理通过 QQBot 对话产生的文件以及下载的资源（保存在 OpenClaw 运行环境的主机上）
+
+`/bot-clear-storage` 列出对话产生的文件以及下载的资源目录里的文件，使用`/bot-clear-storage -- force`确定删除。
+
 ---
 
 ## 🚀 快速开始

package/dist/src/api.js

@@ -106,7 +106,7 @@ async function doFetchToken(appId, clientSecret) {
     const requestBody = { appId, clientSecret };
     const requestHeaders = { "Content-Type": "application/json", "User-Agent": PLUGIN_USER_AGENT };
     // 打印请求信息（隐藏敏感信息）
-    console.log(`[qqbot-api:${appId}] >>> POST ${TOKEN_URL}`);
+    console.log(`[qqbot-api:${appId}] >>> POST ${TOKEN_URL} [secret: ${clientSecret.slice(0, 6)}...len=${clientSecret.length}]`);
     let response;
     try {
         response = await fetch(TOKEN_URL, {

package/dist/src/config.js

@@ -168,7 +168,7 @@ export function resolveDefaultQQBotAccountId(cfg) {
  * 解析 QQBot 账户配置
  */
 export function resolveQQBotAccount(cfg, accountId) {
-    const resolvedAccountId = accountId ?? DEFAULT_ACCOUNT_ID;
+    const resolvedAccountId = accountId ?? resolveDefaultQQBotAccountId(cfg);
     const qqbot = cfg.channels?.qqbot;
     // 基础配置
     let accountConfig = {};

package/dist/src/gateway.js

@@ -1131,7 +1131,7 @@ export async function startGateway(ctx) {
                 const sendErrorMessage = (errorText) => sendErrorToTarget(replyCtx, errorText);
                 // 使用 AsyncLocalStorage 建立请求级上下文，作用域内所有异步代码
                 // （包括 AI agent 调用、tool execute）都能安全获取当前会话信息，无并发竞态。
-                await runWithRequestContext({ target: qualifiedTarget }, async () => {
+                await runWithRequestContext({ target: qualifiedTarget, accountId: account.accountId }, async () => {
                     try {
                         const messagesConfig = pluginRuntime.channel.reply.resolveEffectiveMessagesConfig(cfg, route.agentId);
                         // 追踪是否有响应

package/dist/src/request-context.d.ts

@@ -1,6 +1,8 @@
 export interface RequestContext {
     /** 投递目标地址，如 qqbot:c2c:xxx 或 qqbot:group:xxx */
     target: string;
+    /** 当前请求的 QQBot 账户 ID（多账户场景） */
+    accountId?: string;
 }
 /**
  * 在请求级作用域中执行回调。
@@ -16,3 +18,8 @@ export declare function getRequestContext(): RequestContext | undefined;
  * 便捷方法，等价于 getRequestContext()?.target。
  */
 export declare function getRequestTarget(): string | undefined;
+/**
+ * 获取当前请求的账户 ID。
+ * 便捷方法，等价于 getRequestContext()?.accountId。
+ */
+export declare function getRequestAccountId(): string | undefined;

package/dist/src/request-context.js

@@ -28,3 +28,10 @@ export function getRequestContext() {
 export function getRequestTarget() {
     return asyncLocalStorage.getStore()?.target;
 }
+/**
+ * 获取当前请求的账户 ID。
+ * 便捷方法，等价于 getRequestContext()?.accountId。
+ */
+export function getRequestAccountId() {
+    return asyncLocalStorage.getStore()?.accountId;
+}

package/dist/src/slash-commands.js

@@ -152,7 +152,7 @@ function checkUpgradeCompatibility() {
     // 3. 检查 Node.js 版本
     const nodeVer = process.version.replace(/^v/, "");
     if (compareSemver(nodeVer, req.minNodeVersion) < 0) {
-        errors.push(`❌ Node.js 版本过低：当前 **v${nodeVer}**，热更新要求最低 **v${req.minNodeVersion}**`);
+        errors.push(`❌ NoVBNde.js 版本过低：当前 **v${nodeVer}**，热更新要求最低 **v${req.minNodeVersion}**`);
     }
     // 4. 检查系统架构（arm 等特殊架构提示）
     const arch = process.arch;
@@ -642,15 +642,24 @@ function cleanupTempScript() {
  *
  * 安全机制：脚本会被复制到临时目录再执行，避免升级过程中插件目录被操作导致脚本自身丢失。
  */
-function fireHotUpgrade(targetVersion) {
-    // 优先从远端下载升级脚本，避免使用本地可能过时的版本
-    const scriptPath = downloadRemoteUpgradeScript() || (() => {
-        const local = getUpgradeScriptPath();
-        if (!local)
-            return null;
-        console.log(`[qqbot] fireHotUpgrade: remote download failed, falling back to local script: ${local}`);
-        return copyScriptToTemp(local) || local;
-    })();
+function fireHotUpgrade(targetVersion, pkg, useLocal) {
+    // --local: 直接使用本地脚本，跳过远端下载
+    // 默认: 优先从远端下载升级脚本，避免使用本地可能过时的版本
+    const scriptPath = useLocal
+        ? (() => {
+            const local = getUpgradeScriptPath();
+            if (!local)
+                return null;
+            console.log(`[qqbot] fireHotUpgrade: --local specified, using local script: ${local}`);
+            return copyScriptToTemp(local) || local;
+        })()
+        : downloadRemoteUpgradeScript() || (() => {
+            const local = getUpgradeScriptPath();
+            if (!local)
+                return null;
+            console.log(`[qqbot] fireHotUpgrade: remote download failed, falling back to local script: ${local}`);
+            return copyScriptToTemp(local) || local;
+        })();
     if (!scriptPath)
         return { ok: false, reason: "no-script" };
     const cli = findCli();
@@ -669,6 +678,7 @@ function fireHotUpgrade(targetVersion) {
             "-File", scriptPath,
             "-NoRestart",
             ...(targetVersion ? ["-Version", targetVersion] : []),
+            ...(pkg ? ["-Pkg", pkg] : []),
         ];
     }
     else {
@@ -677,9 +687,9 @@ function fireHotUpgrade(targetVersion) {
         if (!bash)
             return { ok: false, reason: "no-bash" };
         shell = bash;
-        shellArgs = [scriptPath, "--no-restart", ...(targetVersion ? ["--version", targetVersion] : [])];
+        shellArgs = [scriptPath, "--no-restart", ...(targetVersion ? ["--version", targetVersion] : []), ...(pkg ? ["--pkg", pkg] : [])];
     }
-    console.log(`[qqbot] fireHotUpgrade: shell=${shell}, script=${scriptPath}, cli=${cli}, target=${targetVersion || "latest"}`);
+    console.log(`[qqbot] fireHotUpgrade: shell=${shell}, script=${scriptPath}, cli=${cli}, target=${targetVersion || "latest"}, pkg=${pkg || "default"}`);
     // 异步执行升级脚本
     execFile(shell, shellArgs, {
         timeout: 120_000,
@@ -786,11 +796,13 @@ registerCommand({
         `/bot-upgrade              检查是否有新版本`,
         `/bot-upgrade --latest     确认升级到最新版本（需 upgradeMode=hot-reload）`,
         `/bot-upgrade --version X  升级到指定版本（需 upgradeMode=hot-reload）`,
+        `/bot-upgrade --pkg scope/name  指定 npm 包（如 ryantest/openclaw-qqbot）`,
         `/bot-upgrade --force      强制重新安装当前版本（需 upgradeMode=hot-reload）`,
+        `/bot-upgrade --local      使用本地升级脚本（跳过远端下载）`,
     ].join("\n"),
     handler: async (ctx) => {
         const url = ctx.accountConfig?.upgradeUrl || DEFAULT_UPGRADE_URL;
-        const upgradeMode = ctx.accountConfig?.upgradeMode || "doc";
+        const upgradeMode = ctx.accountConfig?.upgradeMode || "hot-reload";
         const args = ctx.args.trim();
         const info = await getUpdateInfo();
         const GITHUB_URL = "https://github.com/tencent-connect/openclaw-qqbot/";
@@ -834,7 +846,9 @@ registerCommand({
         }
         let isForce = false;
         let isLatest = false;
+        let isLocal = false;
         let versionArg;
+        let pkgArg;
         const tokens = args ? args.split(/\s+/).filter(Boolean) : [];
         for (let i = 0; i < tokens.length; i += 1) {
             const t = tokens[i];
@@ -846,6 +860,27 @@ registerCommand({
                 isLatest = true;
                 continue;
             }
+            if (t === "--local") {
+                isLocal = true;
+                continue;
+            }
+            if (t === "--pkg") {
+                const next = tokens[i + 1];
+                if (!next || next.startsWith("--")) {
+                    return `❌ 参数错误：--pkg 需要包名\n\n示例：/bot-upgrade --pkg ryantest/openclaw-qqbot`;
+                }
+                pkgArg = next;
+                i += 1;
+                continue;
+            }
+            if (t.startsWith("--pkg=")) {
+                const v = t.slice("--pkg=".length).trim();
+                if (!v) {
+                    return `❌ 参数错误：--pkg 需要包名\n\n示例：/bot-upgrade --pkg ryantest/openclaw-qqbot`;
+                }
+                pkgArg = v;
+                continue;
+            }
             if (t === "--version") {
                 const next = tokens[i + 1];
                 if (!next || next.startsWith("--")) {
@@ -904,9 +939,17 @@ registerCommand({
                 `🌟官方 GitHub 仓库：[点击前往](${GITHUB_URL})`,
             ].join("\n");
         }
+        // 解析 npm 包名：--pkg 参数 > 配置项 upgradePkg > 默认
+        // 支持 "scope/name"（自动补 @）和 "@scope/name" 两种格式
+        let upgradePkg = pkgArg || ctx.accountConfig?.upgradePkg;
+        if (upgradePkg) {
+            upgradePkg = upgradePkg.trim();
+            if (!upgradePkg.startsWith("@"))
+                upgradePkg = `@${upgradePkg}`;
+        }
         // ── --version 指定版本：先校验版本号是否存在 ──
         if (versionArg) {
-            const exists = await checkVersionExists(versionArg);
+            const exists = await checkVersionExists(versionArg, upgradePkg);
             if (!exists) {
                 return `❌ 版本 ${versionArg} 不存在，请检查版本号`;
             }
@@ -951,7 +994,7 @@ registerCommand({
         // 热更新前保存凭证快照，防止更新过程被打断导致 appId/secret 丢失
         preUpgradeCredentialBackup(ctx.accountId, ctx.appId);
         // 异步执行升级
-        const startResult = fireHotUpgrade(targetVersion);
+        const startResult = fireHotUpgrade(targetVersion, upgradePkg, isLocal);
         if (!startResult.ok) {
             _upgrading = false;
             if (startResult.reason === "no-script") {

package/dist/src/tools/remind.js

@@ -1,4 +1,4 @@
-import { getRequestTarget } from "../request-context.js";
+import { getRequestTarget, getRequestAccountId } from "../request-context.js";
 // ========== JSON Schema ==========
 const RemindSchema = {
     type: "object",
@@ -100,7 +100,7 @@ function generateJobName(content) {
 /**
  * 构建一次性提醒的 cron 工具参数
  */
-function buildOnceJob(params, delayMs, to) {
+function buildOnceJob(params, delayMs, to, accountId) {
     const atMs = Date.now() + delayMs;
     const content = params.content;
     const name = params.name || generateJobName(content);
@@ -115,9 +115,12 @@ function buildOnceJob(params, delayMs, to) {
             payload: {
                 kind: "agentTurn",
                 message: buildReminderPrompt(content),
-                deliver: true,
+            },
+            delivery: {
+                mode: "announce",
                 channel: "qqbot",
                 to,
+                accountId,
             },
         },
     };
@@ -125,7 +128,7 @@ function buildOnceJob(params, delayMs, to) {
 /**
  * 构建周期提醒的 cron 工具参数
  */
-function buildCronJob(params, to) {
+function buildCronJob(params, to, accountId) {
     const content = params.content;
     const name = params.name || generateJobName(content);
     const tz = params.timezone || "Asia/Shanghai";
@@ -139,9 +142,12 @@ function buildCronJob(params, to) {
             payload: {
                 kind: "agentTurn",
                 message: buildReminderPrompt(content),
-                deliver: true,
+            },
+            delivery: {
+                mode: "announce",
                 channel: "qqbot",
                 to,
+                accountId,
             },
         },
     };
@@ -211,15 +217,17 @@ export function registerRemindTool(api) {
             if (!resolvedTo) {
                 return json({ error: "action=add 时无法确定投递目标地址。请稍后重试。" });
             }
+            // 从请求上下文获取当前账户 ID（多账户场景），fallback 到 "default"
+            const resolvedAccountId = getRequestAccountId() || "default";
             if (!p.time) {
                 return json({ error: "action=add 时 time（时间）为必填参数。示例：\"5m\"、\"1h30m\"、\"0 8 * * *\"" });
             }
             // 判断是 cron 表达式还是相对时间
             if (isCronExpression(p.time)) {
                 // 周期提醒
-                const cronJob = buildCronJob(p, resolvedTo);
+                const cronJob = buildCronJob(p, resolvedTo, resolvedAccountId);
                 return json({
-                    _instruction: "请立即使用 cron 工具执行以下参数，然后回复用户提醒已设置",
+                    _instruction: "请立即使用 cron 工具，将 cronParams 的值原样作为参数传入（不要修改或省略任何字段，特别是 delivery.accountId），然后回复用户提醒已设置",
                     cronParams: cronJob,
                     summary: `⏰ 周期提醒: "${p.content}" (${p.time}, tz=${p.timezone || "Asia/Shanghai"})`,
                 });
@@ -236,9 +244,9 @@ export function registerRemindTool(api) {
             if (delayMs < 30_000) {
                 return json({ error: "提醒时间不能少于 30 秒" });
             }
-            const onceJob = buildOnceJob(p, delayMs, resolvedTo);
+            const onceJob = buildOnceJob(p, delayMs, resolvedTo, resolvedAccountId);
             return json({
-                _instruction: "请立即使用 cron 工具执行以下参数，然后回复用户提醒已设置",
+                _instruction: "请立即使用 cron 工具，将 cronParams 的值原样作为参数传入（不要修改或省略任何字段，特别是 delivery.accountId），然后回复用户提醒已设置",
                 cronParams: onceJob,
                 summary: `⏰ ${formatDelay(delayMs)}后提醒: "${p.content}"`,
             });

package/dist/src/types.d.ts

@@ -92,10 +92,17 @@ export interface QQBotAccountConfig {
     upgradeUrl?: string;
     /**
      * /bot-upgrade 指令的行为模式
-     * - "doc"：展示升级文档链接（默认，安全模式）
-     * - "hot-reload"：检测到新版本时直接执行 npm 升级脚本进行热更新
+     * - "doc"：展示升级文档链接（安全模式）
+     * - "hot-reload"：检测到新版本时直接执行 npm 升级脚本进行热更新（默认）
      */
     upgradeMode?: "doc" | "hot-reload";
+    /**
+     * /bot-upgrade 热更新时使用的 npm 包名
+     * 支持 "scope/name"（自动补 @）或 "@scope/name" 格式
+     * 默认: "@tencent-connect/openclaw-qqbot"
+     * 示例: "ryantest/openclaw-qqbot"
+     */
+    upgradePkg?: string;
     /**
      * 出站消息合并回复（debounce）配置
      * 当短时间内收到多次 deliver 时，将文本合并为一条消息发送，避免消息轰炸

package/dist/src/update-checker.d.ts

@@ -30,5 +30,7 @@ export declare function getUpdateInfo(): Promise<UpdateInfo>;
 /**
  * 检查指定版本是否存在于 npm registry
  * 用于 /bot-upgrade --version 的前置校验
+ * @param version 要检查的版本号
+ * @param pkgName 可选的包名（如 "@ryantest/openclaw-qqbot"），默认使用内置包名
  */
-export declare function checkVersionExists(version: string): Promise<boolean>;
+export declare function checkVersionExists(version: string, pkgName?: string): Promise<boolean>;

package/dist/src/update-checker.js

@@ -99,9 +99,12 @@ export async function getUpdateInfo() {
 /**
  * 检查指定版本是否存在于 npm registry
  * 用于 /bot-upgrade --version 的前置校验
+ * @param version 要检查的版本号
+ * @param pkgName 可选的包名（如 "@ryantest/openclaw-qqbot"），默认使用内置包名
  */
-export async function checkVersionExists(version) {
-    for (const baseUrl of REGISTRIES) {
+export async function checkVersionExists(version, pkgName) {
+    const registries = pkgName ? buildRegistries(pkgName) : REGISTRIES;
+    for (const baseUrl of registries) {
         try {
             const url = `${baseUrl}/${version}`;
             const json = await fetchJson(url, 10_000);
@@ -114,6 +117,14 @@ export async function checkVersionExists(version) {
     }
     return false;
 }
+/** 根据自定义包名构建 registry URL 列表 */
+function buildRegistries(pkgName) {
+    const encoded = encodeURIComponent(pkgName);
+    return [
+        `https://registry.npmjs.org/${encoded}`,
+        `https://registry.npmmirror.com/${encoded}`,
+    ];
+}
 function compareVersions(a, b) {
     const parse = (v) => {
         const clean = v.replace(/^v/, "");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tencent-connect/openclaw-qqbot",
-  "version": "1.6.6",
+  "version": "1.6.7-beta.3",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/scripts/postinstall-link-sdk.js

@@ -10,7 +10,7 @@
 // globally installed openclaw package, allowing Node's native ESM resolver
 // (used by jiti with tryNative:true for .js files) to find `openclaw/plugin-sdk`.
 
-import { existsSync, symlinkSync, mkdirSync, realpathSync } from "node:fs";
+import { existsSync, lstatSync, symlinkSync, unlinkSync, rmSync, mkdirSync, realpathSync } from "node:fs";
 import { dirname, join, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import { execSync } from "node:child_process";
@@ -18,17 +18,30 @@ import { execSync } from "node:child_process";
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const pluginRoot = resolve(__dirname, "..");
 
-// Only run when installed under an openclaw-like extensions directory
-// (supports openclaw, clawdbot, moltbot, etc.)
-if (!pluginRoot.includes("extensions")) {
-  process.exit(0);
-}
-
 const linkTarget = join(pluginRoot, "node_modules", "openclaw");
 
-// Already linked or exists
+// Check if already a valid symlink pointing to a directory with plugin-sdk/core
 if (existsSync(linkTarget)) {
-  process.exit(0);
+  try {
+    const stat = lstatSync(linkTarget);
+    if (stat.isSymbolicLink()) {
+      // Symlink exists — verify it has plugin-sdk/core
+      if (existsSync(join(linkTarget, "plugin-sdk", "core.js"))) {
+        process.exit(0);
+      }
+      // Symlink is stale or points to wrong target, remove and re-create
+      unlinkSync(linkTarget);
+    } else if (existsSync(join(linkTarget, "plugin-sdk", "core.js"))) {
+      // Real directory with correct structure (e.g. npm installed a good version)
+      process.exit(0);
+    } else {
+      // Real directory from npm install but missing plugin-sdk/core — replace with symlink
+      rmSync(linkTarget, { recursive: true, force: true });
+    }
+  } catch {
+    // If stat fails, try to remove and re-create
+    try { rmSync(linkTarget, { recursive: true, force: true }); } catch {}
+  }
 }
 
 // CLI names to try (openclaw and its aliases)

package/scripts/upgrade-via-npm.ps1

@@ -17,6 +17,7 @@ param(
     [string]$Secret = "",
     [switch]$NoRestart,
     [string]$Tag = "",
+    [string]$Pkg = "",
     [switch]$Help
 )
 
@@ -25,6 +26,13 @@ $PKG_NAME = "@tencent-connect/openclaw-qqbot"
 $SCRIPT_DIR = Split-Path -Parent $MyInvocation.MyCommand.Definition
 $PROJECT_DIR = Split-Path -Parent $SCRIPT_DIR
 
+# -Pkg 覆盖包名（支持 "scope/name" 自动补 @）
+if ($Pkg) {
+    $Pkg = $Pkg.Trim()
+    if (-not $Pkg.StartsWith("@")) { $Pkg = "@$Pkg" }
+    $PKG_NAME = $Pkg
+}
+
 # Read local version
 $LOCAL_VERSION = ""
 try {
@@ -41,6 +49,7 @@ if ($Help) {
     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 "  -Pkg [scope/name]    Custom npm package (e.g. ryantest/openclaw-qqbot)"
     Write-Host "  -AppId [appid]       QQ bot appid (required on first install)"
     Write-Host "  -Secret [secret]     QQ bot secret (required on first install)"
     exit 0

package/scripts/upgrade-via-npm.sh

@@ -18,14 +18,21 @@
 
 set -eo pipefail
 
-# 异常退出时清理临时配置文件（防止泄露或残留）
+# 异常退出时清理临时文件（防止泄露或残留）
 cleanup_on_exit() {
     if [ -n "$TEMP_CONFIG_FILE" ] && [ -f "$TEMP_CONFIG_FILE" ]; then
         rm -f "$TEMP_CONFIG_FILE" 2>/dev/null || true
     fi
+    # 异常退出时清理本次备份目录（正常流程中备份已被删除或回滚，这里是兜底）
+    if [ -n "$BACKUP_DIR" ] && [ -d "$BACKUP_DIR" ]; then
+        rm -rf "$BACKUP_DIR" 2>/dev/null || true
+    fi
 }
 trap cleanup_on_exit EXIT
 
+# 清理上次升级可能遗留的备份目录（如上次脚本被 kill 等极端情况）
+find "${TMPDIR:-/tmp}" -maxdepth 1 -name ".qqbot-upgrade-backup-*" -exec rm -rf {} + 2>/dev/null || true
+
 PKG_NAME="@tencent-connect/openclaw-qqbot"
 PLUGIN_ID="openclaw-qqbot"
 INSTALL_SRC=""
@@ -56,6 +63,7 @@ print_usage() {
         echo "  upgrade-via-npm.sh --self-version               # 升级到当前仓库版本"
     fi
     echo ""
+    echo "  --pkg <scope/name>    指定 npm 包名（如 ryantest/openclaw-qqbot）"
     echo "  --appid <appid>       QQ机器人 appid（首次安装时必填）"
     echo "  --secret <secret>     QQ机器人 secret（首次安装时必填）"
     echo ""
@@ -69,22 +77,17 @@ while [[ $# -gt 0 ]]; do
     case "$1" in
         --tag)
             [ -z "$2" ] && echo "❌ --tag 需要参数" && exit 1
-            _ver="${2#v}"  # 去掉 v 前缀（npm 版本号不带 v）
-            TARGET_VERSION="$_ver"
-            INSTALL_SRC="${PKG_NAME}@$_ver"
+            TARGET_VERSION="${2#v}"  # 去掉 v 前缀（npm 版本号不带 v）
             shift 2
             ;;
         --version)
             [ -z "$2" ] && echo "❌ --version 需要参数" && exit 1
-            _ver="${2#v}"  # 去掉 v 前缀（npm 版本号不带 v）
-            TARGET_VERSION="$_ver"
-            INSTALL_SRC="${PKG_NAME}@$_ver"
+            TARGET_VERSION="${2#v}"  # 去掉 v 前缀（npm 版本号不带 v）
             shift 2
             ;;
         --self-version)
             [ -z "$LOCAL_VERSION" ] && echo "❌ 无法从 package.json 读取版本" && exit 1
             TARGET_VERSION="$LOCAL_VERSION"
-            INSTALL_SRC="${PKG_NAME}@${LOCAL_VERSION}"
             shift 1
             ;;
         --appid)
@@ -97,6 +100,14 @@ while [[ $# -gt 0 ]]; do
             SECRET="$2"
             shift 2
             ;;
+        --pkg)
+            [ -z "$2" ] && echo "❌ --pkg 需要参数" && exit 1
+            _pkg="$2"
+            # 支持 "scope/name" 自动补 @
+            if [[ "$_pkg" != @* ]]; then _pkg="@$_pkg"; fi
+            PKG_NAME="$_pkg"
+            shift 2
+            ;;
         --no-restart)
             NO_RESTART=true
             shift 1
@@ -108,7 +119,12 @@ while [[ $# -gt 0 ]]; do
         *) echo "未知选项: $1"; print_usage; exit 1 ;;
     esac
 done
-INSTALL_SRC="${INSTALL_SRC:-${PKG_NAME}@latest}"
+# 参数解析完毕后统一拼接 INSTALL_SRC（确保 --pkg 无论在 --version 前后都能生效）
+if [ -n "$TARGET_VERSION" ]; then
+    INSTALL_SRC="${PKG_NAME}@${TARGET_VERSION}"
+else
+    INSTALL_SRC="${PKG_NAME}@latest"
+fi
 
 # 环境变量 fallback
 APPID="${APPID:-$QQBOT_APPID}"
@@ -291,7 +307,7 @@ if [ "$UPGRADE_OK" != "true" ]; then
     # 备份旧目录（而非直接删除），install 失败时可回滚
     BACKUP_DIR=""
     if [ -d "$EXTENSIONS_DIR/$PLUGIN_ID" ]; then
-        BACKUP_DIR="$EXTENSIONS_DIR/.openclaw-qqbot-backup-$$"
+        BACKUP_DIR="$(mktemp -d "${TMPDIR:-/tmp}/.qqbot-upgrade-backup-XXXXXX")"
         mv "$EXTENSIONS_DIR/$PLUGIN_ID" "$BACKUP_DIR"
         echo "  已备份旧目录: $BACKUP_DIR"
     fi
@@ -311,8 +327,9 @@ if [ "$UPGRADE_OK" != "true" ]; then
             rm -rf "$BACKUP_DIR"
             echo "  已清理旧版备份"
         fi
-        # 清理 openclaw CLI install 可能留下的额外 backup 目录
+        # 清理 openclaw CLI install 可能留下的额外 backup 目录（extensions 内遗留 + 新路径）
         find "$EXTENSIONS_DIR" -maxdepth 1 -name ".openclaw-qqbot-backup-*" -exec rm -rf {} + 2>/dev/null || true
+        find "${TMPDIR:-/tmp}" -maxdepth 1 -name ".qqbot-upgrade-backup-*" -exec rm -rf {} + 2>/dev/null || true
     else
         echo "  ❌ install 失败"
         # 回滚：恢复旧目录

package/scripts/upgrade-via-source.sh

@@ -344,13 +344,13 @@ if [ ! -f "$_INSTALL_DIR/dist/index.js" ] || [ ! -f "$_INSTALL_DIR/preload.cjs"
             echo "请先解决安装问题后再运行此脚本。"
             # 恢复 channels.qqbot 后再退出
             if [ -n "$_QQBOT_CHANNEL_STASH" ] && [ -n "$_STASH_CFG" ] && [ -f "$_STASH_CFG" ]; then
-                node -e "
-                    const fs = require('fs');
-                    const cfg = JSON.parse(fs.readFileSync('$_STASH_CFG', 'utf8'));
+                _STASH="$_QQBOT_CHANNEL_STASH" _CFG="$_STASH_CFG" node -e '
+                    const fs = require("fs");
+                    const cfg = JSON.parse(fs.readFileSync(process.env._CFG, "utf8"));
                     if (!cfg.channels) cfg.channels = {};
-                    cfg.channels.qqbot = $_QQBOT_CHANNEL_STASH;
-                    fs.writeFileSync('$_STASH_CFG', JSON.stringify(cfg, null, 4) + '\n');
-                " 2>/dev/null || true
+                    cfg.channels.qqbot = JSON.parse(process.env._STASH);
+                    fs.writeFileSync(process.env._CFG, JSON.stringify(cfg, null, 4) + "\n");
+                ' 2>/dev/null || true
             fi
             exit 1
             ;;  
@@ -527,6 +527,7 @@ else
     # 清理 openclaw CLI install 留下的 backup 目录，
     # 避免 gateway 发现两个同 id 插件不断刷 duplicate plugin id 警告
     find "$HOME/.openclaw/extensions/" -maxdepth 1 -name ".openclaw-qqbot-backup-*" -exec rm -rf {} + 2>/dev/null || true
+    find "${TMPDIR:-/tmp}" -maxdepth 1 -name ".qqbot-upgrade-backup-*" -exec rm -rf {} + 2>/dev/null || true
 
     # 恢复 channels.qqbot 完整配置（防止 plugins install 意外覆盖）
     # 策略：直接用备份完整覆盖回去，确保 groups / env / prompts / allowFrom 等所有用户配置不丢失。
@@ -591,11 +592,11 @@ echo "[4/6] 准备机器人通道配置..."
 # 注意：channels.qqbot 已被暂存移除，所以从 _QQBOT_CHANNEL_STASH 读取
 CURRENT_QQBOT_TOKEN=""
 if [ -n "$_QQBOT_CHANNEL_STASH" ]; then
-    CURRENT_QQBOT_TOKEN=$(node -e "
-        const ch = $_QQBOT_CHANNEL_STASH;
+    CURRENT_QQBOT_TOKEN=$(_STASH="$_QQBOT_CHANNEL_STASH" node -e '
+        const ch = JSON.parse(process.env._STASH);
         if (ch.token) { process.stdout.write(ch.token); }
-        else if (ch.appId && ch.clientSecret) { process.stdout.write(ch.appId + ':' + ch.clientSecret); }
-    " 2>/dev/null || true)
+        else if (ch.appId && ch.clientSecret) { process.stdout.write(ch.appId + ":" + ch.clientSecret); }
+    ' 2>/dev/null || true)
 fi
 
 DESIRED_QQBOT_TOKEN=""
@@ -786,34 +787,39 @@ case "$start_choice" in
 
             if [ -n "$_target_cfg" ]; then
                 # 构建完整的 channels.qqbot 对象（合并暂存配置 + 新 token + markdown）
-                node -e "
-                    const fs = require('fs');
-                    const cfg = JSON.parse(fs.readFileSync('$_target_cfg', 'utf8'));
+                # 通过环境变量传递，避免 JSON 双引号在 node -e "..." 中被 shell 错误解析
+                _STASH="$_QQBOT_CHANNEL_STASH" \
+                _DESIRED="$DESIRED_QQBOT_TOKEN" \
+                _MD="$MARKDOWN_VALUE" \
+                _CFG="$_target_cfg" \
+                node -e '
+                    const fs = require("fs");
+                    const cfg = JSON.parse(fs.readFileSync(process.env._CFG, "utf8"));
                     if (!cfg.channels) cfg.channels = {};
 
                     // 从暂存恢复基础配置
-                    const stash = '$_QQBOT_CHANNEL_STASH';
+                    const stash = process.env._STASH;
                     if (stash) {
                         try { cfg.channels.qqbot = JSON.parse(stash); } catch {}
                     }
                     if (!cfg.channels.qqbot) cfg.channels.qqbot = {};
 
                     // 覆盖 token（如果有新值）
-                    const desired = '$DESIRED_QQBOT_TOKEN';
-                    if (desired && desired.includes(':')) {
-                        const [appId, ...rest] = desired.split(':');
+                    const desired = process.env._DESIRED;
+                    if (desired && desired.includes(":")) {
+                        const [appId, ...rest] = desired.split(":");
                         cfg.channels.qqbot.appId = appId;
-                        cfg.channels.qqbot.clientSecret = rest.join(':');
+                        cfg.channels.qqbot.clientSecret = rest.join(":");
                         delete cfg.channels.qqbot.token;
                     }
 
                     // 覆盖 markdown（如果有指定）
-                    const md = '$MARKDOWN_VALUE';
-                    if (md === 'true') cfg.channels.qqbot.markdownSupport = true;
-                    else if (md === 'false') cfg.channels.qqbot.markdownSupport = false;
+                    const md = process.env._MD;
+                    if (md === "true") cfg.channels.qqbot.markdownSupport = true;
+                    else if (md === "false") cfg.channels.qqbot.markdownSupport = false;
 
-                    fs.writeFileSync('$_target_cfg', JSON.stringify(cfg, null, 4) + '\n');
-                " 2>/dev/null || true
+                    fs.writeFileSync(process.env._CFG, JSON.stringify(cfg, null, 4) + "\n");
+                ' 2>&1 || echo "  ⚠️  配置写入失败"
                 echo "  ✅ 已恢复 channels.qqbot 配置（含 token/markdown）"
                 _need_reload=1
             fi
@@ -883,13 +889,13 @@ case "$start_choice" in
         # 注意：下次 gateway 启动可能因 "unknown channel id" 失败，
         # 需要用户手动 stop → 移除 channels.qqbot → start → 恢复
         if [ -n "$_QQBOT_CHANNEL_STASH" ] && [ -n "$_STASH_CFG" ] && [ -f "$_STASH_CFG" ]; then
-            node -e "
-                const fs = require('fs');
-                const cfg = JSON.parse(fs.readFileSync('$_STASH_CFG', 'utf8'));
+            _STASH="$_QQBOT_CHANNEL_STASH" _CFG="$_STASH_CFG" node -e '
+                const fs = require("fs");
+                const cfg = JSON.parse(fs.readFileSync(process.env._CFG, "utf8"));
                 if (!cfg.channels) cfg.channels = {};
-                cfg.channels.qqbot = $_QQBOT_CHANNEL_STASH;
-                fs.writeFileSync('$_STASH_CFG', JSON.stringify(cfg, null, 4) + '\n');
-            " 2>/dev/null || true
+                cfg.channels.qqbot = JSON.parse(process.env._STASH);
+                fs.writeFileSync(process.env._CFG, JSON.stringify(cfg, null, 4) + "\n");
+            ' 2>/dev/null || true
             echo "  已恢复 channels.qqbot 配置"
         fi
         echo ""

package/skills/qqbot-remind/SKILL.md

@@ -26,7 +26,7 @@ metadata: {"openclaw":{"emoji":"⏰","requires":{"config":["channels.qqbot"]}}}
 | `time` | 时间（相对时间或 cron 表达式） | `"5m"` / `"1h30m"` / `"0 8 * * *"` |
 | `jobId` | 任务 ID（仅 remove） | `"xxx"` |
 
-**第二步**：`qqbot_remind` 会返回 `cronParams`，你必须**立即**将 `cronParams` 的值作为参数调用 `cron` 工具。
+**第二步**：`qqbot_remind` 会返回 `cronParams`，你必须**立即**将 `cronParams` 的值**原样**作为参数调用 `cron` 工具。**禁止修改、省略或重组 `cronParams` 中的任何字段**（尤其是 `delivery` 对象中的 `accountId`）。
 
 **第三步**：根据 `cron` 工具的返回结果，回复用户。
 
@@ -54,11 +54,13 @@ metadata: {"openclaw":{"emoji":"⏰","requires":{"config":["channels.qqbot"]}}}
 | 字段 | 固定值 | 原因 |
 |------|--------|------|
 | `payload.kind` | `"agentTurn"` | `systemEvent` 不会发 QQ 消息 |
-| `payload.deliver` | `true` | 否则不投递 |
-| `payload.channel` | `"qqbot"` | QQ 通道标识 |
-| `payload.to` | 用户 openid | 从 `To` 字段获取 |
+| `delivery.mode` | `"announce"` | 投递模式 |
+| `delivery.channel` | `"qqbot"` | QQ 通道标识 |
+| `delivery.to` | 用户 openid | 从 `To` 字段获取 |
 | `sessionTarget` | `"isolated"` | 隔离会话避免污染 |
 
+> `delivery.accountId` 必须填写当前会话的账户 ID（如果已知），以确保多账户场景下消息通过正确的机器人账户发送。
+
 > `schedule.atMs` 必须是**绝对毫秒时间戳**（如 `1770733800000`），不支持 `"5m"` 等相对字符串。
 > 计算方式：`当前时间戳ms + 延迟毫秒`。
 
@@ -75,10 +77,13 @@ metadata: {"openclaw":{"emoji":"⏰","requires":{"config":["channels.qqbot"]}}}
     "deleteAfterRun": true,
     "payload": {
       "kind": "agentTurn",
-      "message": "你是一个暖心的提醒助手。请用温暖、有趣的方式提醒用户：{提醒内容}。要求：(1) 不要回复HEARTBEAT_OK (2) 不要解释你是谁 (3) 直接输出一条暖心的提醒消息 (4) 可以加一句简短的鸡汤或关怀的话 (5) 控制在2-3句话以内 (6) 用emoji点缀",
-      "deliver": true,
+      "message": "你是一个暖心的提醒助手。请用温暖、有趣的方式提醒用户：{提醒内容}。要求：(1) 不要回复HEARTBEAT_OK (2) 不要解释你是谁 (3) 直接输出一条暖心的提醒消息 (4) 可以加一句简短的鸡汤或关怀的话 (5) 控制在2-3句话以内 (6) 用emoji点缀"
+    },
+    "delivery": {
+      "mode": "announce",
       "channel": "qqbot",
-      "to": "{openid}"
+      "to": "{openid}",
+      "accountId": "{accountId}"
     }
   }
 }
@@ -96,16 +101,19 @@ metadata: {"openclaw":{"emoji":"⏰","requires":{"config":["channels.qqbot"]}}}
     "wakeMode": "now",
     "payload": {
       "kind": "agentTurn",
-      "message": "你是一个暖心的提醒助手。请用温暖、有趣的方式提醒用户：{提醒内容}。要求：(1) 不要回复HEARTBEAT_OK (2) 不要解释你是谁 (3) 直接输出一条暖心的提醒消息 (4) 可以加一句简短的鸡汤或关怀的话 (5) 控制在2-3句话以内 (6) 用emoji点缀",
-      "deliver": true,
+      "message": "你是一个暖心的提醒助手。请用温暖、有趣的方式提醒用户：{提醒内容}。要求：(1) 不要回复HEARTBEAT_OK (2) 不要解释你是谁 (3) 直接输出一条暖心的提醒消息 (4) 可以加一句简短的鸡汤或关怀的话 (5) 控制在2-3句话以内 (6) 用emoji点缀"
+    },
+    "delivery": {
+      "mode": "announce",
       "channel": "qqbot",
-      "to": "{openid}"
+      "to": "{openid}",
+      "accountId": "{accountId}"
     }
   }
 }
 ```
 
-> 周期任务**不加** `deleteAfterRun`。群聊 `to` 格式为 `"group:{group_openid}"`。
+> 周期任务**不加** `deleteAfterRun`。群聊 `to` 格式为 `"qqbot:group:{group_openid}"`。
 
 ---
 
@@ -147,3 +155,5 @@ metadata: {"openclaw":{"emoji":"⏰","requires":{"config":["channels.qqbot"]}}}
 - 周期：`⏰ 收到，{周期}提醒你{内容}~`
 - 查询无结果：`📋 目前没有提醒哦~ 说"5分钟后提醒我xxx"试试？`
 - 删除成功：`✅ 已取消"{名称}"`
+
+openclaw cron add \ --name "下班提醒" \ --at "2026-03-26T21:42:31+08:00" \ --message "test" \ --to …``

package/src/api.ts

@@ -137,7 +137,7 @@ async function doFetchToken(appId: string, clientSecret: string): Promise<string
   const requestHeaders = { "Content-Type": "application/json", "User-Agent": PLUGIN_USER_AGENT };
   
   // 打印请求信息（隐藏敏感信息）
-  console.log(`[qqbot-api:${appId}] >>> POST ${TOKEN_URL}`);
+  console.log(`[qqbot-api:${appId}] >>> POST ${TOKEN_URL} [secret: ${clientSecret.slice(0, 6)}...len=${clientSecret.length}]`);
 
   let response: Response;
   try {

package/src/config.ts

@@ -227,7 +227,7 @@ export function resolveQQBotAccount(
   cfg: OpenClawConfig,
   accountId?: string | null
 ): ResolvedQQBotAccount {
-  const resolvedAccountId = accountId ?? DEFAULT_ACCOUNT_ID;
+  const resolvedAccountId = accountId ?? resolveDefaultQQBotAccountId(cfg);
   const qqbot = cfg.channels?.qqbot as QQBotChannelConfig | undefined;
 
   // 基础配置

package/src/gateway.ts

@@ -1333,7 +1333,7 @@ export async function startGateway(ctx: GatewayContext): Promise<void> {
 
         // 使用 AsyncLocalStorage 建立请求级上下文，作用域内所有异步代码
         // （包括 AI agent 调用、tool execute）都能安全获取当前会话信息，无并发竞态。
-        await runWithRequestContext({ target: qualifiedTarget }, async () => {
+        await runWithRequestContext({ target: qualifiedTarget, accountId: account.accountId }, async () => {
         try {
           const messagesConfig = pluginRuntime.channel.reply.resolveEffectiveMessagesConfig(cfg, route.agentId);
 

package/src/request-context.ts

@@ -11,6 +11,8 @@ import { AsyncLocalStorage } from "node:async_hooks";
 export interface RequestContext {
   /** 投递目标地址，如 qqbot:c2c:xxx 或 qqbot:group:xxx */
   target: string;
+  /** 当前请求的 QQBot 账户 ID（多账户场景） */
+  accountId?: string;
 }
 
 const asyncLocalStorage = new AsyncLocalStorage<RequestContext>();
@@ -37,3 +39,11 @@ export function getRequestContext(): RequestContext | undefined {
 export function getRequestTarget(): string | undefined {
   return asyncLocalStorage.getStore()?.target;
 }
+
+/**
+ * 获取当前请求的账户 ID。
+ * 便捷方法，等价于 getRequestContext()?.accountId。
+ */
+export function getRequestAccountId(): string | undefined {
+  return asyncLocalStorage.getStore()?.accountId;
+}

package/src/slash-commands.ts

@@ -162,7 +162,7 @@ function checkUpgradeCompatibility(): UpgradeCompatResult {
   // 3. 检查 Node.js 版本
   const nodeVer = process.version.replace(/^v/, "");
   if (compareSemver(nodeVer, req.minNodeVersion) < 0) {
-    errors.push(`❌ Node.js 版本过低：当前 **v${nodeVer}**，热更新要求最低 **v${req.minNodeVersion}**`);
+    errors.push(`❌ NoVBNde.js 版本过低：当前 **v${nodeVer}**，热更新要求最低 **v${req.minNodeVersion}**`);
   }
 
   // 4. 检查系统架构（arm 等特殊架构提示）
@@ -746,14 +746,22 @@ function cleanupTempScript(): void {
  *
  * 安全机制：脚本会被复制到临时目录再执行，避免升级过程中插件目录被操作导致脚本自身丢失。
  */
-function fireHotUpgrade(targetVersion?: string): HotUpgradeStartResult {
-  // 优先从远端下载升级脚本，避免使用本地可能过时的版本
-  const scriptPath = downloadRemoteUpgradeScript() || (() => {
-    const local = getUpgradeScriptPath();
-    if (!local) return null;
-    console.log(`[qqbot] fireHotUpgrade: remote download failed, falling back to local script: ${local}`);
-    return copyScriptToTemp(local) || local;
-  })();
+function fireHotUpgrade(targetVersion?: string, pkg?: string, useLocal?: boolean): HotUpgradeStartResult {
+  // --local: 直接使用本地脚本，跳过远端下载
+  // 默认: 优先从远端下载升级脚本，避免使用本地可能过时的版本
+  const scriptPath = useLocal
+    ? (() => {
+      const local = getUpgradeScriptPath();
+      if (!local) return null;
+      console.log(`[qqbot] fireHotUpgrade: --local specified, using local script: ${local}`);
+      return copyScriptToTemp(local) || local;
+    })()
+    : downloadRemoteUpgradeScript() || (() => {
+      const local = getUpgradeScriptPath();
+      if (!local) return null;
+      console.log(`[qqbot] fireHotUpgrade: remote download failed, falling back to local script: ${local}`);
+      return copyScriptToTemp(local) || local;
+    })();
   if (!scriptPath) return { ok: false, reason: "no-script" };
 
   const cli = findCli();
@@ -772,16 +780,17 @@ function fireHotUpgrade(targetVersion?: string): HotUpgradeStartResult {
       "-File", scriptPath,
       "-NoRestart",
       ...(targetVersion ? ["-Version", targetVersion] : []),
+      ...(pkg ? ["-Pkg", pkg] : []),
     ];
   } else {
     // Mac / Linux: bash 执行 .sh
     const bash = findBash();
     if (!bash) return { ok: false, reason: "no-bash" };
     shell = bash;
-    shellArgs = [scriptPath, "--no-restart", ...(targetVersion ? ["--version", targetVersion] : [])];
+    shellArgs = [scriptPath, "--no-restart", ...(targetVersion ? ["--version", targetVersion] : []), ...(pkg ? ["--pkg", pkg] : [])];
   }
 
-  console.log(`[qqbot] fireHotUpgrade: shell=${shell}, script=${scriptPath}, cli=${cli}, target=${targetVersion || "latest"}`);
+  console.log(`[qqbot] fireHotUpgrade: shell=${shell}, script=${scriptPath}, cli=${cli}, target=${targetVersion || "latest"}, pkg=${pkg || "default"}`);
 
   // 异步执行升级脚本
   execFile(shell, shellArgs, {
@@ -894,11 +903,13 @@ registerCommand({
     `/bot-upgrade              检查是否有新版本`,
     `/bot-upgrade --latest     确认升级到最新版本（需 upgradeMode=hot-reload）`,
     `/bot-upgrade --version X  升级到指定版本（需 upgradeMode=hot-reload）`,
+    `/bot-upgrade --pkg scope/name  指定 npm 包（如 ryantest/openclaw-qqbot）`,
     `/bot-upgrade --force      强制重新安装当前版本（需 upgradeMode=hot-reload）`,
+    `/bot-upgrade --local      使用本地升级脚本（跳过远端下载）`,
   ].join("\n"),
   handler: async (ctx) => {
     const url = ctx.accountConfig?.upgradeUrl || DEFAULT_UPGRADE_URL;
-    const upgradeMode = ctx.accountConfig?.upgradeMode || "doc";
+    const upgradeMode = ctx.accountConfig?.upgradeMode || "hot-reload";
     const args = ctx.args.trim();
     const info = await getUpdateInfo();
 
@@ -949,7 +960,9 @@ registerCommand({
 
     let isForce = false;
     let isLatest = false;
+    let isLocal = false;
     let versionArg: string | undefined;
+    let pkgArg: string | undefined;
     const tokens = args ? args.split(/\s+/).filter(Boolean) : [];
     for (let i = 0; i < tokens.length; i += 1) {
       const t = tokens[i]!;
@@ -961,6 +974,27 @@ registerCommand({
         isLatest = true;
         continue;
       }
+      if (t === "--local") {
+        isLocal = true;
+        continue;
+      }
+      if (t === "--pkg") {
+        const next = tokens[i + 1];
+        if (!next || next.startsWith("--")) {
+          return `❌ 参数错误：--pkg 需要包名\n\n示例：/bot-upgrade --pkg ryantest/openclaw-qqbot`;
+        }
+        pkgArg = next;
+        i += 1;
+        continue;
+      }
+      if (t.startsWith("--pkg=")) {
+        const v = t.slice("--pkg=".length).trim();
+        if (!v) {
+          return `❌ 参数错误：--pkg 需要包名\n\n示例：/bot-upgrade --pkg ryantest/openclaw-qqbot`;
+        }
+        pkgArg = v;
+        continue;
+      }
       if (t === "--version") {
         const next = tokens[i + 1];
         if (!next || next.startsWith("--")) {
@@ -1022,9 +1056,17 @@ registerCommand({
       ].join("\n");
     }
 
+    // 解析 npm 包名：--pkg 参数 > 配置项 upgradePkg > 默认
+    // 支持 "scope/name"（自动补 @）和 "@scope/name" 两种格式
+    let upgradePkg = pkgArg || ctx.accountConfig?.upgradePkg;
+    if (upgradePkg) {
+      upgradePkg = upgradePkg.trim();
+      if (!upgradePkg.startsWith("@")) upgradePkg = `@${upgradePkg}`;
+    }
+
     // ── --version 指定版本：先校验版本号是否存在 ──
     if (versionArg) {
-      const exists = await checkVersionExists(versionArg);
+      const exists = await checkVersionExists(versionArg, upgradePkg);
       if (!exists) {
         return `❌ 版本 ${versionArg} 不存在，请检查版本号`;
       }
@@ -1077,7 +1119,7 @@ registerCommand({
     preUpgradeCredentialBackup(ctx.accountId, ctx.appId);
 
     // 异步执行升级
-    const startResult = fireHotUpgrade(targetVersion);
+    const startResult = fireHotUpgrade(targetVersion, upgradePkg, isLocal);
     if (!startResult.ok) {
       _upgrading = false;
       if (startResult.reason === "no-script") {

package/src/tools/remind.ts

@@ -1,5 +1,5 @@
 import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
-import { getRequestTarget } from "../request-context.js";
+import { getRequestTarget, getRequestAccountId } from "../request-context.js";
 
 // ========== 类型定义 ==========
 
@@ -134,7 +134,7 @@ function generateJobName(content: string): string {
 /**
  * 构建一次性提醒的 cron 工具参数
  */
-function buildOnceJob(params: RemindParams, delayMs: number, to: string) {
+function buildOnceJob(params: RemindParams, delayMs: number, to: string, accountId: string) {
   const atMs = Date.now() + delayMs;
   const content = params.content!;
   const name = params.name || generateJobName(content);
@@ -150,9 +150,12 @@ function buildOnceJob(params: RemindParams, delayMs: number, to: string) {
       payload: {
         kind: "agentTurn",
         message: buildReminderPrompt(content),
-        deliver: true,
+      },
+      delivery: {
+        mode: "announce",
         channel: "qqbot",
         to,
+        accountId,
       },
     },
   };
@@ -161,7 +164,7 @@ function buildOnceJob(params: RemindParams, delayMs: number, to: string) {
 /**
  * 构建周期提醒的 cron 工具参数
  */
-function buildCronJob(params: RemindParams, to: string) {
+function buildCronJob(params: RemindParams, to: string, accountId: string) {
   const content = params.content!;
   const name = params.name || generateJobName(content);
   const tz = params.timezone || "Asia/Shanghai";
@@ -176,9 +179,12 @@ function buildCronJob(params: RemindParams, to: string) {
       payload: {
         kind: "agentTurn",
         message: buildReminderPrompt(content),
-        deliver: true,
+      },
+      delivery: {
+        mode: "announce",
         channel: "qqbot",
         to,
+        accountId,
       },
     },
   };
@@ -256,6 +262,8 @@ export function registerRemindTool(api: OpenClawPluginApi): void {
         if (!resolvedTo) {
           return json({ error: "action=add 时无法确定投递目标地址。请稍后重试。" });
         }
+        // 从请求上下文获取当前账户 ID（多账户场景），fallback 到 "default"
+        const resolvedAccountId = getRequestAccountId() || "default";
         if (!p.time) {
           return json({ error: "action=add 时 time（时间）为必填参数。示例：\"5m\"、\"1h30m\"、\"0 8 * * *\"" });
         }
@@ -263,9 +271,9 @@ export function registerRemindTool(api: OpenClawPluginApi): void {
         // 判断是 cron 表达式还是相对时间
         if (isCronExpression(p.time)) {
           // 周期提醒
-          const cronJob = buildCronJob(p, resolvedTo);
+          const cronJob = buildCronJob(p, resolvedTo, resolvedAccountId);
           return json({
-            _instruction: "请立即使用 cron 工具执行以下参数，然后回复用户提醒已设置",
+            _instruction: "请立即使用 cron 工具，将 cronParams 的值原样作为参数传入（不要修改或省略任何字段，特别是 delivery.accountId），然后回复用户提醒已设置",
             cronParams: cronJob,
             summary: `⏰ 周期提醒: "${p.content}" (${p.time}, tz=${p.timezone || "Asia/Shanghai"})`,
           });
@@ -285,9 +293,9 @@ export function registerRemindTool(api: OpenClawPluginApi): void {
           return json({ error: "提醒时间不能少于 30 秒" });
         }
 
-        const onceJob = buildOnceJob(p, delayMs, resolvedTo);
+        const onceJob = buildOnceJob(p, delayMs, resolvedTo, resolvedAccountId);
         return json({
-          _instruction: "请立即使用 cron 工具执行以下参数，然后回复用户提醒已设置",
+          _instruction: "请立即使用 cron 工具，将 cronParams 的值原样作为参数传入（不要修改或省略任何字段，特别是 delivery.accountId），然后回复用户提醒已设置",
           cronParams: onceJob,
           summary: `⏰ ${formatDelay(delayMs)}后提醒: "${p.content}"`,
         });

package/src/types.ts

@@ -97,10 +97,17 @@ export interface QQBotAccountConfig {
   upgradeUrl?: string;
   /**
    * /bot-upgrade 指令的行为模式
-   * - "doc"：展示升级文档链接（默认，安全模式）
-   * - "hot-reload"：检测到新版本时直接执行 npm 升级脚本进行热更新
+   * - "doc"：展示升级文档链接（安全模式）
+   * - "hot-reload"：检测到新版本时直接执行 npm 升级脚本进行热更新（默认）
    */
   upgradeMode?: "doc" | "hot-reload";
+  /**
+   * /bot-upgrade 热更新时使用的 npm 包名
+   * 支持 "scope/name"（自动补 @）或 "@scope/name" 格式
+   * 默认: "@tencent-connect/openclaw-qqbot"
+   * 示例: "ryantest/openclaw-qqbot"
+   */
+  upgradePkg?: string;
   /**
    * 出站消息合并回复（debounce）配置
    * 当短时间内收到多次 deliver 时，将文本合并为一条消息发送，避免消息轰炸

package/src/update-checker.ts

@@ -122,9 +122,12 @@ export async function getUpdateInfo(): Promise<UpdateInfo> {
 /**
  * 检查指定版本是否存在于 npm registry
  * 用于 /bot-upgrade --version 的前置校验
+ * @param version 要检查的版本号
+ * @param pkgName 可选的包名（如 "@ryantest/openclaw-qqbot"），默认使用内置包名
  */
-export async function checkVersionExists(version: string): Promise<boolean> {
-  for (const baseUrl of REGISTRIES) {
+export async function checkVersionExists(version: string, pkgName?: string): Promise<boolean> {
+  const registries = pkgName ? buildRegistries(pkgName) : REGISTRIES;
+  for (const baseUrl of registries) {
     try {
       const url = `${baseUrl}/${version}`;
       const json = await fetchJson(url, 10_000);
@@ -136,6 +139,15 @@ export async function checkVersionExists(version: string): Promise<boolean> {
   return false;
 }
 
+/** 根据自定义包名构建 registry URL 列表 */
+function buildRegistries(pkgName: string): string[] {
+  const encoded = encodeURIComponent(pkgName);
+  return [
+    `https://registry.npmjs.org/${encoded}`,
+    `https://registry.npmmirror.com/${encoded}`,
+  ];
+}
+
 function compareVersions(a: string, b: string): number {
   const parse = (v: string) => {
     const clean = v.replace(/^v/, "");