@jeik/dingtalk-connector 0.8.28 → 0.8.30

package/openclaw.plugin.json

@@ -1,9 +1,9 @@
 {
   "id": "dingtalk-connector",
   "name": "DingTalk Channel",
-  "version": "0.8.20",
-  "description": "Official OpenClaw DingTalk channel plugin | 钉钉官方 OpenClaw 插件",
-  "author": "DingTalk Real Team",
+  "version": "0.8.29",
+  "description": "OpenClaw DingTalk channel plugin (community) | 钉钉 OpenClaw 社区增强版",
+  "author": "jeik",
   "main": "index.ts",
   "channels": [
     "dingtalk-connector"
@@ -240,7 +240,9 @@
             "type": "string"
           },
           "debug": {
-            "type": "boolean"
+            "type": "boolean",
+            "default": false,
+            "description": "调试日志：连接/入站、图片 mediaId、引用回填、队列计数等。日常关闭；排障时设 true 后重启 gateway。"
           },
           "messageImageMd": {
             "type": "boolean",
@@ -491,7 +493,9 @@
                   "type": "string"
                 },
                 "debug": {
-                  "type": "boolean"
+                  "type": "boolean",
+                  "default": false,
+                  "description": "调试日志：连接/入站、图片 mediaId、引用回填、队列计数等。日常关闭；排障时设 true 后重启 gateway。"
                 },
                 "messageImageMd": {
                   "type": "boolean",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jeik/dingtalk-connector",
-  "version": "0.8.28",
+  "version": "0.8.30",
   "description": "OpenClaw DingTalk channel plugin (community) | 钉钉 OpenClaw 社区增强版（基于官方 0.8.24，长连接与消息体验增强）",
   "type": "module",
   "exports": {

package/src/config/schema.ts

@@ -81,7 +81,8 @@ const DingtalkSharedConfigShape = {
   asyncMode: z.boolean().optional(),
   ackText: z.string().optional(),
   endpoint: z.string().optional(), // DWClient gateway endpoint
-  debug: z.boolean().optional(), // DWClient debug mode
+  /** 调试日志：连接/入站摘要、图片 mediaId 追踪、引用回填、队列计数等（默认关，生产勿开） */
+  debug: z.boolean().optional(),
   enableMediaUpload: z.boolean().optional(),
   systemPrompt: z.string().optional(),
   /**

package/src/core/connection.ts

@@ -114,7 +114,7 @@ function printConnectionNoticeOnce(): void {
   _connectionNoticePrinted = true;
   console.log(
     "[dingtalk-connector] ℹ️  上游 dingtalk-stream 噪音已过滤；" +
-      "须 OPEN+REGISTERED 才报 ready，REGISTERED 超时会强制重连（禁止假 online）。" +
+      "OPEN 成功即可上线，REGISTERED 尽量等待；若环境不推 REGISTERED，首条消息会确认订阅。" +
       "正常运行不应出现 ≤30s 周期性硬重连。",
   );
 }
@@ -135,7 +135,9 @@ export async function monitorSingleAccount(
   const log = runtime?.log;
   
   // 创建 debug logger（仅在 debug 模式下输出 info/debug 日志）
-  const { createLoggerFromConfig } = await import('../utils/logger');
+  // 配置 debug: true 时同步打开图片/引用/队列详细诊断（无需环境变量）
+  const { createLoggerFromConfig, setDingtalkDebug } = await import('../utils/logger');
+  if (account.config?.debug) setDingtalkDebug(true);
   const logger = createLoggerFromConfig(account.config, `DingTalk:${accountId}`);
 
   // 验证凭据是否存在
@@ -288,15 +290,18 @@ export async function monitorSingleAccount(
   }
 
   /**
-   * 等待钉钉 Stream 真正可收消息。
+   * 等待钉钉 Stream 可服务。
    *
-   * dingtalk-stream 的 client.connect() 在创建 WebSocket 后立刻 resolve，
-   * **不等** socket open，更不等服务端 SYSTEM/REGISTERED。
+   * - OPEN：必须成功，否则 throw
+   * - REGISTERED：尽量等待；超时则 **降级 OPEN 上线**（不 throw）
    *
-   * 顺序：socket OPEN → SYSTEM topic=REGISTERED（client.registered=true）
-   * 任一步失败均 throw，禁止 OPEN-only 假 ready。
+   * 原因（生产日志）：部分环境 socket 已 OPEN 且 CALLBACK 能收消息，
+   * 但长期收不到 SYSTEM/REGISTERED 或 client.registered 不被置 true。
+   * 若硬性失败会触发网关 auto-restart 风暴，而旧连接/半连接其实仍在处理消息。
    */
-  async function waitForStreamReady(timeoutMs = STREAM_READY_TIMEOUT_MS): Promise<void> {
+  async function waitForStreamReady(timeoutMs = STREAM_READY_TIMEOUT_MS): Promise<{
+    registered: boolean;
+  }> {
     const started = Date.now();
 
     // 1) 等 WebSocket OPEN
@@ -332,12 +337,12 @@ export async function monitorSingleAccount(
       }
     }
 
-    // 2) 等服务端 REGISTERED（订阅生效，此后 CALLBACK 才会推到本连接）
+    // 2) 等服务端 REGISTERED（可选；超时降级）
     if ((client as any).registered === true) {
       logger.info(
         `✅ Stream 已就绪（OPEN + REGISTERED），耗时 ${Date.now() - started}ms`,
       );
-      return;
+      return { registered: true };
     }
 
     const registered = await new Promise<boolean>((resolve) => {
@@ -367,7 +372,7 @@ export async function monitorSingleAccount(
             return;
           }
         } catch {
-          // ignore parse errors
+          // ignore
         }
         if ((client as any).registered === true) {
           finish(true);
@@ -387,13 +392,15 @@ export async function monitorSingleAccount(
       logger.info(
         `✅ Stream 已就绪（OPEN + REGISTERED），耗时 ${Date.now() - started}ms`,
       );
-      return;
+      return { registered: true };
     }
 
-    // 禁止 OPEN-only 假 ready：未 REGISTERED 一律失败，由上层强制重连
-    throw new Error(
-      `SYSTEM/REGISTERED 超时（${timeoutMs}ms）：socket 已 OPEN 但订阅未生效，禁止报 connected`,
+    // 降级：OPEN 成功即可上线。许多环境不推 REGISTERED 或检测不到，但仍可收 CALLBACK。
+    logger.warn(
+      `⚠️ 未观察到 SYSTEM/REGISTERED（${timeoutMs}ms），socket 已 OPEN → 降级上线。` +
+        ` 收到首条机器人消息后会记为「订阅 empirically 生效」。`,
     );
+    return { registered: false };
   }
 
   /**
@@ -409,22 +416,20 @@ export async function monitorSingleAccount(
   }
 
   /**
-   * 单次：connect + 挂 listener + 等 OPEN/REGISTERED。
-   * 失败 throw，不报 connected。
+   * 单次：connect + 挂 listener + 等 OPEN（REGISTERED 可选）。
+   * 仅 OPEN 失败 throw；REGISTERED 超时则降级成功。
    */
-  async function connectAndWaitRegistered(): Promise<void> {
+  async function connectAndWaitReady(): Promise<{ registered: boolean }> {
     await client.connect();
     attachSocketLifecycleListeners();
-    await waitForStreamReady(STREAM_READY_TIMEOUT_MS);
-    if ((client as any).registered !== true) {
-      // 双保险：wait 已要求 registered，此处再断言
-      throw new Error("connect 后 client.registered 仍为 false");
-    }
+    return await waitForStreamReady(STREAM_READY_TIMEOUT_MS);
   }
 
   /**
-   * 直到 REGISTERED 成功或次数用尽。
-   * 用于初次启动与硬重连：绝不在未订阅时对外 connected=true。
+   * 建立可服务连接。
+   * - 优先拿到 REGISTERED
+   * - OPEN 成功即可上线（避免环境不推 REGISTERED 时 restart 风暴）
+   * - 仅在 OPEN 都失败时多轮重试
    */
   async function ensureRegisteredConnection(
     maxAttempts = REGISTERED_CONNECT_MAX_ATTEMPTS,
@@ -432,12 +437,12 @@ export async function monitorSingleAccount(
     let lastError: Error | undefined;
     for (let attempt = 1; attempt <= maxAttempts; attempt++) {
       if (isStopped) {
-        throw new Error("连接已停止，中止 REGISTERED 等待");
+        throw new Error("连接已停止，中止 Stream 建立");
       }
       try {
         if (attempt > 1) {
           logger.warn(
-            `🔄 REGISTERED 未就绪，强制重连 ${attempt}/${maxAttempts}…`,
+            `🔄 Stream 建立重试 ${attempt}/${maxAttempts}…`,
           );
           try {
             if ((client as any).socket) {
@@ -450,27 +455,28 @@ export async function monitorSingleAccount(
           await new Promise((r) => setTimeout(r, delay));
         } else {
           logger.info(
-            `⏳ 建立 Stream 并等待 REGISTERED（单次超时 ${STREAM_READY_TIMEOUT_MS}ms，最多 ${maxAttempts} 次）…`,
+            `⏳ 建立 Stream（OPEN 必须；REGISTERED 尽量等待 ${STREAM_READY_TIMEOUT_MS}ms）…`,
           );
         }
 
-        await connectAndWaitRegistered();
-        noteSocketAlive("registered-ok");
+        const ready = await connectAndWaitReady();
+        noteSocketAlive(ready.registered ? "registered-ok" : "open-degraded");
         connectionEstablishedTime = Date.now();
         logger.info(
-          `✅ 订阅已生效 registered=true（attempt ${attempt}/${maxAttempts}, ` +
+          `✅ Stream 可服务（attempt ${attempt}/${maxAttempts}, ` +
+            `registered=${ready.registered || Boolean((client as any).registered)}, ` +
             `socket=${(client as any).socket?.readyState}）`,
         );
         return;
       } catch (err: any) {
         lastError = err instanceof Error ? err : new Error(String(err));
         logger.warn(
-          `⚠️ Stream 就绪失败 attempt=${attempt}/${maxAttempts}: ${lastError.message}`,
+          `⚠️ Stream 建立失败 attempt=${attempt}/${maxAttempts}: ${lastError.message}`,
         );
       }
     }
     throw new Error(
-      `钉钉 Stream 在 ${maxAttempts} 次尝试后仍未 REGISTERED，拒绝假 connected。` +
+      `钉钉 Stream 在 ${maxAttempts} 次尝试后仍无法 OPEN。` +
         ` 最后错误: ${lastError?.message || "unknown"}`,
     );
   }
@@ -784,31 +790,27 @@ export async function monitorSingleAccount(
       lastMessageTime = Date.now();
       // 能收到 CALLBACK 说明链路活着——立刻刷新，打断「软超时→硬重连」误判
       noteSocketAlive("inbound-callback");
+      // 部分环境收不到 SYSTEM/REGISTERED，但 CALLBACK 已通：记为 empirically 订阅成功
+      if ((client as any).registered !== true) {
+        (client as any).registered = true;
+        logger.info(
+          `✅ 收到机器人 CALLBACK，视为订阅已生效（此前可能未观察到 SYSTEM/REGISTERED）`,
+        );
+      }
 
       // 收到消息时，向框架报告 lastInboundAt（用于 UI 显示 "Last inbound"）
       onStatusChange?.({ lastInboundAt: Date.now() });
 
       const messageId = res.headers?.messageId;
-      const timestamp = new Date().toISOString();
-
-      // ===== 第一步：记录原始消息接收 =====
-      logger.info(`\n========== 收到新消息 ==========`);
-      logger.info(`时间：${timestamp}`);
-      logger.info(`MessageId: ${messageId || "N/A"}`);
-      logger.info(`Headers: ${JSON.stringify(res.headers || {})}`);
-      logger.info(`Data 长度：${res.data?.length || 0} 字符`);
-
-      // ⚠️ 不要在解析/入队前 ACK。
-      // 旧逻辑「立刻 socketCallBackResponse」：若随后去重误杀、解析失败、或入队前进程重连，
-      // 钉钉认为已送达，不再重推 → 网关 UI 永远收不到。
-      // 正确：入队成功后再 ACK；失败则不 ACK，让钉钉 ~60s 内重投。
+
+      // 入队成功后再 ACK；失败不 ACK 以便钉钉重投
       let acked = false;
       const ackMessage = (why: string) => {
         if (acked || !messageId) return;
         try {
           (client as any).socketCallBackResponse(messageId, { success: true });
           acked = true;
-          logger.info(`✅ 已确认回调 messageId=${messageId} (${why})`);
+          logger.debug(`ACK messageId=${messageId} (${why})`);
         } catch (ackErr: any) {
           logger.warn(`确认回调失败: ${ackErr?.message || ackErr}`);
         }
@@ -817,80 +819,62 @@ export async function monitorSingleAccount(
       markMessageProcessingStart();
 
       try {
-        // 解析消息数据
         let data;
         try {
           data = JSON.parse(res.data);
         } catch (parseError: any) {
-          logger.error('Failed to parse response data as JSON:', {
-            error: parseError instanceof Error ? parseError.message : String(parseError),
-            rawData: typeof res.data === 'string' 
-              ? res.data.substring(0, 500)
-              : res.data,
-            dataType: typeof res.data,
-          });
-          // 解析失败：不 ACK，允许钉钉重投
+          logger.error(
+            `JSON 解析失败: ${parseError instanceof Error ? parseError.message : String(parseError)}`,
+          );
           throw new Error(
-            `Invalid JSON response from DingTalk API. ` +
-            `Error: ${parseError instanceof Error ? parseError.message : String(parseError)}. ` +
-            `Raw data (first 100 chars): ${String(res.data).substring(0, 100)}`
+            `Invalid JSON from DingTalk: ${parseError instanceof Error ? parseError.message : String(parseError)}`,
           );
         }
 
-        // ===== 第二步：记录解析后的消息详情 =====
-        logger.info(`\n----- 消息详情 -----`);
-        logger.info(`消息类型：${data.msgtype || "unknown"}`);
-        logger.info(
-          `会话类型：${data.conversationType === "1" ? "DM (单聊)" : data.conversationType === "2" ? "Group (群聊)" : data.conversationType}`,
-        );
-        logger.info(
-          `发送者：${data.senderNick || "unknown"} (${data.senderStaffId || data.senderId || "unknown"})`,
-        );
-        logger.info(`会话 ID: ${data.conversationId || "N/A"}`);
-        logger.info(`消息 ID: ${data.msgId || "N/A"}`);
-        logger.info(
-          `SessionWebhook: ${data.sessionWebhook ? "已提供" : "未提供"}`,
-        );
+        const businessMsgId = data.msgId;
+        const convType =
+          data.conversationType === "1"
+            ? "DM"
+            : data.conversationType === "2"
+              ? "Group"
+              : String(data.conversationType ?? "?");
+        const preview =
+          (data.text?.content || "").trim().slice(0, 80) ||
+          data.msgtype ||
+          "(no text)";
+
+        // 一行摘要（debug 模式才打 Headers/全字段）
         logger.info(
-          `RobotCode: ${data.robotCode || account.config?.clientId || "N/A"}`,
+          `📩 入站 ${convType} from=${data.senderNick || data.senderStaffId || data.senderId || "?"} ` +
+            `msg=${businessMsgId || messageId || "-"} preview=${JSON.stringify(preview)}`,
         );
+        logger.debug(`Headers: ${JSON.stringify(res.headers || {})}`);
+        logger.debug(`字段: ${Object.keys(data).join(",")}`);
+
+        // BotIdentity 每个进程每个账号只打一次（配置多机器人时用）
         if (data.chatbotUserId || data.chatbotCorpId) {
-          console.log(
-            `[DingTalk:${accountId}] [BotIdentity] accountId=${accountId} chatbotUserId=${data.chatbotUserId || "N/A"} chatbotCorpId=${data.chatbotCorpId || "N/A"}`,
-          );
+          const key = `${accountId}:${data.chatbotUserId || ""}:${data.chatbotCorpId || ""}`;
+          if (!(globalThis as any).__dingtalkBotIdentityLogged) {
+            (globalThis as any).__dingtalkBotIdentityLogged = new Set<string>();
+          }
+          const seen = (globalThis as any).__dingtalkBotIdentityLogged as Set<string>;
+          if (!seen.has(key)) {
+            seen.add(key);
+            console.log(
+              `[DingTalk:${accountId}] [BotIdentity] chatbotUserId=${data.chatbotUserId || "N/A"} chatbotCorpId=${data.chatbotCorpId || "N/A"}`,
+            );
+          }
         }
 
-        const businessMsgId = data.msgId;
-
-        // 双层去重：协议 messageId + 业务 msgId（须在解析后一次完成）
         if (checkAndMarkDingtalkMessage(accountId, messageId, businessMsgId)) {
           processedCount++;
-          // 重复投递：ACK 掉避免钉钉无限重推
           ackMessage("duplicate");
           logger.warn(
-            `⚠️ 检测到重复消息，跳过：protocol=${messageId || "-"} business=${businessMsgId || "-"} (${processedCount}/${receivedCount})`,
+            `⚠️ 重复消息已跳过 protocol=${messageId || "-"} business=${businessMsgId || "-"}`,
           );
-          logger.info(`========== 消息处理结束（重复） ==========\n`);
           return;
         }
 
-        let contentPreview = "N/A";
-        if (data.text?.content) {
-          contentPreview =
-            data.text.content.length > 100
-              ? data.text.content.substring(0, 100) + "..."
-              : data.text.content;
-        } else if (data.content) {
-          contentPreview =
-            JSON.stringify(data.content).substring(0, 100) + "...";
-        }
-        logger.info(`消息内容预览：${contentPreview}`);
-        logger.info(`完整数据字段：${Object.keys(data).join(", ")}`);
-        logger.info(`----- 消息详情结束 -----\n`);
-
-        // ===== 第三步：入队处理 =====
-        logger.info(`🚀 开始处理消息...`);
-
         await messageHandler({
           accountId,
           config: account.config,
@@ -901,29 +885,22 @@ export async function monitorSingleAccount(
           cfg: clawdbotConfig,
         });
 
-        // 入队/受理成功后再 ACK（handleDingTalkMessage 返回表示已进 session 队列）
         ackMessage("enqueued");
         noteSocketAlive("after-enqueue");
 
         processedCount++;
-        logger.info(`✅ 消息处理完成 (${processedCount}/${receivedCount})`);
-        logger.info(`========== 消息处理结束（成功） ==========\n`);
+        logger.info(`✅ 入队完成 (${processedCount}/${receivedCount})`);
       } catch (error: any) {
         processedCount++;
-        const errorMsg = `❌ 处理消息异常 (${processedCount}/${receivedCount}): ${error?.message || "未知错误"}`;
-        const errorStack = error?.stack || "无堆栈信息";
-        
-        logger.error(errorMsg);
-        logger.error(`错误堆栈:\n${errorStack}`);
-        
-        // 未成功入队：故意不 ACK，让钉钉重投（最多约 60s）
+        logger.error(
+          `❌ 入站处理失败 (${processedCount}/${receivedCount}): ${error?.message || "未知错误"}`,
+        );
+        if (error?.stack) logger.debug(error.stack);
         if (!acked) {
           logger.warn(
-            `⚠️ 未 ACK messageId=${messageId || "N/A"}，等待钉钉重投（避免网关永久丢消息）`,
+            `⚠️ 未 ACK messageId=${messageId || "N/A"}，等待钉钉重投`,
           );
         }
-        
-        logger.info(`========== 消息处理结束（失败） ==========\n`);
       } finally {
         markMessageProcessingEnd();
       }

package/src/core/message-handler.ts

@@ -66,7 +66,7 @@ import { createDingtalkReplyDispatcher, matchModelErrorText } from "../reply-dis
 import { normalizeSlashCommand } from "../utils/session.ts";
 import { getDingtalkRuntime } from "../runtime.ts";
 import { dingtalkHttp } from '../utils/http-client.ts';
-import { createLoggerFromConfig } from '../utils/index.ts';
+import { createLoggerFromConfig, isDingtalkDebug } from '../utils/index.ts';
 import { trackBackgroundWork } from "../utils/background-work.ts";
 import * as fs from 'fs';
 import * as path from 'path';
@@ -358,11 +358,13 @@ function extractQuotedMsgText(
               allowConversationRecent: false,
             }) || '';
           if (cardText) {
-            console.log(
-              `[DingTalk][Quote] interactiveCard 已从 CardCache 精确回填 | ids=${ids.join(',') || '-'} len=${cardText.length}`,
-            );
-          } else {
-            // 强制 dump 载荷，便于确认钉钉到底给了哪些字段
+            if (isDingtalkDebug()) {
+              console.log(
+                `[DingTalk][Quote] interactiveCard 已从 CardCache 精确回填 | ids=${ids.join(',') || '-'} len=${cardText.length}`,
+              );
+            }
+          } else if (isDingtalkDebug()) {
+            // 调试：dump 载荷确认钉钉给了哪些字段
             const dump = JSON.stringify(repliedMsg ?? {}).slice(0, 800);
             console.log(
               `[DingTalk][Quote] interactiveCard 无正文且缓存未命中（未使用会话最近兜底） | conv=${conversationId || '-'} keys=${Object.keys(contentObj || {}).join(',')} repliedMsg=${dump}`,
@@ -398,26 +400,32 @@ function extractQuotedMsgText(
           });
           if (cached) {
             bodyText = cached;
-            console.log(
-              `[DingTalk][Quote] msgType=${msgType} 已从 CardCache 精确回填 | ids=${ids.join(',') || '-'} len=${cached.length}`,
-            );
+            if (isDingtalkDebug()) {
+              console.log(
+                `[DingTalk][Quote] msgType=${msgType} 已从 CardCache 精确回填 | ids=${ids.join(',') || '-'} len=${cached.length}`,
+              );
+            }
           } else if (
             /card|interactive/i.test(String(msgType || "")) ||
             ids.length > 0
           ) {
             bodyText = "钉钉卡片消息。";
-            console.log(
-              `[DingTalk][Quote] 未知卡片类引用 msgType=${msgType} 已简化占位 | keys=${Object.keys(contentObj || {}).join(',')}`,
-            );
-          } else {
+            if (isDingtalkDebug()) {
+              console.log(
+                `[DingTalk][Quote] 未知卡片类引用 msgType=${msgType} 已简化占位 | keys=${Object.keys(contentObj || {}).join(',')}`,
+              );
+            }
+          } else if (isDingtalkDebug()) {
             console.log(
               `[DingTalk][Quote] 未知引用类型 msgType=${msgType} keys=${Object.keys(contentObj || {}).join(',')} dump=${JSON.stringify(repliedMsg ?? {}).slice(0, 600)}`,
             );
           }
         } catch {
-          console.log(
-            `[DingTalk][Quote] 未知引用类型 msgType=${msgType} keys=${Object.keys(contentObj || {}).join(',')}`,
-          );
+          if (isDingtalkDebug()) {
+            console.log(
+              `[DingTalk][Quote] 未知引用类型 msgType=${msgType} keys=${Object.keys(contentObj || {}).join(',')}`,
+            );
+          }
         }
       }
       break;

package/src/reply-dispatcher.ts

@@ -26,7 +26,7 @@ const {
   logTypingFailure,
 } = channelRuntimeModule;
 
-import { createLoggerFromConfig } from "./utils/logger.ts";
+import { createLoggerFromConfig, isDingtalkDebug } from "./utils/logger.ts";
 import { CHANNEL_ID } from "./channel.ts";
 import { resolveDingtalkAccount } from "./config/accounts.ts";
 import { getDingtalkRuntime } from "./runtime.ts";
@@ -877,30 +877,26 @@ export function createDingtalkReplyDispatcher(params: CreateDingtalkReplyDispatc
         ? { type: 'user', userId: senderId }
         : { type: 'group', openConversationId: conversationId };
       
-      // 始终输出（不依赖 debug），便于排查本地图灰图
-      console.log(
-        `[DingTalk][LocalImage] closeStreaming 开始媒体处理 | target=${JSON.stringify(target)} hasToken=${!!oapiToken} textLen=${finalText.length}`,
-      );
-      // 预览正文中是否含 ![](
+      // 无图路径默认静默；有 MD 图或处理后变化才记一行（灰图风险仍 warn）
       const mdImgCount = (finalText.match(/!\[[^\]]*\]\([^)]+\)/g) || []).length;
-      console.log(
-        `[DingTalk][LocalImage] closeStreaming 正文 markdown 图数量=${mdImgCount} preview=${JSON.stringify(finalText.slice(0, 200))}`,
-      );
-      
+      if (mdImgCount > 0 || isDingtalkDebug()) {
+        log.info(
+          `[DingTalk][LocalImage] closeStreaming 媒体处理 | target=${JSON.stringify(target)} hasToken=${!!oapiToken} textLen=${finalText.length} mdImgs=${mdImgCount}`,
+        );
+      }
+
       if (oapiToken) {
-        // 处理本地图片（含 /mnt 共享盘；失败会 /tmp 重试，避免留下本地路径灰图）
         const beforeImg = finalText;
         finalText = await processLocalImages(finalText, oapiToken, log);
         if (beforeImg !== finalText) {
-          console.log(
-            `[DingTalk][LocalImage] closeStreaming 图片处理 | ${beforeImg.length}→${finalText.length}`,
+          log.info(
+            `[DingTalk][LocalImage] closeStreaming 图片已处理 | ${beforeImg.length}→${finalText.length}`,
           );
         }
-        // 仅统计代码块外的本地 ![]——示例 JSON/参数说明里的路径不算灰图风险
         try {
           const { hasResidualLocalMdImagesOutsideCode } = await import("./services/media.ts");
           if (hasResidualLocalMdImagesOutsideCode(finalText)) {
-            console.warn(
+            log.warn(
               `[DingTalk][LocalImage] closeStreaming 定稿后仍有代码块外的本地 MD 图未上传，钉钉可能灰图`,
             );
           }
@@ -938,7 +934,6 @@ export function createDingtalkReplyDispatcher(params: CreateDingtalkReplyDispatc
         );
         
         // ✅ 处理裸露的本地文件路径（绕过 OpenClaw SDK 的 bug）
-        log.info(`[DingTalk][closeStreaming] 准备调用 processRawMediaPaths`);
         const { processRawMediaPaths } = await import('./services/media');
         finalText = await processRawMediaPaths(
           finalText,
@@ -1246,13 +1241,12 @@ export function createDingtalkReplyDispatcher(params: CreateDingtalkReplyDispatc
         // 模型主动 NO_REPLY（无错误）保持静默——不在此伪造错误文案，避免群聊刷屏。
         // 此时 earlyCard 仍会由 onIdle→closeStreaming 收尾（思考完成 / 无文本），不会永久转圈。
         if (!raw && !isErr) {
-          log.info(
-            `[DingTalk][onSkip] kind=${info?.kind} reason=${info?.reason} 非错误静默（NO_REPLY/empty），跳过错误捕获`,
-          );
+          // 模型主动 NO_REPLY：静默，不打日志
           return;
         }
+        // 失败类静默：保留一行关键 warn（避免与 closeStreaming 重复刷堆栈）
         log.warn(
-          `[DingTalk][onSkip] kind=${info?.kind} reason=${info?.reason} isError=${isErr} rawLen=${raw.length}（群聊静默失败常见）`,
+          `[DingTalk][onSkip] 群聊静默失败 kind=${info?.kind} reason=${info?.reason} rawLen=${raw.length}`,
         );
         captureErrorFromPayload(payload, `onSkip:${info?.kind ?? "?"}:${info?.reason ?? "?"}`);
       },
@@ -1313,6 +1307,25 @@ export function createDingtalkReplyDispatcher(params: CreateDingtalkReplyDispatc
           const isModelErrorFinal =
             Boolean((payload as any).isError) && info?.kind === "final" && Boolean(text.trim());
 
+          // Gateway incomplete_turn 误报：会话/流式已有真实答案，却仍发
+          // "Agent couldn't generate a response" isError final。若覆盖 accumulatedText
+          // 并 closeStreaming，钉钉卡会定格错误、后续过程不再流式。
+          // 此时忽略误报，用已有 lastAnswerText/accumulatedText 正常收尾。
+          const existingAnswerText = (lastAnswerText.trim() || accumulatedText.trim()).trim();
+          const isIncompleteTurnFalsePositive =
+            isModelErrorFinal &&
+            /Agent couldn't generate a response/i.test(text) &&
+            existingAnswerText.length >= 20 &&
+            !/Agent couldn't generate a response/i.test(existingAnswerText);
+          if (isIncompleteTurnFalsePositive) {
+            pendingErrorText = null;
+            log.warn(
+              `[DingTalk][deliver] 忽略 incomplete_turn 误报 isError final（卡片已有真实答案 len=${existingAnswerText.length}），不定格错误卡`,
+            );
+            await closeStreaming();
+            return;
+          }
+
           // ✅ 上游模型异常 final：必须写入 accumulatedText，供 closeStreaming 定稿。
           // 工具失败 (kind=tool) 仍不计入最终答案。
           if (isModelErrorFinal) {