@dingtalk-real-ai/dingtalk-connector 0.8.3 → 0.8.5

package/CHANGELOG.md

@@ -5,6 +5,18 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.8.5] - 2026-03-24
+
+### 修复 / Fixes
+- 🐛 **群聊消息处理崩溃** - 修复群聊时报错 `TypeError: Cannot read properties of undefined (reading 'config')` 导致 Agent 无法回复的问题。根因是 `src/policy.ts` 中 `resolveDingtalkGroupToolPolicy` 函数的参数签名与 OpenClaw SDK 的 `ChannelGroupContext` 接口不匹配，函数期望接收 `account: ResolvedDingtalkAccount`，但框架实际传入 `{ cfg, groupId, accountId, ... }`，导致 `account` 为 `undefined`。现已修正参数签名，内部通过 `resolveDingtalkAccount()` 正确获取账号信息。单聊不受影响。  
+  **Group chat message processing crash** - Fixed `TypeError: Cannot read properties of undefined (reading 'config')` crash in group chats. Root cause: `resolveDingtalkGroupToolPolicy` in `src/policy.ts` had a parameter signature mismatch with the OpenClaw SDK's `ChannelGroupContext` interface. Fixed by correcting the parameter signature and resolving the account internally via `resolveDingtalkAccount()`. Direct messages were unaffected.
+
+- 🐛 **兼容旧版 OpenClaw Gateway（createPluginRuntimeStore 缺失）** - 修复在旧版 OpenClaw Gateway 上加载插件时报错 `TypeError: (0 , _pluginSdk.createPluginRuntimeStore) is not a function` 的问题。根因是 `src/runtime.ts` 直接从 `openclaw/plugin-sdk` 导入 `createPluginRuntimeStore`，而该函数在旧版 SDK 中并不存在。现已替换为内联实现的 `createRuntimeStore`，功能完全等价，兼容所有版本的 OpenClaw  
+  **Compatible with older OpenClaw Gateway (missing createPluginRuntimeStore)** - Fixed `TypeError: (0 , _pluginSdk.createPluginRuntimeStore) is not a function` when loading the plugin on older OpenClaw Gateway versions. Root cause: `src/runtime.ts` imported `createPluginRuntimeStore` from `openclaw/plugin-sdk`, which doesn't exist in older SDK versions. Replaced with an inline `createRuntimeStore` implementation that is fully equivalent and compatible with all OpenClaw versions
+
+- 🐛 **openclaw 依赖版本约束放宽** - 将 `package.json` 中的 `"openclaw": "^2026.3.0"` 改为 `"openclaw": "*"`，避免版本约束导致安装失败或与用户已安装版本冲突  
+  **Relaxed openclaw dependency version constraint** - Changed `"openclaw": "^2026.3.0"` to `"openclaw": "*"` in `package.json` to avoid installation failures or conflicts with the user's installed version
+
 ## [0.8.3] - 2026-03-24
 
 ### 修复 / Fixes

package/README.md

@@ -39,6 +39,38 @@
   ```
   预期输出：`✓ Gateway is running on http://127.0.0.1:18789`
 
+### ⚠️ 版本兼容性要求
+
+**重要**：dingtalk-connector v0.8.4+ 需要 **OpenClaw SDK v2026.3.22 或更高版本**。
+
+| dingtalk-connector 版本 | 最低 OpenClaw SDK 版本 | 说明 |
+|------------------------|----------------------|------|
+| v0.8.4+ | v2026.3.22+ | 使用新版 SDK API，支持更完善的路由和会话管理 |
+| v0.8.3 及以下 | v2026.3.x | 兼容旧版 SDK |
+
+**如何检查版本**：
+```bash
+# 检查 OpenClaw 版本
+openclaw --version
+
+# 检查插件版本
+openclaw plugins list
+```
+
+**如何升级**：
+```bash
+# 升级 OpenClaw 到最新版本
+npm install -g openclaw@latest
+
+# 或使用 yarn
+yarn global add openclaw@latest
+```
+
+**版本不兼容时的表现**：
+- 插件加载时会显示详细的错误提示
+- 提示信息会包含升级命令和降级方案
+- 插件会自动停止加载，不影响其他插件
+
 ### 2. 钉钉企业账号
 
 - 你需要一个钉钉企业账号来创建企业内部应用

