@tencent-connect/openclaw-qqbot 1.6.2-alpha.3 → 1.6.3-alpha.channel

package/README.md

@@ -149,9 +149,9 @@ AI can send videos directly. Supports local files and URLs.
 
 The plugin provides built-in slash commands that are intercepted before reaching the AI queue, giving instant responses for diagnostics and management.
 
-#### `/qqbot-ping` — Latency Test
+#### `/bot-ping` — Latency Test
 
-> **You**: `/qqbot-ping`
+> **You**: `/bot-ping`
 >
 > **QQBot**: ✅ pong！⏱ Latency: 602ms (network: 602ms, plugin: 0ms)
 
@@ -159,27 +159,27 @@ Measures end-to-end latency from QQ server push to plugin response, broken down
 
 <img width="360" src="docs/images/slash-ping.jpg" alt="Ping Demo" />
 
-#### `/qqbot-version` — Version Info
+#### `/bot-version` — Version Info
 
-> **You**: `/qqbot-version`
+> **You**: `/bot-version`
 >
-> **QQBot**: 🦞 Framework: OpenClaw 2026.3.13 (61d171a) / 🤖 Plugin: v1.6.2 / 🌟 GitHub repo
+> **QQBot**: 🦞 Framework: OpenClaw 2026.3.13 (61d171a) / 🤖 Plugin: v1.6.3 / 🌟 GitHub repo
 
 Shows framework version, plugin version, and a direct link to the official repository.
 
 <img width="360" src="docs/images/slash-version.jpg" alt="Version Demo" />
 
-#### `/qqbot-help` — Command List
+#### `/bot-help` — Command List
 
-> **You**: `/qqbot-help`
+> **You**: `/bot-help`
 >
 > **QQBot**: Lists all available slash commands with clickable shortcuts.
 
 <img width="360" src="docs/images/slash-help.jpg" alt="Help Demo" />
 
-#### `/qqbot-upgrade` — Upgrade Guide
+#### `/bot-upgrade` — Upgrade Guide
 
-> **You**: `/qqbot-upgrade`
+> **You**: `/bot-upgrade`
 >
 > **QQBot**: 📌 Current version / ✅ Up to date / ⬆️ Upgrade guide / 🌟 GitHub repo
 
@@ -187,9 +187,9 @@ Shows current version, update status, upgrade guide link, and official repositor
 
 <img width="360" src="docs/images/slash-upgrade.jpg" alt="Upgrade Demo" /> 
 
-#### `/qqbot-logs` — Log Export
+#### `/bot-logs` — Log Export
 
-> **You**: `/qqbot-logs`
+> **You**: `/bot-logs`
 >
 > **QQBot**: 📋 Logs packaged (~2000 lines), sending file... *(sends a .txt file)*
 

package/README.zh.md

@@ -144,9 +144,9 @@ AI 可直接发送视频，支持本地文件和公网 URL。
 
 插件内置一组斜杠指令，在消息进入 AI 队列前拦截处理，即时响应，用于诊断和管理。
 
-#### `/qqbot-ping` — 延迟测试
+#### `/bot-ping` — 延迟测试
 
-> **你**：`/qqbot-ping`
+> **你**：`/bot-ping`
 >
 > **QQBot**：✅ pong！⏱ 延迟: 602ms（网络传输: 602ms，插件处理: 0ms）
 
@@ -154,27 +154,27 @@ AI 可直接发送视频，支持本地文件和公网 URL。
 
 <img width="360" src="docs/images/slash-ping.jpg" alt="Ping 演示" />
 
-#### `/qqbot-version` — 版本信息
+#### `/bot-version` — 版本信息
 
-> **你**：`/qqbot-version`
+> **你**：`/bot-version`
 >
-> **QQBot**：🦞框架版本：OpenClaw 2026.3.13 (61d171a) / 🤖QQBot 插件版本：v1.6.2 / 🌟官方 GitHub 仓库
+> **QQBot**：🦞框架版本：OpenClaw 2026.3.13 (61d171a) / 🤖QQBot 插件版本：v1.6.3 / 🌟官方 GitHub 仓库
 
 一目了然查看框架版本、插件版本，并可直接跳转官方仓库。
 
 <img width="360" src="docs/images/slash-version.jpg" alt="Version 演示" />
 
