@tencent-connect/openclaw-qqbot 1.6.6 → 1.6.7

package/scripts/upgrade-via-source.sh

@@ -262,8 +262,9 @@ if lsof -i :18789 -sTCP:LISTEN >/dev/null 2>&1; then
     sleep 1
 fi
 
-# 清理之前可能残留的 staging 目录
+# 清理之前可能残留的 staging 目录（extensions 和 /tmp 中都可能存在）
 find "$HOME/.openclaw/extensions/" -maxdepth 1 -name ".openclaw-install-stage-*" -exec rm -rf {} + 2>/dev/null || true
+find "${TMPDIR:-/tmp}" -maxdepth 1 -name ".openclaw-install-stage-*" -exec rm -rf {} + 2>/dev/null || true
 
 # ── 清空并重新构建 dist/ ──
 # openclaw plugins install . 只做文件复制，不执行 npm lifecycle scripts。
@@ -290,7 +291,25 @@ fi
 # 由于 CJS/ESM 混用问题（Node 22 ERR_INTERNAL_ASSERTION），验证阶段可能失败
 # 但文件已成功拷贝。因此不依赖退出码，而是检查安装目录中关键文件是否存在。
 _INSTALL_DIR="$HOME/.openclaw/extensions/openclaw-qqbot"
+
+# ── 优化：安装前临时移走 node_modules ──
+# openclaw plugins install . 会把整个项目目录（含 node_modules/）复制到 extensions，
+# 但运行时只需要 bundledDependencies 中的 3 个包 + openclaw symlink。
+# 移走 node_modules 可避免复制数百个不必要的包，大幅加速安装。
+_NM_BACKUP=""
+if [ -d "$PROJ_DIR/node_modules" ]; then
+    echo "  临时移走 node_modules（避免整体复制到 extensions）..."
+    _NM_BACKUP="$PROJ_DIR/.node_modules_install_bak"
+    mv "$PROJ_DIR/node_modules" "$_NM_BACKUP"
+fi
+
 openclaw plugins install . 2>&1 | tee "$INSTALL_LOG" || true
+
+# ── 恢复 node_modules ──
+if [ -n "$_NM_BACKUP" ] && [ -d "$_NM_BACKUP" ]; then
+    mv "$_NM_BACKUP" "$PROJ_DIR/node_modules"
+    echo "  已恢复源码目录 node_modules"
+fi
 if [ ! -f "$_INSTALL_DIR/dist/index.js" ] || [ ! -f "$_INSTALL_DIR/preload.cjs" ]; then
     echo ""
     echo "❌ 插件安装失败！"
@@ -344,13 +363,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
             ;;  
@@ -398,6 +417,13 @@ else
         echo ""
         echo "  尝试自动修复: 清理残留并重试安装..."
         find "$HOME/.openclaw/extensions/" -maxdepth 1 -name ".openclaw-install-stage-*" -exec rm -rf {} + 2>/dev/null || true
+        find "${TMPDIR:-/tmp}" -maxdepth 1 -name ".openclaw-install-stage-*" -exec rm -rf {} + 2>/dev/null || true
+        # 重试时同样移走 node_modules 避免整体复制
+        _NM_BACKUP=""
+        if [ -d "$PROJ_DIR/node_modules" ]; then
+            _NM_BACKUP="$PROJ_DIR/.node_modules_install_bak"
+            mv "$PROJ_DIR/node_modules" "$_NM_BACKUP"
+        fi
         if openclaw plugins install . 2>&1 | tee -a "$INSTALL_LOG"; then
             for _candidate_name in openclaw-qqbot qqbot openclaw-qq; do
                 if [ -d "$HOME/.openclaw/extensions/$_candidate_name" ]; then
@@ -407,6 +433,10 @@ else
                 fi
             done
         fi
+        # 恢复 node_modules
+        if [ -n "$_NM_BACKUP" ] && [ -d "$_NM_BACKUP" ]; then
+            mv "$_NM_BACKUP" "$PROJ_DIR/node_modules"
+        fi
         if [ "$_plugin_dir_ok" -eq 0 ]; then
             echo "  ❌ 重试安装仍失败，插件目录不存在"
             echo "  请手动排查: ls -la ~/.openclaw/extensions/"
@@ -440,18 +470,70 @@ else
         fi
     fi
 