package/index.ts

@@ -4,7 +4,7 @@
  * 钉钉企业内部机器人插件，使用 Stream 模式连接，支持 AI Card 流式响应。
  * 已迁移到 OpenClaw SDK，支持多账号、安全策略等完整功能。
  * 
- * Last updated: 2026-03-18 17:00:00
+ * Last updated: 2026-03-24
  */
 
 /**
@@ -19,10 +19,65 @@ import { dingtalkPlugin } from "./src/channel.ts";
 import { setDingtalkRuntime } from "./src/runtime.ts";
 import { registerGatewayMethods } from "./src/gateway-methods.ts";
 
+/**
+ * 检查 OpenClaw SDK 版本兼容性
+ * @param api OpenClaw Plugin API
+ * @returns true 表示版本兼容，false 表示版本过低
+ */
+function checkSdkVersion(api: OpenClawPluginApi): boolean {
+  try {
+    // 检查是否存在新版 SDK 的关键 API
+    // v0.8.4+ 需要 core.channel.routing.buildAgentSessionKey 方法
+    const hasNewRoutingApi = !!(api.runtime?.core?.channel?.routing?.buildAgentSessionKey);
+    
+    if (!hasNewRoutingApi) {
+      console.error('\n' + '='.repeat(80));
+      console.error('❌ OpenClaw SDK 版本过低');
+      console.error('='.repeat(80));
+      console.error('');
+      console.error('dingtalk-connector v0.8.4+ 需要 OpenClaw SDK v2026.3.22 或更高版本。');
+      console.error('');
+      console.error('当前 OpenClaw SDK 版本过低，缺少必要的 API：');
+      console.error('  - core.channel.routing.buildAgentSessionKey');
+      console.error('');
+      console.error('请升级 OpenClaw 到最新版本：');
+      console.error('');
+      console.error('  npm install -g openclaw@latest');
+      console.error('  # 或');
+      console.error('  yarn global add openclaw@latest');
+      console.error('');
+      console.error('升级后重启 OpenClaw Gateway 即可。');
+      console.error('');
+      console.error('如果需要使用旧版 OpenClaw，请降级 dingtalk-connector：');
+      console.error('');
+      console.error('  npm install @dingtalk-real-ai/dingtalk-connector@0.8.3');
+      console.error('');
+      console.error('='.repeat(80));
+      console.error('');
+      return false;
+    }
+    
+    return true;
+  } catch (err) {
+    console.error('检查 OpenClaw SDK 版本时出错:', err);
+    return false;
+  }
+}
+
 export default function register(api: OpenClawPluginApi) {
+  // 版本兼容性检查
+  if (!checkSdkVersion(api)) {
+    console.error('[dingtalk-connector] 插件加载失败：OpenClaw SDK 版本不兼容');
+    console.error('[dingtalk-connector] 请按照上述提示升级 OpenClaw 或降级 dingtalk-connector');
+    // 不抛出异常，避免影响其他插件加载，但不注册任何功能
+    return;
+  }
+  
   setDingtalkRuntime(api.runtime);
   api.registerChannel({ plugin: dingtalkPlugin });
   
   // 注册 Gateway Methods
   registerGatewayMethods(api);
+  
+  console.log('[dingtalk-connector] v0.8.4 已成功加载（需要 OpenClaw SDK v2026.3.22+）');
 }

package/openclaw.plugin.json

@@ -1,7 +1,7 @@
 {
   "id": "dingtalk-connector",
   "name": "DingTalk Channel",
-  "version": "0.8.3",
+  "version": "0.8.4",
   "description": "DingTalk (钉钉) messaging channel via Stream mode with AI Card streaming",
   "author": "DingTalk Real Team",
   "main": "index.ts",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dingtalk-real-ai/dingtalk-connector",
-  "version": "0.8.3",
+  "version": "0.8.5",
   "description": "DingTalk (钉钉) channel connector — Stream mode with AI Card streaming",
   "main": "index.ts",
   "type": "module",
@@ -51,11 +51,14 @@
     "fluent-ffmpeg": "^2.1.3",
     "form-data": "^4.0.0",
     "mammoth": "^1.8.0",
-    "openclaw": "^2026.3.0",
+    "openclaw": "^2026.3.22",
     "pako": "^2.1.0",
     "pdf-parse": "^1.1.1",
     "zod": "^3.22.0"
   },