-#### `/qqbot-help` — 指令列表
+#### `/bot-help` — 指令列表
 
-> **你**：`/qqbot-help`
+> **你**：`/bot-help`
 >
 > **QQBot**：列出所有可用的斜杠指令及说明，指令可点击快速输入。
 
 <img width="360" src="docs/images/slash-help.jpg" alt="Help 演示" />
 
-#### `/qqbot-upgrade` — 升级指引
+#### `/bot-upgrade` — 升级指引
 
-> **你**：`/qqbot-upgrade`
+> **你**：`/bot-upgrade`
 >
 > **QQBot**：📌当前版本 / ✅当前已是最新版本 / ⬆️升级指引 / 🌟官方 GitHub 仓库
 
@@ -182,9 +182,9 @@ AI 可直接发送视频，支持本地文件和公网 URL。
 
 <img width="360" src="docs/images/slash-upgrade.jpg" alt="Upgrade 演示" /> 
 
-#### `/qqbot-logs` — 日志导出
+#### `/bot-logs` — 日志导出
 
-> **你**：`/qqbot-logs`
+> **你**：`/bot-logs`
 >
 > **QQBot**：📋 日志已打包（约 2000 行），正在发送文件… *（发送 .txt 文件）*
 

package/dist/src/gateway.js

@@ -315,7 +315,7 @@ export async function startGateway(ctx) {
             log?.info(`[qqbot:${account.accountId}] ${w}`);
         }
     }