-    # 清理多余的 peerDependencies 传递依赖（兼容旧版 openclaw）：
-    # openclaw v2026.3.4 之前的 plugins install 缺少 --omit=peer，会把 peerDeps
-    # （openclaw 平台及其 400+ 传递依赖）也安装到插件 node_modules 中。
-    # 新版已修复，此处通过阈值判断：包数量 > 50 才触发清理，避免对新版做无用操作。
+    # ── 复制 bundledDependencies 到插件 node_modules ──
+    # 由于安装前移走了源码的 node_modules，extensions 中的插件目录没有依赖。
+    # 只需复制 bundledDependencies（ws, silk-wasm, mpg123-decoder）及其传递依赖即可。
     PLUGIN_NM=""
     for _candidate in openclaw-qqbot qqbot openclaw-qq; do
         _nm="$HOME/.openclaw/extensions/$_candidate/node_modules"
-        [ -d "$_nm" ] && PLUGIN_NM="$_nm" && break
+        _ext_dir="$HOME/.openclaw/extensions/$_candidate"
+        [ -d "$_ext_dir" ] && PLUGIN_NM="$_nm" && break
     done
-    if [ -n "$PLUGIN_NM" ]; then
+    if [ -n "$PLUGIN_NM" ] && [ -d "$PROJ_DIR/node_modules" ]; then
+        # 如果 extensions 中已有大量包（旧版 openclaw 安装的 peerDeps），先清理
+        if [ -d "$PLUGIN_NM" ]; then
+            _before=$(ls -d "$PLUGIN_NM"/*/ "$PLUGIN_NM"/@*/*/ 2>/dev/null | wc -l | tr -d ' ')
+            if [ "$_before" -gt 50 ]; then
+                echo ""
+                echo "检测到 ${_before} 个包（超过阈值 50），清理多余的 peerDep 传递依赖..."
+                rm -rf "$PLUGIN_NM"
+            fi
+        fi
+
+        # 读取 bundledDependencies 及其传递依赖列表，只复制这些包
+        _deps_to_copy=$(node -e "
+          const fs = require('fs');
+          const path = require('path');
+          const pkgPath = path.join('$PROJ_DIR', 'package.json');
+          if (!fs.existsSync(pkgPath)) process.exit(0);
+          const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
+          const bundled = pkg.bundledDependencies || pkg.bundleDependencies || [];
+          const keep = new Set();
+          const resolve = (name) => {
+            if (keep.has(name)) return;
+            keep.add(name);
+            const depPkg = path.join('$PROJ_DIR', 'node_modules', name, 'package.json');
+            if (!fs.existsSync(depPkg)) return;
+            const dep = JSON.parse(fs.readFileSync(depPkg, 'utf8'));
+            for (const d of Object.keys(dep.dependencies || {})) resolve(d);
+          };
+          bundled.forEach(resolve);
+          process.stdout.write([...keep].join('\\n'));
+        " 2>/dev/null || true)
+
+        if [ -n "$_deps_to_copy" ]; then
+            mkdir -p "$PLUGIN_NM"
+            _copied=0
+            echo "$_deps_to_copy" | while IFS= read -r _dep; do
+                _src="$PROJ_DIR/node_modules/$_dep"
+                _dst="$PLUGIN_NM/$_dep"
+                if [ -d "$_src" ] && [ ! -d "$_dst" ]; then
+                    # 处理 scoped 包（如 @scope/pkg）
+                    mkdir -p "$(dirname "$_dst")"
+                    cp -r "$_src" "$_dst"
+                fi
+            done
+            _after=$(ls -d "$PLUGIN_NM"/*/ "$PLUGIN_NM"/@*/*/ 2>/dev/null | wc -l | tr -d ' ')
+            echo "  ✅ 已复制 bundled 依赖到插件目录（${_after} 个包）"
+        else
+            echo "  ⚠️  未读取到 bundledDependencies，跳过依赖复制"
+        fi
+    elif [ -n "$PLUGIN_NM" ] && [ -d "$PLUGIN_NM" ]; then
+        # node_modules 已存在（可能是旧版 openclaw 安装的），检查是否需要清理
         _before=$(ls -d "$PLUGIN_NM"/*/ "$PLUGIN_NM"/@*/*/ 2>/dev/null | wc -l | tr -d ' ')
         if [ "$_before" -gt 50 ]; then
+            echo ""
+            echo "检测到 ${_before} 个包（超过阈值 50），清理多余的 peerDep 传递依赖..."
             # 读取 bundledDependencies 列表，只保留这些包及其子依赖
             _bundled_deps=$(node -e "
               const fs = require('fs');
@@ -490,8 +572,6 @@ else
               process.stdout.write(toRemove.join('\n'));
             " 2>/dev/null || true)
             if [ -n "$_bundled_deps" ]; then
-                echo ""
-                echo "检测到 ${_before} 个包（超过阈值 50），清理多余的 peerDep 传递依赖..."
                 echo "$_bundled_deps" | while IFS= read -r _pkg; do
                     rm -rf "$PLUGIN_NM/$_pkg"
                 done
@@ -527,6 +607,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 +672,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 +867,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 +969,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;
+}