@tencent-connect/openclaw-qqbot 1.6.4-alpha.18 → 1.6.4-alpha.20

package/dist/src/slash-commands.js

@@ -34,6 +34,7 @@ function getFrameworkVersion() {
     if (_frameworkVersion !== null)
         return _frameworkVersion;
     try {
+        // 先尝试 PATH 中的 CLI
         for (const cli of ["openclaw", "clawdbot", "moltbot"]) {
             try {
                 const out = execFileSync(cli, ["--version"], { timeout: 3000, encoding: "utf8" }).trim();
@@ -47,6 +48,15 @@ function getFrameworkVersion() {
                 continue;
             }
         }
+        // 尝试 findCli() 找到的完整路径
+        const cliPath = findCli();
+        if (cliPath) {
+            const out = execCliSync(cliPath, ["--version"]);
+            if (out) {
+                _frameworkVersion = out;
+                return _frameworkVersion;
+            }
+        }
     }
     catch {
         // fallback
@@ -260,7 +270,12 @@ function saveUpgradeGreetingTarget(accountId, appId, openid) {
 }
 // ============ 热更新 ============
 /**
- * 找到 CLI 命令名（openclaw / clawdbot / moltbot）
+ * 找到 CLI 命令名或完整路径（openclaw / clawdbot / moltbot）
+ *
+ * 查找策略：
+ * 1. 系统 PATH（where / which）
+ * 2. 打包环境（HoldClaw / QQAIO）：从当前文件路径向上推断 CLI 位置
+ * 3. ~/.openclaw/bin/ 等常见安装路径
  */
 function findCli() {
     const whichCmd = isWindows() ? "where" : "which";
@@ -273,10 +288,90 @@ function findCli() {
             continue;
         }
     }
+    // 打包环境 fallback：从当前文件路径推断 CLI
+    // 典型路径: .../gateway/node_modules/openclaw-qqbot/dist/src/slash-commands.js
+    // CLI 位于: .../gateway/node_modules/openclaw/openclaw.mjs
+    // 或者:     .../gateway/node_modules/.bin/openclaw
+    try {
+        const currentFile = fileURLToPath(import.meta.url);
+        const currentDir = path.dirname(currentFile);
+        // 向上查找 node_modules 目录
+        let dir = currentDir;
+        for (let i = 0; i < 10; i++) {
+            const basename = path.basename(dir);
+            if (basename === "node_modules") {
+                // 检查 .bin 下的 CLI
+                for (const cli of ["openclaw", "clawdbot", "moltbot"]) {
+                    const binName = isWindows() ? `${cli}.cmd` : cli;
+                    const binPath = path.join(dir, ".bin", binName);
+                    if (fs.existsSync(binPath))
+                        return binPath;
+                }
+                // 检查 openclaw/openclaw.mjs（直接通过 node 调用）
+                for (const cli of ["openclaw", "clawdbot", "moltbot"]) {
+                    const mjsPath = path.join(dir, cli, `${cli}.mjs`);
+                    if (fs.existsSync(mjsPath))
+                        return mjsPath;
+                }
+                break;
+            }
+            const parent = path.dirname(dir);
+            if (parent === dir)
+                break;
+            dir = parent;
+        }
+    }
+    catch {
+        // ignore
+    }
+    // ~/.openclaw/bin/ 等常见安装路径
+    const homeDir = getHomeDir();
+    for (const cli of ["openclaw", "clawdbot", "moltbot"]) {
+        const ext = isWindows() ? ".exe" : "";
+        const candidates = [
+            path.join(homeDir, `.${cli}`, "bin", `${cli}${ext}`),
+            path.join(homeDir, `.${cli}`, `${cli}${ext}`),
+        ];
+        for (const p of candidates) {
+            if (fs.existsSync(p))
+                return p;
+        }
+    }
     return null;
 }
 /**
- * 找到升级脚本路径（兼容源码运行、dist 运行、已安装扩展目录）
+ * 同步执行 CLI 命令。
+ * 当 cliPath 是 .mjs 文件时，自动通过 process.execPath (node) 调用。
+ */
+function execCliSync(cliPath, args) {
+    try {
+        if (cliPath.endsWith(".mjs")) {
+            return execFileSync(process.execPath, [cliPath, ...args], {
+                timeout: 5000, encoding: "utf8", stdio: "pipe",
+            }).trim() || null;
+        }
+        return execFileSync(cliPath, args, {
+            timeout: 5000, encoding: "utf8", stdio: "pipe",
+        }).trim() || null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * 异步执行 CLI 命令。
+ * 当 cliPath 是 .mjs 文件时，自动通过 process.execPath (node) 调用。
+ */
+function execCliAsync(cliPath, args, opts, cb) {
+    if (cliPath.endsWith(".mjs")) {
+        execFile(process.execPath, [cliPath, ...args], opts, cb);
+    }
+    else {
+        execFile(cliPath, args, opts, cb);
+    }
+}
+/**
+ * 找到升级脚本路径（兼容源码运行、dist 运行、已安装扩展目录、打包环境）
  * Windows 优先查找 .ps1，Mac/Linux 查找 .sh
  */
 function getUpgradeScriptPath() {
@@ -284,10 +379,24 @@ function getUpgradeScriptPath() {
     const currentDir = path.dirname(currentFile);
     const scriptName = isWindows() ? "upgrade-via-npm.ps1" : "upgrade-via-npm.sh";
     const candidates = [
+        // 源码运行: src/slash-commands.ts → ../../scripts/
+        // dist 运行: dist/src/slash-commands.js → ../../scripts/
         path.resolve(currentDir, "..", "..", "scripts", scriptName),
+        // npm 安装: node_modules/@tencent-connect/openclaw-qqbot/dist/src → ../../scripts
         path.resolve(currentDir, "..", "scripts", scriptName),
         path.resolve(process.cwd(), "scripts", scriptName),
     ];
+    // 向上查找包含 scripts/ 的祖先目录（适应各种嵌套深度的打包环境）
+    let dir = currentDir;
+    for (let i = 0; i < 6; i++) {
+        const candidate = path.join(dir, "scripts", scriptName);
+        if (!candidates.includes(candidate))
+            candidates.push(candidate);
+        const parent = path.dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
     const homeDir = getHomeDir();
     for (const cli of ["openclaw", "clawdbot", "moltbot"]) {
         candidates.push(path.join(homeDir, `.${cli}`, "extensions", "openclaw-qqbot", "scripts", scriptName));
@@ -505,12 +614,12 @@ function fireHotUpgrade(targetVersion) {
         // 确保新进程启动时读到的是 npm source，不会被本地源码覆盖。
         switchPluginSourceToNpm();
         // 文件替换成功，立即触发 gateway restart
-        execFile(cli, ["gateway", "restart"], { timeout: 30_000 }, (restartErr) => {
+        execCliAsync(cli, ["gateway", "restart"], { timeout: 30_000 }, (restartErr) => {
             if (restartErr) {
                 // restart 失败，尝试 stop + start 作为 fallback
-                execFile(cli, ["gateway", "stop"], { timeout: 10_000 }, () => {
+                execCliAsync(cli, ["gateway", "stop"], { timeout: 10_000 }, () => {
                     setTimeout(() => {
-                        execFile(cli, ["gateway", "start"], { timeout: 30_000 }, () => { });
+                        execCliAsync(cli, ["gateway", "start"], { timeout: 30_000 }, () => { });
                     }, 1000);
                 });
             }
@@ -724,14 +833,41 @@ registerCommand({
         return resultLines.join("\n");
     },
 });
+/**
+ * 从 openclaw.json / clawdbot.json / moltbot.json 的 logging.file 配置中
+ * 提取用户自定义的日志文件路径（直接文件路径，非目录）。
+ */
+function getConfiguredLogFiles() {
+    const homeDir = getHomeDir();
+    const files = [];
+    for (const cli of ["openclaw", "clawdbot", "moltbot"]) {
+        try {
+            const cfgPath = path.join(homeDir, `.${cli}`, `${cli}.json`);
+            if (!fs.existsSync(cfgPath))
+                continue;
+            const cfg = JSON.parse(fs.readFileSync(cfgPath, "utf8"));
+            const logFile = cfg?.logging?.file;
+            if (logFile && typeof logFile === "string") {
+                files.push(path.resolve(logFile));
+            }
+            break;
+        }
+        catch {
+            // ignore
+        }
+    }
+    return files;
+}
 /**
  * /bot-logs — 导出本地日志文件
  *
  * 日志定位策略（兼容腾讯云/各云厂商不同安装路径）：
- * 1. 优先使用 *_STATE_DIR 环境变量（OPENCLAW/CLAWDBOT/MOLTBOT）
+ * 0. 优先从 openclaw.json 的 logging.file 配置中读取自定义日志路径（最精确）
+ * 1. 使用 *_STATE_DIR 环境变量（OPENCLAW/CLAWDBOT/MOLTBOT）
  * 2. 扫描常见状态目录：~/.openclaw, ~/.clawdbot, ~/.moltbot 及其 logs 子目录
  * 3. 扫描 home/cwd/AppData 下名称包含 openclaw/clawdbot/moltbot 的目录
- * 4. 在候选目录中选取最近更新的日志文件（gateway/openclaw/clawdbot/moltbot）
+ * 4. 扫描 /var/log 下的 openclaw/clawdbot/moltbot 目录
+ * 5. 在候选目录中选取最近更新的日志文件（gateway/openclaw/clawdbot/moltbot）
  */
 function collectCandidateLogDirs() {
     const homeDir = getHomeDir();
@@ -748,6 +884,11 @@ function collectCandidateLogDirs() {
         pushDir(stateDir);
         pushDir(path.join(stateDir, "logs"));
     };
+    // 0. 从配置文件的 logging.file 提取目录
+    for (const logFile of getConfiguredLogFiles()) {
+        pushDir(path.dirname(logFile));
+    }
+    // 1. 环境变量 *_STATE_DIR
     for (const [key, value] of Object.entries(process.env)) {
         if (!value)
             continue;
@@ -755,10 +896,12 @@ function collectCandidateLogDirs() {
             pushStateDir(value);
         }
     }
+    // 2. 常见状态目录
     for (const name of [".openclaw", ".clawdbot", ".moltbot", "openclaw", "clawdbot", "moltbot"]) {
         pushDir(path.join(homeDir, name));
         pushDir(path.join(homeDir, name, "logs"));
     }
+    // 3. home/cwd/AppData 下包含 openclaw/clawdbot/moltbot 的子目录
     const searchRoots = new Set([
         homeDir,
         process.cwd(),
@@ -785,6 +928,12 @@ function collectCandidateLogDirs() {
             // 无权限或不存在，跳过
         }
     }
+    // 4. /var/log 下的常见日志目录（Linux 服务器部署场景）
+    if (!isWindows()) {
+        for (const name of ["openclaw", "clawdbot", "moltbot"]) {
+            pushDir(path.join("/var/log", name));
+        }
+    }
     return Array.from(dirs);
 }
 function collectRecentLogFiles(logDirs) {
@@ -805,6 +954,10 @@ function collectRecentLogFiles(logDirs) {
             // 文件不存在或无权限
         }
     };
+    // 优先级最高：用户在 openclaw.json logging.file 中显式配置的日志文件
+    for (const logFile of getConfiguredLogFiles()) {
+        pushFile(logFile, path.dirname(logFile));
+    }
     for (const dir of logDirs) {
         pushFile(path.join(dir, "gateway.log"), dir);
         pushFile(path.join(dir, "gateway.err.log"), dir);
@@ -843,8 +996,24 @@ registerCommand({
         const logDirs = collectCandidateLogDirs();
         const recentFiles = collectRecentLogFiles(logDirs).slice(0, 4);
         if (recentFiles.length === 0) {
-            const searched = logDirs.map(d => `  - ${d}`).join("\n");
-            return `⚠️ 未找到日志文件\n\n已搜索以下路径：\n${searched}`;
+            const existingDirs = logDirs.filter(d => { try {
+                return fs.existsSync(d);
+            }
+            catch {
+                return false;
+            } });
+            const searched = existingDirs.length > 0
+                ? existingDirs.map(d => `  • ${d}`).join("\n")
+                : logDirs.slice(0, 6).map(d => `  • ${d}`).join("\n") + (logDirs.length > 6 ? `\n  …及其他 ${logDirs.length - 6} 个路径` : "");
+            return [
+                `⚠️ 未找到日志文件`,
+                ``,
+                `已搜索以下${existingDirs.length > 0 ? "已存在的" : ""}路径：`,
+                searched,
+                ``,
+                `💡 如果日志在自定义路径，请在配置文件中添加：`,
+                `  "logging": { "file": "/path/to/your/logfile.log" }`,
+            ].join("\n");
         }
         const lines = [];
         let totalIncluded = 0;

package/dist/src/startup-greeting.d.ts

@@ -1,7 +1,8 @@
 /**
  * 启动问候语系统：首次安装/版本更新 vs 普通重启
  */
-export declare function getStartupGreetingText(version: string): string;
+export declare function getFirstLaunchGreetingText(): string;
+export declare function getUpgradeGreetingText(version: string): string;
 export type StartupMarkerData = {
     version?: string;
     startedAt?: string;
@@ -13,10 +14,11 @@ export type StartupMarkerData = {
 export declare function readStartupMarker(): StartupMarkerData;
 export declare function writeStartupMarker(data: StartupMarkerData): void;
 /**
- * 判断是否需要发送"灵魂上线"问候：
- * - 首次安装 / 版本变更：可发送
- * - 同版本：不发送
- * - 同版本近期失败：冷却期内不重试，减少噪音
+ * 判断是否需要发送启动问候：
+ * - 首次启动（无 marker）→ "灵魂已上线"
+ * - 版本变更 → "已更新至 vX.Y.Z"
+ * - 同版本 → 不发送
+ * - 同版本近期失败 → 冷却期内不重试
  */
 export declare function getStartupGreetingPlan(): {
     shouldSend: boolean;

package/dist/src/startup-greeting.js

@@ -7,7 +7,10 @@ import { getQQBotDataDir } from "./utils/platform.js";
 import { getPluginVersion } from "./slash-commands.js";
 const STARTUP_MARKER_FILE = path.join(getQQBotDataDir("data"), "startup-marker.json");
 const STARTUP_GREETING_RETRY_COOLDOWN_MS = 10 * 60 * 1000;
-export function getStartupGreetingText(version) {
+export function getFirstLaunchGreetingText() {
+    return `Haha，我的'灵魂'已上线，随时等你吩咐。`;
+}
+export function getUpgradeGreetingText(version) {
     return `🎉 QQBot 插件已更新至 v${version}，在线等候你的吩咐。`;
 }
 export function readStartupMarker() {
@@ -31,10 +34,11 @@ export function writeStartupMarker(data) {
     }
 }
 /**
- * 判断是否需要发送"灵魂上线"问候：
- * - 首次安装 / 版本变更：可发送
- * - 同版本：不发送
- * - 同版本近期失败：冷却期内不重试，减少噪音
+ * 判断是否需要发送启动问候：
+ * - 首次启动（无 marker）→ "灵魂已上线"
+ * - 版本变更 → "已更新至 vX.Y.Z"
+ * - 同版本 → 不发送
+ * - 同版本近期失败 → 冷却期内不重试
  */
 export function getStartupGreetingPlan() {
     const currentVersion = getPluginVersion();
@@ -48,7 +52,11 @@ export function getStartupGreetingPlan() {
             return { shouldSend: false, version: currentVersion, reason: "cooldown" };
         }
     }
-    return { shouldSend: true, greeting: getStartupGreetingText(currentVersion), version: currentVersion };
+    const isFirstLaunch = !marker.version;
+    const greeting = isFirstLaunch
+        ? getFirstLaunchGreetingText()
+        : getUpgradeGreetingText(currentVersion);
+    return { shouldSend: true, greeting, version: currentVersion };
 }
 export function markStartupGreetingSent(version) {
     writeStartupMarker({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tencent-connect/openclaw-qqbot",
-  "version": "1.6.4-alpha.18",
+  "version": "1.6.4-alpha.20",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/bot-logs-2026-03-21T11-21-47(2).txt

@@ -0,0 +1,46 @@
+
+========== gateway.log (last 44 of 44 lines) ==========
+from: C:\Users\v_qachchen\.openclaw
+[2026-03-20T15:55:33.816Z] state: stopped → starting
+[2026-03-20T15:55:33.819Z] [extract] 检测到 runtime.tar.gz，开始解压...
+[2026-03-20T15:55:37.282Z] [extract] runtime.tar.gz 解压完成 (3.5s)
+[2026-03-20T15:55:37.286Z] [extract] 检测到 gateway.tar.gz，开始解压...
+[2026-03-20T15:56:05.916Z] [extract] gateway.tar.gz 解压完成 (28.6s)
+[2026-03-20T15:56:05.924Z] --- gateway start ---
+[2026-03-20T15:56:05.926Z] platform=win32 arch=x64 packaged=true
+[2026-03-20T15:56:05.927Z] resourcesPath=C:\Users\v_qachchen\AppData\Local\Programs\HoldClaw\resources\resources
+[2026-03-20T15:56:05.928Z] nodeBin=C:\Users\v_qachchen\AppData\Local\Programs\HoldClaw\resources\resources\runtime\node.exe exists=true
+[2026-03-20T15:56:05.928Z] entry=C:\Users\v_qachchen\AppData\Local\Programs\HoldClaw\resources\resources\gateway\node_modules\openclaw\openclaw.mjs exists=true
+[2026-03-20T15:56:05.929Z] cwd=C:\Users\v_qachchen\.openclaw\workspace exists=true
+[2026-03-20T15:56:05.929Z] token=a98d...06c4 port=19789
+[2026-03-20T15:56:05.978Z] TTS 未配置，使用默认 SiliconFlow URL
+[2026-03-20T15:56:05.979Z] spawn: C:\Users\v_qachchen\AppData\Local\Programs\HoldClaw\resources\resources\runtime\node.exe C:\Users\v_qachchen\AppData\Local\Programs\HoldClaw\resources\resources\gateway\node_modules\openclaw\openclaw.mjs gateway run --port 19789 --bind loopback
+[2026-03-20T15:56:14.259Z] stdout: |
+o  Doctor warnings ------------------------------------------------------+
+|                                                                        |
+|  - channels.imessage.groupPolicy is "allowlist" but groupAllowFrom is  |
+|    empty — this channel does not fall back to allowFrom, so all group  |
+|    messages will be silently dropped. Add sender IDs to                |
+|    channels.imessage.groupAllowFrom, or set groupPolicy to "open".     |
+|                                                                        |
++------------------------------------------------------------------------+
+[2026-03-20T15:56:44.457Z] stdout: 2026-03-20T15:56:44.457Z [canvas] host mounted at http://127.0.0.1:19789/__openclaw__/canvas/ (root C:\Users\v_qachchen\.openclaw\canvas)
+[2026-03-20T15:56:44.786Z] stdout: 2026-03-20T15:56:44.784Z [heartbeat] started
+[2026-03-20T15:56:44.791Z] stdout: 2026-03-20T15:56:44.791Z [health-monitor] started (interval: 300s, startup-grace: 60s, channel-connect-grace: 120s)
+[2026-03-20T15:56:44.804Z] stdout: 2026-03-20T15:56:44.802Z [gateway] agent model: custom/hy-hunyuan-instruct
+[2026-03-20T15:56:44.806Z] stdout: 2026-03-20T15:56:44.806Z [gateway] listening on ws://127.0.0.1:19789, ws://[::1]:19789 (PID 224544)
+[2026-03-20T15:56:44.812Z] stdout: 2026-03-20T15:56:44.812Z [gateway] log file: \tmp\openclaw\openclaw-2026-03-20.log
+[2026-03-20T15:56:44.929Z] stdout: 2026-03-20T15:56:44.929Z [browser/server] Browser control listening on http://127.0.0.1:19791/ (auth=token)
+[2026-03-20T15:56:45.150Z] health check passed, child alive
+[2026-03-20T15:56:45.151Z] state: starting → running
+[2026-03-20T15:56:46.272Z] stdout: 2026-03-20T15:56:46.112Z [hooks:loader] Registered hook: boot-md -> gateway:startup
+2026-03-20T15:56:46.179Z [hooks:loader] Registered hook: bootstrap-extra-files -> agent:bootstrap
+2026-03-20T15:56:46.247Z [hooks:loader] Registered hook: command-logger -> command
+[2026-03-20T15:56:46.273Z] stderr: 2026-03-20T15:56:46.166Z [ws] closed before connect conn=bd4ae208-a072-4475-8c6b-63daad0e7025 remote=127.0.0.1 fwd=n/a origin=file:// host=127.0.0.1:19789 ua=Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) HoldClaw/1.0.14 Chrome/144.0.7559.225 Electron/40.7.0 Safari/537.36 code=1006 reason=n/a
+2026-03-20T15:56:46.235Z [ws] unauthorized conn=723433fc-d3d5-4065-b919-924e0992dcfe remote=127.0.0.1 client=openclaw-control-ui webchat vdev reason=token_mismatch
+2026-03-20T15:56:46.252Z [ws] closed before connect conn=723433fc-d3d5-4065-b919-924e0992dcfe remote=127.0.0.1 fwd=n/a origin=file:// host=127.0.0.1:19789 ua=Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) HoldClaw/1.0.14 Chrome/144.0.7559.225 Electron/40.7.0 Safari/537.36 code=1008 reason=unauthorized: gateway token mismatch (open the dashboard URL and paste the token in Control UI settings)
+[2026-03-20T15:56:46.318Z] stdout: 2026-03-20T15:56:46.302Z [hooks:loader] Registered hook: session-memory -> command:new, command:reset
+2026-03-20T15:56:46.308Z [hooks] loaded 4 internal hook handlers
+[2026-03-20T15:56:46.637Z] stdout: 2026-03-20T15:56:46.637Z [gateway] update available (latest): v2026.3.13 (current v2026.3.2). Run: openclaw update
+[2026-03-20T15:56:47.076Z] stdout: 2026-03-20T15:56:47.076Z [gateway] device pairing auto-approved device=bd0fa7fe507891dfe0875c53fd38d0582145228b1478b4e62ad102f07d9254df role=operator
+[2026-03-20T15:56:47.081Z] stdout: 2026-03-20T15:56:47.081Z [ws] webchat connected conn=200f754d-9791-4dcc-bfaa-93c839311f65 remote=127.0.0.1 client=openclaw-control-ui webchat vdev

package/src/slash-commands.ts

@@ -36,6 +36,7 @@ let _frameworkVersion: string | null = null;
 function getFrameworkVersion(): string {
   if (_frameworkVersion !== null) return _frameworkVersion;
   try {
+    // 先尝试 PATH 中的 CLI
     for (const cli of ["openclaw", "clawdbot", "moltbot"]) {
       try {
         const out = execFileSync(cli, ["--version"], { timeout: 3000, encoding: "utf8" }).trim();
@@ -48,6 +49,15 @@ function getFrameworkVersion(): string {
         continue;
       }
     }
+    // 尝试 findCli() 找到的完整路径
+    const cliPath = findCli();
+    if (cliPath) {
+      const out = execCliSync(cliPath, ["--version"]);
+      if (out) {
+        _frameworkVersion = out;
+        return _frameworkVersion;
+      }
+    }
   } catch {
     // fallback
   }
@@ -346,7 +356,12 @@ function saveUpgradeGreetingTarget(accountId: string, appId: string, openid: str
 // ============ 热更新 ============
 
 /**
- * 找到 CLI 命令名（openclaw / clawdbot / moltbot）
+ * 找到 CLI 命令名或完整路径（openclaw / clawdbot / moltbot）
+ *
+ * 查找策略：
+ * 1. 系统 PATH（where / which）
+ * 2. 打包环境（HoldClaw / QQAIO）：从当前文件路径向上推断 CLI 位置
+ * 3. ~/.openclaw/bin/ 等常见安装路径
  */
 function findCli(): string | null {
   const whichCmd = isWindows() ? "where" : "which";
@@ -358,11 +373,95 @@ function findCli(): string | null {
       continue;
     }
   }
+
+  // 打包环境 fallback：从当前文件路径推断 CLI
+  // 典型路径: .../gateway/node_modules/openclaw-qqbot/dist/src/slash-commands.js
+  // CLI 位于: .../gateway/node_modules/openclaw/openclaw.mjs
+  // 或者:     .../gateway/node_modules/.bin/openclaw
+  try {
+    const currentFile = fileURLToPath(import.meta.url);
+    const currentDir = path.dirname(currentFile);
+
+    // 向上查找 node_modules 目录
+    let dir = currentDir;
+    for (let i = 0; i < 10; i++) {
+      const basename = path.basename(dir);
+      if (basename === "node_modules") {
+        // 检查 .bin 下的 CLI
+        for (const cli of ["openclaw", "clawdbot", "moltbot"]) {
+          const binName = isWindows() ? `${cli}.cmd` : cli;
+          const binPath = path.join(dir, ".bin", binName);
+          if (fs.existsSync(binPath)) return binPath;
+        }
+        // 检查 openclaw/openclaw.mjs（直接通过 node 调用）
+        for (const cli of ["openclaw", "clawdbot", "moltbot"]) {
+          const mjsPath = path.join(dir, cli, `${cli}.mjs`);
+          if (fs.existsSync(mjsPath)) return mjsPath;
+        }
+        break;
+      }
+      const parent = path.dirname(dir);
+      if (parent === dir) break;
+      dir = parent;
+    }
+  } catch {
+    // ignore
+  }
+
+  // ~/.openclaw/bin/ 等常见安装路径
+  const homeDir = getHomeDir();
+  for (const cli of ["openclaw", "clawdbot", "moltbot"]) {
+    const ext = isWindows() ? ".exe" : "";
+    const candidates = [
+      path.join(homeDir, `.${cli}`, "bin", `${cli}${ext}`),
+      path.join(homeDir, `.${cli}`, `${cli}${ext}`),
+    ];
+    for (const p of candidates) {
+      if (fs.existsSync(p)) return p;
+    }
+  }
+
   return null;
 }
 
 /**
- * 找到升级脚本路径（兼容源码运行、dist 运行、已安装扩展目录）
+ * 同步执行 CLI 命令。
+ * 当 cliPath 是 .mjs 文件时，自动通过 process.execPath (node) 调用。
+ */
+function execCliSync(cliPath: string, args: string[]): string | null {
+  try {
+    if (cliPath.endsWith(".mjs")) {
+      return execFileSync(process.execPath, [cliPath, ...args], {
+        timeout: 5000, encoding: "utf8", stdio: "pipe",
+      }).trim() || null;
+    }
+    return execFileSync(cliPath, args, {
+      timeout: 5000, encoding: "utf8", stdio: "pipe",
+    }).trim() || null;
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * 异步执行 CLI 命令。
+ * 当 cliPath 是 .mjs 文件时，自动通过 process.execPath (node) 调用。
+ */
+function execCliAsync(
+  cliPath: string,
+  args: string[],
+  opts: { timeout?: number; env?: NodeJS.ProcessEnv; windowsHide?: boolean },
+  cb: (error: Error | null, stdout: string, stderr: string) => void,
+): void {
+  if (cliPath.endsWith(".mjs")) {
+    execFile(process.execPath, [cliPath, ...args], opts, cb);
+  } else {
+    execFile(cliPath, args, opts, cb);
+  }
+}
+
+/**
+ * 找到升级脚本路径（兼容源码运行、dist 运行、已安装扩展目录、打包环境）
  * Windows 优先查找 .ps1，Mac/Linux 查找 .sh
  */
 function getUpgradeScriptPath(): string | null {
@@ -371,11 +470,24 @@ function getUpgradeScriptPath(): string | null {
   const scriptName = isWindows() ? "upgrade-via-npm.ps1" : "upgrade-via-npm.sh";
 
   const candidates = [
+    // 源码运行: src/slash-commands.ts → ../../scripts/
+    // dist 运行: dist/src/slash-commands.js → ../../scripts/
     path.resolve(currentDir, "..", "..", "scripts", scriptName),
+    // npm 安装: node_modules/@tencent-connect/openclaw-qqbot/dist/src → ../../scripts
     path.resolve(currentDir, "..", "scripts", scriptName),
     path.resolve(process.cwd(), "scripts", scriptName),
   ];
 
+  // 向上查找包含 scripts/ 的祖先目录（适应各种嵌套深度的打包环境）
+  let dir = currentDir;
+  for (let i = 0; i < 6; i++) {
+    const candidate = path.join(dir, "scripts", scriptName);
+    if (!candidates.includes(candidate)) candidates.push(candidate);
+    const parent = path.dirname(dir);
+    if (parent === dir) break;
+    dir = parent;
+  }
+
   const homeDir = getHomeDir();
   for (const cli of ["openclaw", "clawdbot", "moltbot"]) {
     candidates.push(path.join(homeDir, `.${cli}`, "extensions", "openclaw-qqbot", "scripts", scriptName));
@@ -601,12 +713,12 @@ function fireHotUpgrade(targetVersion?: string): HotUpgradeStartResult {
     switchPluginSourceToNpm();
 
     // 文件替换成功，立即触发 gateway restart
-    execFile(cli, ["gateway", "restart"], { timeout: 30_000 }, (restartErr) => {
+    execCliAsync(cli, ["gateway", "restart"], { timeout: 30_000 }, (restartErr) => {
       if (restartErr) {
         // restart 失败，尝试 stop + start 作为 fallback
-        execFile(cli, ["gateway", "stop"], { timeout: 10_000 }, () => {
+        execCliAsync(cli, ["gateway", "stop"], { timeout: 10_000 }, () => {
           setTimeout(() => {
-            execFile(cli, ["gateway", "start"], { timeout: 30_000 }, () => {});
+            execCliAsync(cli, ["gateway", "start"], { timeout: 30_000 }, () => {});
           }, 1000);
         });
       }
@@ -841,14 +953,40 @@ registerCommand({
   },
 });
 
+/**
+ * 从 openclaw.json / clawdbot.json / moltbot.json 的 logging.file 配置中
+ * 提取用户自定义的日志文件路径（直接文件路径，非目录）。
+ */
+function getConfiguredLogFiles(): string[] {
+  const homeDir = getHomeDir();
+  const files: string[] = [];
+  for (const cli of ["openclaw", "clawdbot", "moltbot"]) {
+    try {
+      const cfgPath = path.join(homeDir, `.${cli}`, `${cli}.json`);
+      if (!fs.existsSync(cfgPath)) continue;
+      const cfg = JSON.parse(fs.readFileSync(cfgPath, "utf8"));
+      const logFile = cfg?.logging?.file;
+      if (logFile && typeof logFile === "string") {
+        files.push(path.resolve(logFile));
+      }
+      break;
+    } catch {
+      // ignore
+    }
+  }
+  return files;
+}
+
 /**
  * /bot-logs — 导出本地日志文件
  *
  * 日志定位策略（兼容腾讯云/各云厂商不同安装路径）：
- * 1. 优先使用 *_STATE_DIR 环境变量（OPENCLAW/CLAWDBOT/MOLTBOT）
+ * 0. 优先从 openclaw.json 的 logging.file 配置中读取自定义日志路径（最精确）
+ * 1. 使用 *_STATE_DIR 环境变量（OPENCLAW/CLAWDBOT/MOLTBOT）
  * 2. 扫描常见状态目录：~/.openclaw, ~/.clawdbot, ~/.moltbot 及其 logs 子目录
  * 3. 扫描 home/cwd/AppData 下名称包含 openclaw/clawdbot/moltbot 的目录
- * 4. 在候选目录中选取最近更新的日志文件（gateway/openclaw/clawdbot/moltbot）
+ * 4. 扫描 /var/log 下的 openclaw/clawdbot/moltbot 目录
+ * 5. 在候选目录中选取最近更新的日志文件（gateway/openclaw/clawdbot/moltbot）
  */
 function collectCandidateLogDirs(): string[] {
   const homeDir = getHomeDir();
@@ -866,6 +1004,12 @@ function collectCandidateLogDirs(): string[] {
     pushDir(path.join(stateDir, "logs"));
   };
 
+  // 0. 从配置文件的 logging.file 提取目录
+  for (const logFile of getConfiguredLogFiles()) {
+    pushDir(path.dirname(logFile));
+  }
+
+  // 1. 环境变量 *_STATE_DIR
   for (const [key, value] of Object.entries(process.env)) {
     if (!value) continue;
     if (/STATE_DIR$/i.test(key) && /(OPENCLAW|CLAWDBOT|MOLTBOT)/i.test(key)) {
@@ -873,11 +1017,13 @@ function collectCandidateLogDirs(): string[] {
     }
   }
 
+  // 2. 常见状态目录
   for (const name of [".openclaw", ".clawdbot", ".moltbot", "openclaw", "clawdbot", "moltbot"]) {
     pushDir(path.join(homeDir, name));
     pushDir(path.join(homeDir, name, "logs"));
   }
 
+  // 3. home/cwd/AppData 下包含 openclaw/clawdbot/moltbot 的子目录
   const searchRoots = new Set<string>([
     homeDir,
     process.cwd(),
@@ -901,6 +1047,13 @@ function collectCandidateLogDirs(): string[] {
     }
   }
 
+  // 4. /var/log 下的常见日志目录（Linux 服务器部署场景）
+  if (!isWindows()) {
+    for (const name of ["openclaw", "clawdbot", "moltbot"]) {
+      pushDir(path.join("/var/log", name));
+    }
+  }
+
   return Array.from(dirs);
 }
 
@@ -927,6 +1080,11 @@ function collectRecentLogFiles(logDirs: string[]): LogCandidate[] {
     }
   };
 
+  // 优先级最高：用户在 openclaw.json logging.file 中显式配置的日志文件
+  for (const logFile of getConfiguredLogFiles()) {
+    pushFile(logFile, path.dirname(logFile));
+  }
+
   for (const dir of logDirs) {
     pushFile(path.join(dir, "gateway.log"), dir);
     pushFile(path.join(dir, "gateway.err.log"), dir);
@@ -965,8 +1123,19 @@ registerCommand({
     const recentFiles = collectRecentLogFiles(logDirs).slice(0, 4);
 
     if (recentFiles.length === 0) {
-      const searched = logDirs.map(d => `  - ${d}`).join("\n");
-      return `⚠️ 未找到日志文件\n\n已搜索以下路径：\n${searched}`;
+      const existingDirs = logDirs.filter(d => { try { return fs.existsSync(d); } catch { return false; } });
+      const searched = existingDirs.length > 0
+        ? existingDirs.map(d => `  • ${d}`).join("\n")
+        : logDirs.slice(0, 6).map(d => `  • ${d}`).join("\n") + (logDirs.length > 6 ? `\n  …及其他 ${logDirs.length - 6} 个路径` : "");
+      return [
+        `⚠️ 未找到日志文件`,
+        ``,
+        `已搜索以下${existingDirs.length > 0 ? "已存在的" : ""}路径：`,
+        searched,
+        ``,
+        `💡 如果日志在自定义路径，请在配置文件中添加：`,
+        `  "logging": { "file": "/path/to/your/logfile.log" }`,
+      ].join("\n");
     }
 
     const lines: string[] = [];

package/src/startup-greeting.ts

@@ -10,7 +10,11 @@ import { getPluginVersion } from "./slash-commands.js";
 const STARTUP_MARKER_FILE = path.join(getQQBotDataDir("data"), "startup-marker.json");
 const STARTUP_GREETING_RETRY_COOLDOWN_MS = 10 * 60 * 1000;
 
-export function getStartupGreetingText(version: string): string {
+export function getFirstLaunchGreetingText(): string {
+  return `Haha，我的'灵魂'已上线，随时等你吩咐。`;
+}
+
+export function getUpgradeGreetingText(version: string): string {
   return `🎉 QQBot 插件已更新至 v${version}，在线等候你的吩咐。`;
 }
 
@@ -44,10 +48,11 @@ export function writeStartupMarker(data: StartupMarkerData): void {
 }
 
 /**
- * 判断是否需要发送"灵魂上线"问候：
- * - 首次安装 / 版本变更：可发送
- * - 同版本：不发送
- * - 同版本近期失败：冷却期内不重试，减少噪音
+ * 判断是否需要发送启动问候：
+ * - 首次启动（无 marker）→ "灵魂已上线"
+ * - 版本变更 → "已更新至 vX.Y.Z"
+ * - 同版本 → 不发送
+ * - 同版本近期失败 → 冷却期内不重试
  */
 export function getStartupGreetingPlan(): { shouldSend: boolean; greeting?: string; version: string; reason?: string } {
   const currentVersion = getPluginVersion();
@@ -64,7 +69,12 @@ export function getStartupGreetingPlan(): { shouldSend: boolean; greeting?: stri
     }
   }
 
-  return { shouldSend: true, greeting: getStartupGreetingText(currentVersion), version: currentVersion };
+  const isFirstLaunch = !marker.version;
+  const greeting = isFirstLaunch
+    ? getFirstLaunchGreetingText()
+    : getUpgradeGreetingText(currentVersion);
+
+  return { shouldSend: true, greeting, version: currentVersion };
 }
 
 export function markStartupGreetingSent(version: string): void {