+  "peerDependencies": {
+    "openclaw": ">=2026.3.22"
+  },
   "devDependencies": {
     "@types/node": "^20.19.37",
     "@vitest/coverage-v8": "^2.0.0",

package/src/core/message-handler.ts

@@ -15,7 +15,25 @@
  * - 钉钉 API 调用（accessToken、文件下载）
  * - 与 OpenClaw 框架集成（bindings、runtime）
  */
-import type { ClawdbotConfig, RuntimeEnv, HistoryEntry } from "openclaw/plugin-sdk";
+// 类型定义
+interface ClawdbotConfig {
+  [key: string]: any;
+}
+
+interface RuntimeEnv {
+  log?: (...args: any[]) => void;
+  error?: (...args: any[]) => void;
+  warn?: (...args: any[]) => void;
+  debug?: (...args: any[]) => void;
+  info?: (...args: any[]) => void;
+  [key: string]: any;
+}
+
+interface HistoryEntry {
+  role: string;
+  content: string;
+  [key: string]: any;
+}
 import type { ResolvedDingtalkAccount, DingtalkConfig } from "../types/index.ts";
 import { 
   buildSessionContext,
@@ -1101,7 +1119,7 @@ export async function handleDingTalkMessageInternal(params: HandleMessageParams)
           );
 
           // ✅ 处理裸露的本地文件路径（绕过 OpenClaw SDK 的 bug）
-          const { processRawMediaPaths } = await import('../services/media.js');
+          const { processRawMediaPaths } = await import('../services/media');
           finalText = await processRawMediaPaths(
             finalText,
             config,

package/src/policy.ts

@@ -1,17 +1,30 @@
-import type { ToolPolicy } from "openclaw/plugin-sdk";
-import type { ResolvedDingtalkAccount } from "./types/index.ts";
+// 类型定义
+interface ClawdbotConfig {
+  [key: string]: any;
+}
+
+interface ToolPolicy {
+  allow?: string[];
+  deny?: string[];
+}
+import { resolveDingtalkAccount } from "./config/accounts.ts";
 
 export function resolveDingtalkGroupToolPolicy(params: {
-  account: ResolvedDingtalkAccount;
-  groupId: string;
+  cfg: ClawdbotConfig;
+  groupId?: string | null;
+  accountId?: string | null;
 }): ToolPolicy | undefined {
-  const { account, groupId } = params;
+  const { cfg, groupId, accountId } = params;
+
+  const account = resolveDingtalkAccount({ cfg, accountId });
   const dingtalkCfg = account.config;
 
   // Check group-specific policy first
-  const groupConfig = dingtalkCfg?.groups?.[groupId];
-  if (groupConfig?.tools) {
-    return groupConfig.tools;
+  if (groupId) {
+    const groupConfig = dingtalkCfg?.groups?.[groupId];
+    if (groupConfig?.tools) {
+      return groupConfig.tools;
+    }
   }
 
   // Fall back to account-level default (allow all)

package/src/reply-dispatcher.ts

@@ -1,31 +1,49 @@
-import type {
-  ClawdbotConfig,
-  RuntimeEnv,
-  ReplyPayload,
-} from "openclaw/plugin-sdk";
-import {
+// 类型定义
+interface ClawdbotConfig {
+  [key: string]: any;
+}
+
+interface RuntimeEnv {
+  log?: (...args: any[]) => void;
+  error?: (...args: any[]) => void;
+  warn?: (...args: any[]) => void;
+  debug?: (...args: any[]) => void;
+  info?: (...args: any[]) => void;
+  [key: string]: any;
+}
+
+interface ReplyPayload {
+  text?: string;
+  [key: string]: any;
+}
+
+// ✅ 动态导入 channel-runtime 模块
+const channelRuntimeModule = await import("openclaw/plugin-sdk/channel-runtime") as any;
+
+const {
   createReplyPrefixOptions,
   createTypingCallbacks,
   logTypingFailure,
-} from "openclaw/plugin-sdk";
+} = channelRuntimeModule;
+
 import { resolveDingtalkAccount } from "./config/accounts.ts";
 import { getDingtalkRuntime } from "./runtime.ts";
 import type { DingtalkConfig } from "./types/index.ts";
 import {
   createAICardForTarget,
-  streamAICard,
   finishAICard,
-  sendMessage,
-  type AICardTarget,
+  streamAICard,
   type AICardInstance,
-} from "./services/messaging/index.ts";
+  type AICardTarget,
+} from "./services/messaging/card.ts";
+import { sendMessage } from "./services/messaging.ts";
+import { getOapiAccessToken } from "./utils/token.ts";
 import {
   processLocalImages,
   processVideoMarkers,
   processAudioMarkers,
   processFileMarkers,
 } from "./services/media/index.ts";
-import { getAccessToken, getOapiAccessToken } from "./utils/index.ts";
 
 // ============ 新会话命令归一化 ============
 
@@ -184,16 +202,16 @@ export function createDingtalkReplyDispatcher(params: CreateDingtalkReplyDispatc
     stop: async () => {
       // 钉钉暂不支持打字指示器
     },
-    onStartError: (err) =>
+    onStartError: (err: any) =>
       logTypingFailure({
-        log: (message) => params.runtime.log?.(message),
+        log: (message: any) => params.runtime.log?.(message),
         channel: "dingtalk-connector",
         action: "start",
         error: err,
       }),
-    onStopError: (err) =>
+    onStopError: (err: any) =>
       logTypingFailure({
-        log: (message) => params.runtime.log?.(message),
+        log: (message: any) => params.runtime.log?.(message),
         channel: "dingtalk-connector",
         action: "stop",
         error: err,
@@ -209,7 +227,7 @@ export function createDingtalkReplyDispatcher(params: CreateDingtalkReplyDispatc
   const chunkMode = core.channel.text.resolveChunkMode(cfg, "dingtalk-connector");
 
   // 流式 AI Card 支持
-  const streamingEnabled = account.config?.streaming !== false;
+  const streamingEnabled = (account.config as any)?.streaming !== false;
   let isCreatingCard = false;  // ✅ 添加创建中标志，防止并发创建
 
   const startStreaming = async () => {
@@ -235,7 +253,7 @@ export function createDingtalkReplyDispatcher(params: CreateDingtalkReplyDispatc
     // 这样用户看到的是同一条消息从 ACK 文案更新为最终结果，而不是多出一条消息
     if (preCreatedCard) {
       log.info(`[DingTalk][startStreaming] 复用预创建 AI Card，cardInstanceId=${preCreatedCard.cardInstanceId}`);
-      currentCardTarget = preCreatedCard;
+      currentCardTarget = preCreatedCard as any;
       accumulatedText = "";
       return;
     }
@@ -253,14 +271,9 @@ export function createDingtalkReplyDispatcher(params: CreateDingtalkReplyDispatc
       const card = await createAICardForTarget(
         account.config as DingtalkConfig,
         target,
-        {
-          info: params.runtime.info,
-          error: params.runtime.error,
-          warn: params.runtime.warn,
-          debug: params.runtime.debug,
-        }
+        params.runtime as any
       );
-      currentCardTarget = card;
+      currentCardTarget = card as any;
       accumulatedText = "";
       
       if (card) {
@@ -276,7 +289,7 @@ export function createDingtalkReplyDispatcher(params: CreateDingtalkReplyDispatc
     }
   };
 
-  const closeStreaming = async () => {
+  const closeStreaming: () => Promise<void> = async () => {
     if (!currentCardTarget) {
       log.info(`[DingTalk][closeStreaming] 无 AI Card，跳过关闭`);
       return;
@@ -339,7 +352,7 @@ export function createDingtalkReplyDispatcher(params: CreateDingtalkReplyDispatc
         
         // ✅ 处理裸露的本地文件路径（绕过 OpenClaw SDK 的 bug）
         log.info(`[DingTalk][closeStreaming] 准备调用 processRawMediaPaths`);
-        const { processRawMediaPaths } = await import('./services/media.js');
+        const { processRawMediaPaths } = await import('./services/media');
         finalText = await processRawMediaPaths(
           finalText,
           account.config as DingtalkConfig,
@@ -354,14 +367,9 @@ export function createDingtalkReplyDispatcher(params: CreateDingtalkReplyDispatc
 
       log.info(`[DingTalk][closeStreaming] 准备调用 finishAICard，文本长度=${finalText.length}`);
       await finishAICard(
-        currentCardTarget as AICardInstance,
+        currentCardTarget as any,
         finalText,
-        {
-          info: params.runtime.info,
-          error: params.runtime.error,
-          warn: params.runtime.warn,
-          debug: params.runtime.debug,
-        }
+        params.runtime as any
       );
       log.info(`[DingTalk][closeStreaming] ✅ AI Card 关闭成功`);
     } catch (error: any) {
@@ -421,7 +429,7 @@ export function createDingtalkReplyDispatcher(params: CreateDingtalkReplyDispatc
             const oapiToken = await getOapiAccessToken(account.config as DingtalkConfig);
             if (oapiToken) {
               log.info(`[DingTalk][deliver] 检测到 final 响应，准备处理裸露文件路径`);
-              const { processRawMediaPaths } = await import('./services/media.js');
+              const { processRawMediaPaths } = await import('./services/media');
               text = await processRawMediaPaths(
                 text,
                 account.config as DingtalkConfig,
@@ -471,10 +479,10 @@ export function createDingtalkReplyDispatcher(params: CreateDingtalkReplyDispatc
             log.info(`[DingTalk][deliver] 流式更新 AI Card，累积文本长度=${accumulatedText.length}`);
             try {
               await streamAICard(
-                currentCardTarget as AICardInstance,
+                currentCardTarget as any,
                 accumulatedText,
                 false,
-                params.runtime.log
+                params.runtime as any
               );
             } catch (streamErr: any) {
               log.error(`[DingTalk][deliver] ❌ streamAICard 失败：${streamErr.message}`);
@@ -647,15 +655,10 @@ export function createDingtalkReplyDispatcher(params: CreateDingtalkReplyDispatc
             
             try {
               await streamAICard(
-                currentCardTarget as AICardInstance,
+                currentCardTarget as any,
                 displayContent,
                 false,
-                {
-                  info: params.runtime.info,
-                  error: params.runtime.error,
-                  warn: params.runtime.warn,
-                  debug: params.runtime.debug,
-                }
+                params.runtime as any
               );
               lastUpdateTime = now;
               log.debug(`[DingTalk][onPartialReply] ✅ AI Card 更新成功`);

package/src/runtime.ts

@@ -1,7 +1,32 @@
-import { createPluginRuntimeStore } from "openclaw/plugin-sdk";
 import type { PluginRuntime } from "openclaw/plugin-sdk";
 
+/**
+ * 自实现的运行时存储工厂，避免依赖特定版本 openclaw 是否导出 createPluginRuntimeStore。
+ * 旧版 openclaw 没有导出该函数，直接 import 会导致 TypeError，因此在此处内联实现。
+ */
+function createRuntimeStore<T>(errorMessage: string) {
+  let runtimeValue: T | null = null;
+
+  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;
+    },
+  };
+}
+
 const { setRuntime: setDingtalkRuntime, getRuntime: getDingtalkRuntime } =
-  createPluginRuntimeStore<PluginRuntime>("DingTalk runtime not initialized");
+  createRuntimeStore<PluginRuntime>("DingTalk runtime not initialized");
 
 export { getDingtalkRuntime, setDingtalkRuntime };

package/src/sdk/helpers.ts

@@ -4,7 +4,7 @@
  * 完全独立的辅助函数，不依赖任何外部 SDK。
  */
 
-import type { SecretInput, SecretInputRef } from "./types/index.ts";
+import type { SecretInput, SecretInputRef } from "./types.ts";
 
 // ============================================================================
 // 账号 ID 处理

package/src/services/media/audio.ts

@@ -43,7 +43,7 @@ export async function processAudioMarkers(
         continue;
       }
       const uploadResult = await uploadMediaToDingTalk(absPath, 'voice', oapiToken, 20 * 1024 * 1024, log);
-      result = result.replace(full, uploadResult ? `[音频已上传：${uploadResult.downloadUrl}]` : '⚠️ 音频上传失败');
+      result = result.replace(full, uploadResult ? `[音频已上传：${uploadResult}]` : '⚠️ 音频上传失败');
     } catch {
       log?.warn?.(`${logPrefix} 解析音频标记失败：${match[1]}`);
       result = result.replace(full, '');

package/src/services/media/chunk-upload.ts

@@ -67,21 +67,15 @@ export async function enableUploadTransaction(
     form.append('file_name', fileName);
     form.append('file_size', fileSize.toString());
 
-    const uploadResp = await dingtalkUploadHttp.post(
-  `${DINGTALK_OAPI}/cspace/add_chunk`,
-  chunkData,
-  {
-    params: {
-      access_token: oapiToken,
-      agent_id: config.agentId || config.clientId,
-      transaction_id: transactionId,
-      chunk_sequence: i,
-    },
-    headers: { 'Content-Type': 'application/octet-stream' },
-    timeout: 60_000,
-    maxBodyLength: Infinity,
-  },
-);
+    const resp = await dingtalkOapiHttp.post<UploadTransactionResponse>(
+      `${DINGTALK_OAPI}/file/upload/transaction/enable`,
+      form,
+      {
+        params: { access_token: oapiToken },
+        headers: form.getHeaders(),
+        timeout: 60_000,
+      }
+    );
 
     if (resp.data.errcode === 0) {
       log.info(`事务开启成功，upload_id: ${resp.data.upload_id}`);
@@ -129,20 +123,15 @@ export async function uploadFileBlock(
       contentType: 'application/octet-stream',
     });
 
-    const commitResp = await dingtalkOapiHttp.post(
-  `${DINGTALK_OAPI}/cspace/commit`,
-  null,
-  {
-    params: {
-      access_token: oapiToken,
-      agent_id: config.agentId || config.clientId,
-      transaction_id: transactionId,
-      file_size: fileSize,
-      chunk_numbers: totalChunks,
-    },
-    timeout: 30_000,
-  },
-);
+    const resp = await dingtalkOapiHttp.post<UploadBlockResponse>(
+      `${DINGTALK_OAPI}/file/upload/chunk`,
+      form,
+      {
+        params: { access_token: oapiToken },
+        headers: form.getHeaders(),
+        timeout: 60_000,
+      }
+    );
 
     if (resp.data.errcode === 0) {
       log.info(`块 ${chunkNumber} 上传成功`);

package/src/services/media/common.ts

@@ -93,7 +93,7 @@ export async function uploadMediaToDingTalk(
     if ((mediaType === 'video' || mediaType === 'file') && fileSize > CHUNK_CONFIG.SIZE_THRESHOLD) {
       log?.info?.(`文件超过 20MB，使用分块上传：${absPath} (${fileSizeMB}MB)`);
       try {
-        const { uploadLargeFileByChunks } = await import('./chunk-upload.js');
+        const { uploadLargeFileByChunks } = await import('./chunk-upload');
         const downloadCode = await uploadLargeFileByChunks(absPath, mediaType, oapiToken, debugEnabled);
         if (downloadCode) {
           log?.info?.(`分块上传成功：${absPath}, download_code: ${downloadCode}`);
@@ -126,10 +126,10 @@ export async function uploadMediaToDingTalk(
     log?.info?.(`上传文件：${absPath} (${fileSizeMB}MB), uploadType=${uploadType}`);
     const resp = await dingtalkUploadHttp.post(
       `${DINGTALK_OAPI}/media/upload`,
-      formData,
+      form,
       {
         params: { access_token: oapiToken, type: mediaType },
-        headers: formData.getHeaders(),
+        headers: form.getHeaders(),
         timeout: 60_000,
         maxBodyLength: Infinity,
       },

package/src/services/media/file.ts

@@ -59,7 +59,7 @@ export async function processFileMarkers(
       const fileData = JSON.parse(match[1]);
       const absPath = toLocalPath(fileData.path);
       const uploadResult = await uploadMediaToDingTalk(absPath, 'file', oapiToken, 20 * 1024 * 1024, log);
-      result = result.replace(full, uploadResult ? `[文件已上传：${uploadResult.downloadUrl}]` : '⚠️ 文件上传失败');
+      result = result.replace(full, uploadResult ? `[文件已上传：${uploadResult}]` : '⚠️ 文件上传失败');
     } catch {
       log?.warn?.(`${logPrefix} 解析文件标记失败：${match[1]}`);
       result = result.replace(full, '');

package/src/services/media/image.ts

@@ -3,7 +3,15 @@
  * 支持图片上传、本地路径处理
  */
 
-import type { Logger } from 'openclaw/plugin-sdk';
+// 本地类型定义
+interface Logger {
+  info?: (...args: any[]) => void;
+  warn?: (...args: any[]) => void;
+  error?: (...args: any[]) => void;
+  debug?: (...args: any[]) => void;
+  [key: string]: any;
+}
+
 import {
   LOCAL_IMAGE_RE,
   BARE_IMAGE_PATH_RE,
@@ -35,7 +43,7 @@ export async function processLocalImages(
       const cleanPath = rawPath.replace(/\\ /g, ' ');
       const uploadResult = await uploadMediaToDingTalk(cleanPath, 'image', oapiToken, 20 * 1024 * 1024, log);
       if (uploadResult) {
-        result = result.replace(fullMatch, `![${alt}](${uploadResult.downloadUrl})`);
+        result = result.replace(fullMatch, `![${alt}](${uploadResult})`);
       }
     }
   }
@@ -56,7 +64,7 @@ export async function processLocalImages(
       log?.info?.(`[DingTalk][Media] 纯文本图片："${fullMatch}" -> path="${rawPath}"`);
       const uploadResult = await uploadMediaToDingTalk(rawPath, 'image', oapiToken, 20 * 1024 * 1024, log);
       if (uploadResult) {
-        const replacement = `![](${uploadResult.downloadUrl})`;
+        const replacement = `![](${uploadResult})`;
         result = result.slice(0, match.index!) + result.slice(match.index!).replace(fullMatch, replacement);
         log?.info?.(`[DingTalk][Media] 替换纯文本路径为图片：${replacement}`);
       }

package/src/services/messaging.ts

@@ -697,7 +697,7 @@ export async function sendMediaToDingTalk(params: {
       const videoMarker = `[DINGTALK_VIDEO]{"path":"${mediaUrl}"}[/DINGTALK_VIDEO]`;
 
       // 直接处理视频标记（上传并发送视频消息）
-      const { processVideoMarkers } = await import("./media.js");
+      const { processVideoMarkers } = await import("./media");
       await processVideoMarkers(
         videoMarker, // 只传入标记，不包含原始文本
         "",

package/src/types/index.ts

@@ -1,4 +1,11 @@
-import type { BaseProbeResult } from "openclaw/plugin-sdk";
+// 本地类型定义
+interface BaseProbeResult<T = any> {
+  ok: boolean;
+  error?: string;
+  data?: T;
+  [key: string]: any;
+}
+
 import type {
   DingtalkConfigSchema,
   DingtalkGroupSchema,

package/tsconfig.json

@@ -0,0 +1,20 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "lib": ["ES2022"],
+    "moduleResolution": "bundler",
+    "esModuleInterop": true,
+    "allowSyntheticDefaultImports": true,
+    "strict": false,
+    "skipLibCheck": true,
+    "resolveJsonModule": true,
+    "allowJs": true,
+    "noEmit": true,
+    "allowImportingTsExtensions": true,
+    "types": ["node"],
+    "noImplicitAny": false
+  },
+  "include": ["src/**/*", "index.ts"],
+  "exclude": ["node_modules", "dist"]
+}