-    // 后台版本检查（供 /qqbot-version、/qqbot-upgrade 指令被动查询）
+    // 后台版本检查（供 /bot-version、/bot-upgrade 指令被动查询）
     triggerUpdateCheck(log);
     // 初始化 API 配置（markdown 支持）
     initApiConfig({
@@ -438,21 +438,23 @@ export async function startGateway(ctx) {
                 const greeting = getStartupGreeting();
                 if (!greeting) {
                     log?.info(`[qqbot:${account.accountId}] Skipping startup greeting (debounced, trigger=${trigger})`);
-                    return;
                 }
-                const adminId = resolveAdminOpenId();
-                if (!adminId) {
-                    log?.info(`[qqbot:${account.accountId}] Skipping startup greeting (no admin or known user)`);
-                    return;
+                else {
+                    const adminId = resolveAdminOpenId();
+                    if (!adminId) {
+                        log?.info(`[qqbot:${account.accountId}] Skipping startup greeting (no admin or known user)`);
+                    }
+                    else {
+                        log?.info(`[qqbot:${account.accountId}] Sending startup greeting to admin (trigger=${trigger}): "${greeting}"`);
+                        const token = await getAccessToken(account.appId, account.clientSecret);
+                        const GREETING_TIMEOUT_MS = 10_000;
+                        await Promise.race([
+                            sendProactiveC2CMessage(token, adminId, greeting),
+                            new Promise((_, reject) => setTimeout(() => reject(new Error("Startup greeting send timeout (10s)")), GREETING_TIMEOUT_MS)),
+                        ]);
+                        log?.info(`[qqbot:${account.accountId}] Sent startup greeting to admin: ${adminId}`);
+                    }
                 }
-                log?.info(`[qqbot:${account.accountId}] Sending startup greeting to admin (trigger=${trigger}): "${greeting}"`);
-                const token = await getAccessToken(account.appId, account.clientSecret);
-                const GREETING_TIMEOUT_MS = 10_000;
-                await Promise.race([
-                    sendProactiveC2CMessage(token, adminId, greeting),
-                    new Promise((_, reject) => setTimeout(() => reject(new Error("Startup greeting send timeout (10s)")), GREETING_TIMEOUT_MS)),
-                ]);
-                log?.info(`[qqbot:${account.accountId}] Sent startup greeting to admin: ${adminId}`);
             }
             catch (err) {
                 log?.error(`[qqbot:${account.accountId}] Failed to send startup greeting: ${err}`);

package/dist/src/slash-commands.js

@@ -11,10 +11,12 @@
  *   从而计算「开平→插件」和「插件处理」两段耗时
  */
 import { createRequire } from "node:module";
-import { execFileSync } from "node:child_process";
+import { execFileSync, execFile } from "node:child_process";
 import path from "node:path";
 import fs from "node:fs";
 import { getUpdateInfo } from "./update-checker.js";
+import { getHomeDir, isWindows } from "./utils/platform.js";
+import { fileURLToPath } from "node:url";
 const require = createRequire(import.meta.url);
 // 读取 package.json 中的版本号
 let PLUGIN_VERSION = "unknown";
@@ -58,10 +60,10 @@ function registerCommand(cmd) {
 }
 // ============ 内置指令 ============
 /**
- * /qqbot-ping — 测试当前 openclaw 与 QQ 连接的网络延迟
+ * /bot-ping — 测试当前 openclaw 与 QQ 连接的网络延迟
  */
 registerCommand({
-    name: "qqbot-ping",
+    name: "bot-ping",
     description: "测试当前 openclaw 与 QQ 连接的网络延迟",
     handler: (ctx) => {
         const now = Date.now();
@@ -83,10 +85,10 @@ registerCommand({
     },
 });
 /**
- * /qqbot-version — 查看插件版本号
+ * /bot-version — 查看插件版本号
  */
 registerCommand({
-    name: "qqbot-version",
+    name: "bot-version",
     description: "查看插件版本号",
     handler: () => {
         const frameworkVersion = getFrameworkVersion();
@@ -102,17 +104,17 @@ registerCommand({
             lines.push(`⚠️ 版本检查失败`);
         }
         else if (info.hasUpdate && info.latest) {
-            lines.push(`🆕最新可用版本：v${info.latest}，点击 <qqbot-cmd-input text="/qqbot-upgrade" show="/qqbot-upgrade"/> 查看升级指引`);
+            lines.push(`🆕最新可用版本：v${info.latest}，点击 <qqbot-cmd-input text="/bot-upgrade" show="/bot-upgrade"/> 查看升级指引`);
         }
         lines.push(`🌟官方 GitHub 仓库：[点击前往](https://github.com/tencent-connect/openclaw-qqbot/)`);
         return lines.join("\n");
     },
 });
 /**
- * /qqbot-help — 查看所有指令以及用途
+ * /bot-help — 查看所有指令以及用途
  */
 registerCommand({
-    name: "qqbot-help",
+    name: "bot-help",
     description: "查看所有指令以及用途",
     handler: () => {
         const lines = [`### QQBot插件内置调试指令`, ``];
@@ -124,54 +126,282 @@ registerCommand({
     },
 });
 const DEFAULT_UPGRADE_URL = "https://doc.weixin.qq.com/doc/w3_AKEAGQaeACgCNHrh1CbHzTAKtT2gB?scode=AJEAIQdfAAozxFEnLZAKEAGQaeACg";
+// ============ 热更新 ============
 /**
- * /qqbot-upgrade — 查看版本更新状态 + 升级指引
+ * 找到 CLI 命令名（openclaw / clawdbot / moltbot）
+ */
+function findCli() {
+    const whichCmd = isWindows() ? "where" : "which";
+    for (const cli of ["openclaw", "clawdbot", "moltbot"]) {
+        try {
+            execFileSync(whichCmd, [cli], { timeout: 3000, encoding: "utf8", stdio: "pipe" });
+            return cli;
+        }
+        catch {
+            continue;
+        }
+    }
+    return null;
+}
+/**
+ * 找到升级脚本路径
+ */
+function getUpgradeScriptPath() {
+    const currentFile = fileURLToPath(import.meta.url);
+    const scriptDir = path.resolve(path.dirname(currentFile), "..", "..", "scripts");
+    const scriptPath = path.join(scriptDir, "upgrade-via-npm.sh");
+    return fs.existsSync(scriptPath) ? scriptPath : null;
+}
+/**
+ * 在 Windows 上查找可用的 bash（Git Bash / WSL 等）
+ */
+function findBash() {
+    if (!isWindows())
+        return "bash";
+    // Git Bash 常见路径
+    const candidates = [
+        path.join(process.env.ProgramFiles || "C:\\Program Files", "Git", "bin", "bash.exe"),
+        path.join(process.env["ProgramFiles(x86)"] || "C:\\Program Files (x86)", "Git", "bin", "bash.exe"),
+        path.join(process.env.LOCALAPPDATA || "", "Programs", "Git", "bin", "bash.exe"),
+    ];
+    for (const p of candidates) {
+        if (p && fs.existsSync(p))
+            return p;
+    }
+    // 尝试 PATH 中的 bash
+    try {
+        execFileSync("where", ["bash"], { timeout: 3000, encoding: "utf8", stdio: "pipe" });
+        return "bash";
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * 执行热更新：执行脚本(--no-restart) → 触发 gateway restart
+ *
+ * fire-and-forget 操作：
+ * - 异步执行升级脚本（--no-restart，只做文件替换）
+ * - 脚本完成后触发 gateway restart（当前进程会被杀掉）
+ * - 新进程启动时 getStartupGreeting() 检测到版本变更，自动通知管理员
+ *
+ * @returns true 表示已启动升级流程，false 表示无法执行（如 Windows 无 bash）
+ */
+function fireHotUpgrade(targetVersion) {
+    const scriptPath = getUpgradeScriptPath();
+    if (!scriptPath)
+        return false;
+    const cli = findCli();
+    if (!cli)
+        return false;
+    const bash = findBash();
+    if (!bash)
+        return false;
+    const args = ["--no-restart"];
+    if (targetVersion) {
+        args.push("--version", targetVersion);
+    }
+    // 异步执行升级脚本
+    execFile(bash, [scriptPath, ...args], {
+        timeout: 120_000,
+        env: { ...process.env },
+        ...(isWindows() ? { windowsHide: true } : {}),
+    }, (error, _stdout, _stderr) => {
+        if (error) {
+            return;
+        }
+        // 文件替换成功，触发 gateway restart
+        execFile(cli, ["gateway", "restart"], { timeout: 30_000 }, () => { });
+    });
+    return true;
+}
+/**
+ * /bot-upgrade — 查看版本更新状态 + 升级指引（根据 upgradeMode 决定行为）
  */
 registerCommand({
-    name: "qqbot-upgrade",
+    name: "bot-upgrade",
     description: "查看版本更新与升级指引",
     handler: (ctx) => {
+        // 升级相关指令仅在私聊中可用
+        if (ctx.type !== "c2c") {
+            return `💡 请在私聊中使用此指令`;
+        }
+        const upgradeMode = ctx.accountConfig?.upgradeMode || "doc";
         const url = ctx.accountConfig?.upgradeUrl || DEFAULT_UPGRADE_URL;
         const info = getUpdateInfo();
         const lines = [];
         lines.push(`📌当前版本：v${PLUGIN_VERSION}`);
         if (info.checkedAt === 0) {
             lines.push(`⏳ 版本检查中，请稍后再试`);
+            return lines.join("\n");
         }
         else if (info.error) {
             lines.push(`⚠️ 版本检查失败`);
+            lines.push(`⬆️升级指引：[点击查看](${url})`);
+            return lines.join("\n");
         }
         else if (info.hasUpdate && info.latest) {
             lines.push(`🆕最新可用版本：v${info.latest}`);
         }
         else {
             lines.push(`✅ 当前已是最新版本`);
+            return lines.join("\n");
+        }
+        // 有新版本：根据 upgradeMode 决定行为
+        if (upgradeMode === "hot-reload") {
+            const started = fireHotUpgrade(info.latest);
+            if (!started) {
+                lines.push(`⚠️ 当前环境不支持热更新（需要 bash 环境）`);
+                lines.push(`⬆️升级指引：[点击查看](${url})`);
+                return lines.join("\n");
+            }
+            lines.push(``);
+            lines.push(`🔄 正在执行热更新到 v${info.latest}...`);
+            lines.push(`⏳ 升级过程约需 30~60 秒，完成后会自动通知您`);
+            return lines.join("\n");
         }
+        // doc 模式：展示升级文档
         lines.push(`⬆️升级指引：[点击查看](${url})`);
         lines.push(`🌟官方 GitHub 仓库：[点击前往](https://github.com/tencent-connect/openclaw-qqbot/)`);
+        lines.push(``, `> 💡 提示：管理员可通过 <qqbot-cmd-input text="/bot-hot-upgrade" show="/bot-hot-upgrade"/> 直接执行热更新`);
         return lines.join("\n");
     },
 });
 /**
- * /qqbot-logs — 导出本地日志文件
+ * /bot-hot-upgrade — 直接执行热更新（无论 upgradeMode 配置如何）
+ *
+ * 支持参数：
+ *   /bot-hot-upgrade           — 升级到 latest
+ *   /bot-hot-upgrade 1.6.4     — 升级到指定版本
+ *   /bot-hot-upgrade --force   — 强制升级（即使当前已是最新版）
  */
 registerCommand({
-    name: "qqbot-logs",
+    name: "bot-hot-upgrade",
+    description: "直接执行热更新升级",
+    handler: (ctx) => {
+        // 升级相关指令仅在私聊中可用
+        if (ctx.type !== "c2c") {
+            return `💡 请在私聊中使用此指令`;
+        }
+        // 前置检查
+        const scriptPath = getUpgradeScriptPath();
+        if (!scriptPath) {
+            return "❌ 升级脚本不存在，请检查安装是否完整";
+        }
+        const cli = findCli();
+        if (!cli) {
+            return "❌ 未找到 openclaw / clawdbot / moltbot CLI";
+        }
+        const args = ctx.args.trim();
+        const info = getUpdateInfo();
+        // 解析参数
+        const isForce = args.includes("--force");
+        const versionArg = args.replace("--force", "").trim() || undefined;
+        // 如果没有指定版本，先检查是否有更新
+        if (!versionArg && !isForce) {
+            if (info.checkedAt === 0) {
+                return `⏳ 版本检查中，请稍后再试`;
+            }
+            if (!info.hasUpdate && !info.error) {
+                return `✅ 当前版本 v${PLUGIN_VERSION} 已是最新，无需升级\n\n> 💡 使用 /bot-hot-upgrade --force 可强制重新安装`;
+            }
+        }
+        const targetVersion = versionArg || info.latest || undefined;
+        // 异步执行升级
+        const started = fireHotUpgrade(targetVersion);
+        if (!started) {
+            return `❌ 当前环境不支持热更新（需要 bash 环境）\n\n> Windows 用户请安装 Git for Windows 后重试，或手动执行升级脚本`;
+        }
+        const lines = [
+            `🔄 开始热更新...`,
+            `📌 当前版本：v${PLUGIN_VERSION}`,
+        ];
+        if (targetVersion) {
+            lines.push(`🎯 目标版本：v${targetVersion}`);
+        }
+        lines.push(``);
+        lines.push(`⏳ 升级过程约需 30~60 秒，完成后会自动通知您`);
+        return lines.join("\n");
+    },
+});
+/**
+ * /bot-logs — 导出本地日志文件
+ *
+ * 日志路径检测策略（兼容特殊安装路径和 --profile/--dev 模式）：
+ * 1. OPENCLAW_STATE_DIR 环境变量指定的目录
+ * 2. 扫描 home 目录下所有 .openclaw-xxx/logs/ 目录，取最近修改的 gateway.log
+ */
+registerCommand({
+    name: "bot-logs",
     description: "导出本地日志文件",
     handler: () => {
-        const homeDir = process.env.HOME || "~";
-        const logDir = path.join(homeDir, ".openclaw", "logs");
-        const gatewayLog = path.join(logDir, "gateway.log");
-        const errLog = path.join(logDir, "gateway.err.log");
+        const homeDir = getHomeDir();
+        // 收集所有可能的日志目录
+        const logDirs = [];
+        // 优先：环境变量指定的状态目录
+        const stateDir = process.env.OPENCLAW_STATE_DIR;
+        if (stateDir) {
+            logDirs.push(path.join(stateDir, "logs"));
+        }
+        // 扫描搜索根目录列表（兼容 Windows APPDATA 路径）
+        const searchRoots = new Set([homeDir]);
+        const appData = process.env.APPDATA; // Windows: C:\Users\xxx\AppData\Roaming
+        if (appData)
+            searchRoots.add(appData);
+        const localAppData = process.env.LOCALAPPDATA; // Windows: C:\Users\xxx\AppData\Local
+        if (localAppData)
+            searchRoots.add(localAppData);
+        for (const root of searchRoots) {
+            try {
+                const entries = fs.readdirSync(root, { withFileTypes: true });
+                for (const entry of entries) {
+                    if (entry.isDirectory() && (entry.name.startsWith(".openclaw") || entry.name.startsWith("openclaw"))) {
+                        const candidate = path.join(root, entry.name, "logs");
+                        if (!logDirs.includes(candidate)) {
+                            logDirs.push(candidate);
+                        }
+                    }
+                }
+            }
+            catch {
+                // 无权限或不存在，跳过
+            }
+        }
+        // 兜底：默认路径
+        const defaultLogDir = path.join(homeDir, ".openclaw", "logs");
+        if (!logDirs.includes(defaultLogDir)) {
+            logDirs.push(defaultLogDir);
+        }
+        // 从所有候选目录中找到存在且最近修改的 gateway.log
+        let bestLogDir = null;
+        let bestMtime = 0;
+        for (const logDir of logDirs) {
+            const gatewayLog = path.join(logDir, "gateway.log");
+            try {
+                const stat = fs.statSync(gatewayLog);
+                if (stat.mtimeMs > bestMtime) {
+                    bestMtime = stat.mtimeMs;
+                    bestLogDir = logDir;
+                }
+            }
+            catch {
+                // 不存在或无权限，跳过
+            }
+        }
+        if (!bestLogDir) {
+            const searched = logDirs.map(d => `  - ${d}`).join("\n");
+            return `⚠️ 未找到日志文件\n\n已搜索以下路径：\n${searched}`;
+        }
+        const gatewayLog = path.join(bestLogDir, "gateway.log");
+        const errLog = path.join(bestLogDir, "gateway.err.log");
         const lines = [];
-        // 读取 gateway.log 最后 2000 行
         for (const logFile of [gatewayLog, errLog]) {
             if (!fs.existsSync(logFile))
                 continue;
             try {
                 const content = fs.readFileSync(logFile, "utf8");
                 const allLines = content.split("\n");
-                const tail = allLines.slice(-1000); // 每个文件取最后 1000 行
+                const tail = allLines.slice(-1000);
                 if (tail.length > 0) {
                     lines.push(`\n========== ${path.basename(logFile)} (last ${tail.length} lines) ==========\n`);
                     lines.push(...tail);
@@ -182,7 +412,7 @@ registerCommand({
             }
         }
         if (lines.length === 0) {
-            return "⚠️ 未找到日志文件";
+            return `⚠️ 日志文件为空（路径：${bestLogDir}）`;
         }
         // 写入临时文件
         const tmpDir = path.join(homeDir, ".openclaw", "qqbot", "downloads");
@@ -190,11 +420,11 @@ registerCommand({
             fs.mkdirSync(tmpDir, { recursive: true });
         }
         const timestamp = new Date().toISOString().replace(/[:.]/g, "-").slice(0, 19);
-        const tmpFile = path.join(tmpDir, `qqbot-logs-${timestamp}.txt`);
+        const tmpFile = path.join(tmpDir, `bot-logs-${timestamp}.txt`);
         fs.writeFileSync(tmpFile, lines.join("\n"), "utf8");
         const totalLines = lines.filter(l => !l.startsWith("=")).length;
         return {
-            text: `📋 日志已打包（约 ${totalLines} 行），正在发送文件...`,
+            text: `📋 日志已打包（约 ${totalLines} 行），正在发送文件...\n📂 来源：${bestLogDir}`,
             filePath: tmpFile,
         };
     },

package/dist/src/tools/channel.d.ts

@@ -0,0 +1,16 @@
+import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
+/**
+ * 注册 QQ 频道 API 代理工具。
+ *
+ * 该工具作为 QQ 开放平台频道 API 的 HTTP 代理，自动处理 Token 鉴权。
+ * AI 通过 skill 文档了解各接口的路径、方法和参数，构造请求后由此工具代理发送。
+ *
+ * 支持的能力：
+ * - 频道管理（Guild）
+ * - 子频道管理（Channel）
+ * - 成员管理（Member）
+ * - 公告管理（Announces）
+ * - 论坛管理（Forum Thread）
+ * - 日程管理（Schedule）
+ */
+export declare function registerChannelTool(api: OpenClawPluginApi): void;