@soimy/dingtalk 2.6.5 → 2.7.0

package/README.md

@@ -308,6 +308,7 @@ openclaw gateway restart
 - 通过 `cardTemplateId` 指定模板
 - 通过 `cardTemplateKey` 指定内容字段
 - **适用于 AI 对话场景**
+- 支持在卡片中实时显示 AI 思考过程（推理流）和工具执行结果
 
 **AI Card API 特性：**
 当配置 `messageType: 'card'` 时：
@@ -317,6 +318,24 @@ openclaw gateway restart
 3. 自动状态管理（PROCESSING → INPUTING → FINISHED）
 4. 更稳定的流式体验，无需手动节流
 
+### AI 思考过程与工具执行显示（AI Card 模式）
+
+当 `messageType` 为 `card` 时，插件可以在卡片中实时展示 AI 的推理过程（🤔 思考中）和工具调用结果（🛠️ 工具执行）。这两项功能通过**对话级命令**控制，无需修改配置文件：
+
+| 功能              | 对话命令              | 说明                               |
+| ----------------- | --------------------- | ---------------------------------- |
+| 显示 AI 推理流    | `/reasoning stream`   | 开启后，AI 思考内容实时更新到卡片  |
+| 显示工具执行结果  | `/verbose on`         | 开启后，工具调用结果实时更新到卡片 |
+| 关闭 AI 推理流    | `/reasoning off`      | 关闭推理流显示                     |
+| 关闭工具执行显示  | `/verbose off`        | 关闭工具执行结果显示               |
+
+**显示格式：**
+
+- 思考内容以 `🤔 **思考中**` 为标题，正文以 `>` 引用块展示，最多显示前 500 个字符
+- 工具结果以 `🛠️ **工具执行**` 为标题，正文以 `>` 引用块展示，最多显示前 500 个字符
+
+> **注意：** 推理流和工具执行均会产生额外的卡片流式更新 API 调用，在 AI 推理步骤较多时可能显著增加 API 消耗，建议按需开启。
+
 **配置示例：**
 
 ```json5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@soimy/dingtalk",
-  "version": "2.6.5",
+  "version": "2.7.0",
   "description": "DingTalk (钉钉) channel plugin for OpenClaw",
   "main": "index.ts",
   "type": "module",
@@ -31,6 +31,10 @@
     "url": "git+https://github.com/soimy/openclaw-channel-dingtalk.git"
   },
   "homepage": "https://github.com/soimy/openclaw-channel-dingtalk",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
   "dependencies": {
     "axios": "^1.6.0",
     "dingtalk-stream": "^2.1.4",
@@ -76,4 +80,4 @@
       "defaultChoice": "npm"
     }
   }
-}
+}

package/src/channel.ts

@@ -65,6 +65,9 @@ const CARD_CACHE_TTL = 60 * 60 * 1000; // 1 hour
 // DingTalk API base URL
 const DINGTALK_API = 'https://api.dingtalk.com';
 
+// Thinking and tool usage message truncate length
+const THINKING_TRUNCATE_LENGTH = 500;
+
 // ============ Message Deduplication ============
 // Prevents duplicate message processing when DingTalk retries delivery
 // Uses pure in-memory storage with short TTL and lazy cleanup during processing
@@ -637,9 +640,72 @@ async function downloadMedia(
 function extractMessageContent(data: DingTalkInboundMessage): MessageContent {
   const msgtype = data.msgtype || 'text';
 
+  // Helper function to format quoted content from DingTalk's reply message structure
+  const formatQuotedContent = (): string => {
+    const textField = data.text as any;
+
+    // Case 1: isReplyMsg=true WITH repliedMsg content (desktop client)
+    if (textField?.isReplyMsg && textField?.repliedMsg) {
+      const repliedMsg = textField.repliedMsg;
+      const content = repliedMsg?.content;
+
+      // Try plain text format first
+      if (content?.text) {
+        const quoteText = content.text.trim();
+        if (quoteText) {
+          return `[引用消息: "${quoteText}"]\n\n`;
+        }
+      }
+
+      // Handle richText format
+      if (content?.richText && Array.isArray(content.richText)) {
+        const textParts: string[] = [];
+        for (const part of content.richText) {
+          if (part.msgType === 'text' && part.content) {
+            textParts.push(part.content);
+          } else if (part.msgType === 'emoji' || part.type === 'emoji') {
+            textParts.push(part.content || '[表情]');
+          } else if (part.msgType === 'picture' || part.type === 'picture') {
+            textParts.push('[图片]');
+          } else if (part.msgType === 'at' || part.type === 'at') {
+            textParts.push(`@${part.content || part.atName || '某人'}`);
+          } else if (part.text) {
+            textParts.push(part.text);
+          }
+        }
+        const quoteText = textParts.join('').trim();
+        if (quoteText) {
+          return `[引用消息: "${quoteText}"]\n\n`;
+        }
+      }
+    }
+
+    // Case 2: isReplyMsg=true WITHOUT repliedMsg (rich media quote, mobile or desktop - only has originalMsgId)
+    if (textField?.isReplyMsg && !textField?.repliedMsg && data.originalMsgId) {
+      return `[这是一条引用消息，原消息ID: ${data.originalMsgId}]\n\n`;
+    }
+
+    // Fallback: Check for quoteMessage field (legacy format)
+    if (data.quoteMessage) {
+      const quoteText = data.quoteMessage.text?.content?.trim() || '';
+      if (quoteText) {
+        return `[引用消息: "${quoteText}"]\n\n`;
+      }
+    }
+
+    // Fallback: Check for quoteContent in content field
+    if (data.content?.quoteContent) {
+      return `[引用消息: "${data.content.quoteContent}"]\n\n`;
+    }
+
+    return '';
+  };
+
+  const quotedPrefix = formatQuotedContent();
+
   // Logic for different message types
   if (msgtype === 'text') {
-    return { text: data.text?.content?.trim() || '', messageType: 'text' };
+    return { text: quotedPrefix + (data.text?.content?.trim() || ''), messageType: 'text' };
   }
 
   // Improved richText parsing: join all text/at components and extract first picture
@@ -657,7 +723,7 @@ function extractMessageContent(data: DingTalkInboundMessage): MessageContent {
       }
     }
     return {
-      text: text.trim() || (pictureDownloadCode ? '<media:image>' : '[富文本消息]'),
+      text: quotedPrefix + (text.trim() || (pictureDownloadCode ? '<media:image>' : '[富文本消息]')),
       mediaPath: pictureDownloadCode,
       mediaType: pictureDownloadCode ? 'image' : undefined,
       messageType: 'richText',
@@ -852,6 +918,29 @@ async function createAICard(
   }
 }
 
+/**
+ * Format thinking/tool content for display in AI Card
+ * Truncates to configured length and adds "> " prefix to each line
+ */
+function formatContentForCard(content: string, type: 'thinking' | 'tool'): string {
+  if (!content) return '';
+
+  // truncate to configured length, add ellipsis if truncated
+  const truncated = content.slice(0, THINKING_TRUNCATE_LENGTH) + (content.length > THINKING_TRUNCATE_LENGTH ? '…' : '');
+
+  // split into lines, then escape leading/trailing underscore per line, then prefix with ">"
+  const quotedLines = truncated
+    .split('\n')
+    .map((line) => line.replace(/^_(?=[^ ])/, '*').replace(/(?<=[^ ])_(?=$)/, '*'))
+    .map((line) => `> ${line}`)
+    .join('\n');
+
+  const emoji = type === 'thinking' ? '🤔' : '🛠️';
+  const label = type === 'thinking' ? '思考中' : '工具执行';
+
+  return `${emoji} **${label}**\n${quotedLines}`;
+}
+
 /**
  * Stream update AI Card content using the new DingTalk API
  * Always use isFull=true to fully replace the Markdown content
@@ -1292,11 +1381,24 @@ async function handleDingTalkMessage(params: HandleDingTalkMessageParams): Promi
     cfg,
     dispatcherOptions: {
       responsePrefix: '',
-      deliver: async (payload: any) => {
+      deliver: async (payload: any, info?: { kind: string }) => {
         try {
           const textToSend = payload.markdown || payload.text;
           if (!textToSend) return;
 
+          // Handle tool results separately for AI Card streaming
+          //
+          // Note: use /verbose on in conversation to get tool execution info
+          //
+          if (useCardMode && currentAICard && info?.kind === 'tool') {
+            log?.info?.(`[DingTalk] Tool result received, streaming to AI Card: ${textToSend.slice(0, 100)}`);
+            const toolText = formatContentForCard(textToSend, 'tool');
+            if (toolText) {
+              await streamAICard(currentAICard, toolText, false, log);
+              return; // Don't send via sendMessage for tool results in card mode
+            }
+          }
+
           lastCardContent = textToSend;
           await sendMessage(dingtalkConfig, to, textToSend, {
             sessionWebhook,
@@ -1310,6 +1412,21 @@ async function handleDingTalkMessage(params: HandleDingTalkMessageParams): Promi
         }
       },
     },
+    replyOptions: {
+      // Handle reasoning stream updates to update the AI Card content in real-time
+      // Note: use /reasoning stream in conversation to get reasoning stream updates
+      //
+      onReasoningStream: async (payload: any) => {
+        if (!useCardMode || !currentAICard) { return; }
+        const thinkingText = formatContentForCard(payload.text, 'thinking');
+        if (!thinkingText) return;
+        try {
+          await streamAICard(currentAICard, thinkingText, false, log);
+        } catch (err: any) {
+          log?.debug?.(`[DingTalk] Thinking stream update failed: ${err.message}`);
+        }
+      },
+    },
   });
 
   // Finalize AI card
@@ -1401,7 +1518,8 @@ export const dingtalkPlugin: DingTalkChannelPlugin = {
       };
     },
     defaultAccountId: (): string => 'default',
-    isConfigured: (account: ResolvedAccount): boolean => Boolean(account.config?.clientId && account.config?.clientSecret),
+    isConfigured: (account: ResolvedAccount): boolean =>
+      Boolean(account.config?.clientId && account.config?.clientSecret),
     describeAccount: (account: ResolvedAccount) => ({
       accountId: account.accountId,
       name: account.config?.name || 'DingTalk',
@@ -1462,7 +1580,9 @@ export const dingtalkPlugin: DingTalkChannelPlugin = {
         }
         throw new Error(typeof result.error === 'string' ? result.error : JSON.stringify(result.error));
       } catch (err: any) {
-        throw new Error(typeof err?.response?.data === 'string' ? err.response.data : err?.message || 'sendText failed');
+        throw new Error(
+          typeof err?.response?.data === 'string' ? err.response.data : err?.message || 'sendText failed'
+        );
       }
     },
     sendMedia: async ({
@@ -1479,13 +1599,13 @@ export const dingtalkPlugin: DingTalkChannelPlugin = {
       if (!config.clientId) throw new Error('DingTalk not configured');
 
       // Support mediaPath, filePath, and mediaUrl parameter names
-      const actualMediaPath = mediaPath || filePath || mediaUrl;
+      const rawMediaPath = mediaPath || filePath || mediaUrl;
 
       getLogger()?.debug?.(
-        `[DingTalk] sendMedia called: to=${to}, mediaPath=${mediaPath}, filePath=${filePath}, mediaUrl=${mediaUrl}, actualMediaPath=${actualMediaPath}`
+        `[DingTalk] sendMedia called: to=${to}, mediaPath=${mediaPath}, filePath=${filePath}, mediaUrl=${mediaUrl}, rawMediaPath=${rawMediaPath}`
       );
 
-      if (!actualMediaPath) {
+      if (!rawMediaPath) {
         throw new Error(
           `mediaPath, filePath, or mediaUrl is required. Received: ${JSON.stringify({
             to,
@@ -1496,6 +1616,13 @@ export const dingtalkPlugin: DingTalkChannelPlugin = {
         );
       }
 
+      // Resolve user path to expand ~ and relative paths
+      const actualMediaPath = resolveUserPath(rawMediaPath);
+
+      getLogger()?.debug?.(
+        `[DingTalk] sendMedia resolved path: rawMediaPath=${rawMediaPath}, actualMediaPath=${actualMediaPath}`
+      );
+
       try {
         // Detect media type from file extension if not provided
         const mediaType = providedMediaType || detectMediaTypeFromExtension(actualMediaPath);
@@ -1518,7 +1645,9 @@ export const dingtalkPlugin: DingTalkChannelPlugin = {
         }
         throw new Error(typeof result.error === 'string' ? result.error : JSON.stringify(result.error));
       } catch (err: any) {
-        throw new Error(typeof err?.response?.data === 'string' ? err.response.data : err?.message || 'sendMedia failed');
+        throw new Error(
+          typeof err?.response?.data === 'string' ? err.response.data : err?.message || 'sendMedia failed'
+        );
       }
     },
   },
@@ -1674,6 +1803,11 @@ export const dingtalkPlugin: DingTalkChannelPlugin = {
             lastError: null,
           });
           ctx.log?.info?.(`[${account.accountId}] DingTalk Stream client connected successfully`);
+
+          // Keep startAccount alive until the connection manager is explicitly stopped.
+          // The Gateway treats the Promise resolution as "channel finished" and would
+          // trigger auto-restart if we returned here immediately after connecting.
+          await connectionManager.waitForStop();
         } else {
           // Startup was cancelled or connection is not established; do not overwrite stopped snapshot.
           ctx.log?.info?.(

package/src/config-schema.ts

@@ -1,10 +1,6 @@
 import { z } from 'zod';
 
-/**
- * DingTalk configuration schema using Zod
- * Mirrors the structure needed for proper control-ui rendering
- */
-export const DingTalkConfigSchema: z.ZodTypeAny = z.object({
+const DingTalkAccountConfigSchema = z.object({
   /** Account name (optional display name) */
   name: z.string().optional(),
 
@@ -66,14 +62,6 @@ export const DingTalkConfigSchema: z.ZodTypeAny = z.object({
     )
     .optional(),
 
-  /** Multi-account configuration */
-  accounts: z
-    .record(
-      z.string(),
-      z.lazy(() => DingTalkConfigSchema)
-    )
-    .optional(),
-
   /** Connection robustness configuration */
 
   /** Maximum number of connection attempts before giving up (default: 10) */
@@ -89,4 +77,18 @@ export const DingTalkConfigSchema: z.ZodTypeAny = z.object({
   reconnectJitter: z.number().min(0).max(1).optional().default(0.3),
 });
 
+/**
+ * DingTalk configuration schema using Zod
+ * Mirrors the structure needed for proper control-ui rendering
+ */
+export const DingTalkConfigSchema: z.ZodTypeAny = DingTalkAccountConfigSchema.extend({
+  /** Multi-account configuration */
+  accounts: z
+    .record(
+      z.string(),
+      DingTalkAccountConfigSchema.optional()
+    )
+    .optional(),
+});
+
 export type DingTalkConfig = z.infer<typeof DingTalkConfigSchema>;

package/src/connection-manager.ts

@@ -37,6 +37,9 @@ export class ConnectionManager {
   private sleepTimeout?: NodeJS.Timeout;
   private sleepResolve?: () => void;
 
+  // Stop signal for waitForStop()
+  private stopPromiseResolvers: Array<() => void> = [];
+
   // Client reference
   private client: DWClient;
 
@@ -366,6 +369,27 @@ export class ConnectionManager {
 
     this.state = ConnectionStateEnum.DISCONNECTED;
     this.log?.info?.(`[${this.accountId}] Connection manager stopped`);
+
+    // Resolve all pending waitForStop() promises
+    for (const resolve of this.stopPromiseResolvers) {
+      resolve();
+    }
+    this.stopPromiseResolvers = [];
+  }
+
+  /**
+   * Returns a Promise that resolves when the connection manager is stopped.
+   * Useful for keeping a caller alive (e.g. startAccount) until the channel
+   * is explicitly stopped via stop() or an abort signal handler that calls stop().
+   * Safe to call concurrently; all pending callers are resolved when stop() is called.
+   */
+  public waitForStop(): Promise<void> {
+    if (this.stopped) {
+      return Promise.resolve();
+    }
+    return new Promise<void>((resolve) => {
+      this.stopPromiseResolvers.push(resolve);
+    });
   }
 
   /**

package/src/onboarding.ts

@@ -1,9 +1,9 @@
-import type { OpenClawConfig, ChannelOnboardingAdapter, WizardPrompter } from "openclaw/plugin-sdk";
-import { DEFAULT_ACCOUNT_ID, normalizeAccountId, formatDocsLink } from "openclaw/plugin-sdk";
-import type { DingTalkConfig, DingTalkChannelConfig } from "./types.js";
-import { listDingTalkAccountIds, resolveDingTalkAccount } from "./types.js";
+import type { OpenClawConfig, ChannelOnboardingAdapter, WizardPrompter } from 'openclaw/plugin-sdk';
+import { DEFAULT_ACCOUNT_ID, normalizeAccountId, formatDocsLink } from 'openclaw/plugin-sdk';
+import type { DingTalkConfig, DingTalkChannelConfig } from './types.js';
+import { listDingTalkAccountIds, resolveDingTalkAccount } from './types.js';
 
-const channel = "dingtalk" as const;
+const channel = 'dingtalk' as const;
 
 function isConfigured(account: DingTalkConfig): boolean {
   return Boolean(account.clientId && account.clientSecret);
@@ -64,15 +64,15 @@ async function promptDingTalkAccountId(options: {
 async function noteDingTalkHelp(prompter: WizardPrompter): Promise<void> {
   await prompter.note(
     [
-      "You need DingTalk application credentials.",
-      "1. Visit https://open-dev.dingtalk.com/",
-      "2. Create an enterprise internal application",
+      'You need DingTalk application credentials.',
+      '1. Visit https://open-dev.dingtalk.com/',
+      '2. Create an enterprise internal application',
       "3. Enable 'Robot' capability",
       "4. Configure message receiving mode as 'Stream mode'",
-      "5. Copy Client ID (AppKey) and Client Secret (AppSecret)",
-      `Docs: ${formatDocsLink("/channels/dingtalk", "channels/dingtalk")}`,
-    ].join("\n"),
-    "DingTalk setup",
+      '5. Copy Client ID (AppKey) and Client Secret (AppSecret)',
+      `Docs: ${formatDocsLink('/channels/dingtalk', 'channels/dingtalk')}`,
+    ].join('\n'),
+    'DingTalk setup'
   );
 }
 
@@ -86,7 +86,7 @@ function applyAccountConfig(params: {
 
   const namedConfig = applyAccountNameToChannelSection({
     cfg,
-    channelKey: "dingtalk",
+    channelKey: 'dingtalk',
     accountId,
     name: input.name,
   });
@@ -103,7 +103,7 @@ function applyAccountConfig(params: {
     ...(input.allowFrom && input.allowFrom.length > 0 ? { allowFrom: input.allowFrom } : {}),
     ...(input.messageType ? { messageType: input.messageType } : {}),
     ...(input.cardTemplateId ? { cardTemplateId: input.cardTemplateId } : {}),
-    ...(input.cardTemplateKey ? { cardTemplateKey: input.cardTemplateKey } : {}),
+    ...(input.cardTemplateKey ? { cardTemplateKey: input.cardTemplateKey } : {})
   };
 
   if (useDefault) {
@@ -121,8 +121,7 @@ function applyAccountConfig(params: {
   }
 
   const accounts = (base as { accounts?: Record<string, unknown> }).accounts ?? {};
-  const existingAccount =
-    (base as { accounts?: Record<string, Record<string, unknown>> }).accounts?.[accountId] ?? {};
+  const existingAccount = (base as { accounts?: Record<string, Record<string, unknown>> }).accounts?.[accountId] ?? {};
 
   return {
     ...namedConfig,
@@ -156,8 +155,8 @@ export const dingtalkOnboardingAdapter: ChannelOnboardingAdapter = {
     return Promise.resolve({
       channel,
       configured,
-      statusLines: [`DingTalk: ${configured ? "configured" : "needs setup"}`],
-      selectionHint: configured ? "configured" : "钉钉企业机器人",
+      statusLines: [`DingTalk: ${configured ? 'configured' : 'needs setup'}`],
+      selectionHint: configured ? 'configured' : '钉钉企业机器人',
       quickstartScore: configured ? 1 : 4,
     });
   },
@@ -169,7 +168,7 @@ export const dingtalkOnboardingAdapter: ChannelOnboardingAdapter = {
       accountId = await promptDingTalkAccountId({
         cfg,
         prompter,
-        label: "DingTalk",
+        label: 'DingTalk',
         currentId: accountId,
         listAccountIds: listDingTalkAccountIds,
         defaultAccountId: DEFAULT_ACCOUNT_ID,
@@ -180,21 +179,21 @@ export const dingtalkOnboardingAdapter: ChannelOnboardingAdapter = {
     await noteDingTalkHelp(prompter);
 
     const clientId = await prompter.text({
-      message: "Client ID (AppKey)",
-      placeholder: "dingxxxxxxxx",
+      message: 'Client ID (AppKey)',
+      placeholder: 'dingxxxxxxxx',
       initialValue: resolved.clientId ?? undefined,
-      validate: (value) => (String(value ?? "").trim() ? undefined : "Required"),
+      validate: (value) => (String(value ?? '').trim() ? undefined : 'Required'),
     });
 
     const clientSecret = await prompter.text({
-      message: "Client Secret (AppSecret)",
-      placeholder: "xxx-xxx-xxx-xxx",
+      message: 'Client Secret (AppSecret)',
+      placeholder: 'xxx-xxx-xxx-xxx',
       initialValue: resolved.clientSecret ?? undefined,
-      validate: (value) => (String(value ?? "").trim() ? undefined : "Required"),
+      validate: (value) => (String(value ?? '').trim() ? undefined : 'Required'),
     });
 
     const wantsFullConfig = await prompter.confirm({
-      message: "Configure robot code, corp ID, and agent ID? (recommended for full features)",
+      message: 'Configure robot code, corp ID, and agent ID? (recommended for full features)',
       initialValue: false,
     });
 
@@ -206,100 +205,100 @@ export const dingtalkOnboardingAdapter: ChannelOnboardingAdapter = {
       robotCode =
         String(
           await prompter.text({
-            message: "Robot Code",
-            placeholder: "dingxxxxxxxx",
+            message: 'Robot Code',
+            placeholder: 'dingxxxxxxxx',
             initialValue: resolved.robotCode ?? undefined,
-          }),
+          })
         ).trim() || undefined;
 
       corpId =
         String(
           await prompter.text({
-            message: "Corp ID",
-            placeholder: "dingxxxxxxxx",
+            message: 'Corp ID',
+            placeholder: 'dingxxxxxxxx',
             initialValue: resolved.corpId ?? undefined,
-          }),
+          })
         ).trim() || undefined;
 
       agentId =
         String(
           await prompter.text({
-            message: "Agent ID",
-            placeholder: "123456789",
+            message: 'Agent ID',
+            placeholder: '123456789',
             initialValue: resolved.agentId ? String(resolved.agentId) : undefined,
-          }),
+          })
         ).trim() || undefined;
     }
 
     const wantsCardMode = await prompter.confirm({
-      message: "Enable AI interactive card mode? (for streaming AI responses)",
-      initialValue: resolved.messageType === "card",
+      message: 'Enable AI interactive card mode? (for streaming AI responses)',
+      initialValue: resolved.messageType === 'card',
     });
 
     let cardTemplateId: string | undefined;
     let cardTemplateKey: string | undefined;
-    let messageType: "markdown" | "card" = "markdown";
+    let messageType: 'markdown' | 'card' = 'markdown';
 
     if (wantsCardMode) {
       await prompter.note(
         [
-          "Create an AI card template in DingTalk Developer Console:",
-          "https://open-dev.dingtalk.com/fe/card",
+          'Create an AI card template in DingTalk Developer Console:',
+          'https://open-dev.dingtalk.com/fe/card',
           "1. Go to 'My Templates' > 'Create Template'",
           "2. Select 'AI Card' scenario",
-          "3. Design your card and publish",
-          "4. Copy the Template ID (e.g., xxx.schema)",
-        ].join("\n"),
-        "Card Template Setup",
+          '3. Design your card and publish',
+          '4. Copy the Template ID (e.g., xxx.schema)',
+        ].join('\n'),
+        'Card Template Setup'
       );
 
       cardTemplateId =
         String(
           await prompter.text({
-            message: "Card Template ID",
-            placeholder: "xxxxx-xxxxx-xxxxx.schema",
+            message: 'Card Template ID',
+            placeholder: 'xxxxx-xxxxx-xxxxx.schema',
             initialValue: resolved.cardTemplateId ?? undefined,
-          }),
+          })
         ).trim() || undefined;
 
       cardTemplateKey =
         String(
           await prompter.text({
-            message: "Card Template Key (content field name)",
-            placeholder: "msgContent",
-            initialValue: resolved.cardTemplateKey ?? "msgContent",
-          }),
-        ).trim() || "msgContent";
+            message: 'Card Template Key (content field name)',
+            placeholder: 'msgContent',
+            initialValue: resolved.cardTemplateKey ?? 'msgContent',
+          })
+        ).trim() || 'msgContent';
 
-      messageType = "card";
+      messageType = 'card';
     }
 
     const dmPolicyValue = await prompter.select({
-      message: "Direct message policy",
+      message: 'Direct message policy',
       options: [
-        { label: "Open - anyone can DM", value: "open" },
-        { label: "Allowlist - only allowed users", value: "allowlist" },
+        { label: 'Open - anyone can DM', value: 'open' },
+        { label: 'Allowlist - only allowed users', value: 'allowlist' },
       ],
-      initialValue: resolved.dmPolicy ?? "open",
+      initialValue: resolved.dmPolicy ?? 'open',
     });
 
     let allowFrom: string[] | undefined;
-    if (dmPolicyValue === "allowlist") {
+    if (dmPolicyValue === 'allowlist') {
       const entry = await prompter.text({
-        message: "Allowed user IDs (comma-separated)",
-        placeholder: "user1, user2",
+        message: 'Allowed user IDs (comma-separated)',
+        placeholder: 'user1, user2',
       });
-      const parsed = parseList(String(entry ?? ""));
+      const parsed = parseList(String(entry ?? ''));
       allowFrom = parsed.length > 0 ? parsed : undefined;
     }
 
     const groupPolicyValue = await prompter.select({
-      message: "Group message policy",
+      message: 'Group message policy',
       options: [
-        { label: "Open - any group can use bot", value: "open" },
-        { label: "Allowlist - only allowed groups", value: "allowlist" },
+        { label: 'Open - any group can use bot', value: 'open' },
+        { label: 'Allowlist - only allowed groups', value: 'allowlist' },
       ],
-      initialValue: resolved.groupPolicy ?? "open",
+      initialValue: resolved.groupPolicy ?? 'open',
     });
 
     const next = applyAccountConfig({
@@ -311,8 +310,8 @@ export const dingtalkOnboardingAdapter: ChannelOnboardingAdapter = {
         robotCode,
         corpId,
         agentId,
-        dmPolicy: dmPolicyValue as "open" | "allowlist",
-        groupPolicy: groupPolicyValue as "open" | "allowlist",
+        dmPolicy: dmPolicyValue as 'open' | 'allowlist',
+        groupPolicy: groupPolicyValue as 'open' | 'allowlist',
         allowFrom,
         messageType,
         cardTemplateId,

package/src/types.ts

@@ -15,7 +15,7 @@ import type {
   ChannelAccountSnapshot as SDKChannelAccountSnapshot,
   ChannelGatewayContext as SDKChannelGatewayContext,
   ChannelPlugin as SDKChannelPlugin,
-} from "openclaw/plugin-sdk";
+} from 'openclaw/plugin-sdk';
 
 /**
  * DingTalk channel configuration (extends base OpenClaw config)
@@ -28,12 +28,12 @@ export interface DingTalkConfig extends OpenClawConfig {
   agentId?: string;
   name?: string;
   enabled?: boolean;
-  dmPolicy?: "open" | "pairing" | "allowlist";
-  groupPolicy?: "open" | "allowlist";
+  dmPolicy?: 'open' | 'pairing' | 'allowlist';
+  groupPolicy?: 'open' | 'allowlist';
   allowFrom?: string[];
   showThinking?: boolean;
   debug?: boolean;
-  messageType?: "markdown" | "card";
+  messageType?: 'markdown' | 'card';
   cardTemplateId?: string;
   cardTemplateKey?: string;
   groups?: Record<string, { systemPrompt?: string }>;
@@ -56,12 +56,12 @@ export interface DingTalkChannelConfig {
   corpId?: string;
   agentId?: string;
   name?: string;
-  dmPolicy?: "open" | "pairing" | "allowlist";
-  groupPolicy?: "open" | "allowlist";
+  dmPolicy?: 'open' | 'pairing' | 'allowlist';
+  groupPolicy?: 'open' | 'allowlist';
   allowFrom?: string[];
   showThinking?: boolean;
   debug?: boolean;
-  messageType?: "markdown" | "card";
+  messageType?: 'markdown' | 'card';
   cardTemplateId?: string;
   cardTemplateKey?: string;
   groups?: Record<string, { systemPrompt?: string }>;
@@ -123,6 +123,19 @@ export interface DingTalkInboundMessage {
   createAt: number;
   text?: {
     content: string;
+    isReplyMsg?: boolean;        // 是否是回复消息
+    repliedMsg?: {               // 被回复的消息
+      content?: {
+        text?: string;
+        richText?: Array<{
+          msgType?: string;
+          type?: string;
+          content?: string;
+          code?: string;
+          atName?: string;
+        }>;
+      };
+    };
   };
   content?: {
     downloadCode?: string;
@@ -134,7 +147,18 @@ export interface DingTalkInboundMessage {
       atName?: string;
       downloadCode?: string; // For picture type in richText
     }>;
+    quoteContent?: string;       // 替代引用格式
+  };
+  // Legacy 引用格式
+  quoteMessage?: {
+    msgId?: string;
+    msgtype?: string;
+    text?: { content: string; };
+    senderNick?: string;
+    senderId?: string;
   };
+  // 富媒体引用，仅有消息ID的情况（包括手机端和PC端）
+  originalMsgId?: string;
   conversationType: string;
   conversationId: string;
   conversationTitle?: string;
@@ -166,7 +190,7 @@ export interface SendMessageOptions {
   mediaPath?: string;
   filePath?: string;
   mediaUrl?: string;
-  mediaType?: "image" | "voice" | "video" | "file";
+  mediaType?: 'image' | 'voice' | 'video' | 'file';
 }
 
 /**
@@ -238,7 +262,7 @@ export interface AxiosRequestConfig {
   method?: string;
   data?: any;
   headers?: Record<string, string>;
-  responseType?: "arraybuffer" | "json" | "text";
+  responseType?: 'arraybuffer' | 'json' | 'text';
 }
 
 /**
@@ -367,7 +391,7 @@ export interface SendMediaParams {
  * DingTalk outbound handler configuration
  */
 export interface DingTalkOutboundHandler {
-  deliveryMode: "direct" | "queued" | "batch";
+  deliveryMode: 'direct' | 'queued' | 'batch';
   resolveTarget: (params: ResolveTargetParams) => TargetResolutionResult;
   sendText: (params: SendTextParams) => Promise<{ ok: boolean; data?: any; error?: any }>;
   sendMedia?: (params: SendMediaParams) => Promise<{ ok: boolean; data?: any; error?: any }>;
@@ -377,10 +401,10 @@ export interface DingTalkOutboundHandler {
  * AI Card status constants
  */
 export const AICardStatus = {
-  PROCESSING: "1",
-  INPUTING: "2",
-  FINISHED: "3",
-  FAILED: "5",
+  PROCESSING: '1',
+  INPUTING: '2',
+  FINISHED: '3',
+  FAILED: '5',
 } as const;
 
 /**
@@ -418,11 +442,11 @@ export interface AICardStreamingRequest {
  * Connection state enum for lifecycle management
  */
 export enum ConnectionState {
-  DISCONNECTED = "DISCONNECTED",
-  CONNECTING = "CONNECTING",
-  CONNECTED = "CONNECTED",
-  DISCONNECTING = "DISCONNECTING",
-  FAILED = "FAILED",
+  DISCONNECTED = 'DISCONNECTED',
+  CONNECTING = 'CONNECTING',
+  CONNECTED = 'CONNECTED',
+  DISCONNECTING = 'DISCONNECTING',
+  FAILED = 'FAILED',
 }
 
 /**
@@ -449,7 +473,7 @@ export interface ConnectionAttemptResult {
 
 // ============ Onboarding Helper Functions ============
 
-const DEFAULT_ACCOUNT_ID = "default";
+const DEFAULT_ACCOUNT_ID = 'default';
 
 /**
  * List all DingTalk account IDs from config
@@ -484,18 +508,15 @@ export interface ResolvedDingTalkAccount extends DingTalkConfig {
 /**
  * Resolve a specific DingTalk account configuration
  */
-export function resolveDingTalkAccount(
-  cfg: OpenClawConfig,
-  accountId?: string | null,
-): ResolvedDingTalkAccount {
+export function resolveDingTalkAccount(cfg: OpenClawConfig, accountId?: string | null): ResolvedDingTalkAccount {
   const id = accountId || DEFAULT_ACCOUNT_ID;
   const dingtalk = cfg.channels?.dingtalk as DingTalkChannelConfig | undefined;
 
   // If default account, return top-level config
   if (id === DEFAULT_ACCOUNT_ID) {
     const config: DingTalkConfig = {
-      clientId: dingtalk?.clientId ?? "",
-      clientSecret: dingtalk?.clientSecret ?? "",
+      clientId: dingtalk?.clientId ?? '',
+      clientSecret: dingtalk?.clientSecret ?? '',
       robotCode: dingtalk?.robotCode,
       corpId: dingtalk?.corpId,
       agentId: dingtalk?.agentId,
@@ -535,8 +556,8 @@ export function resolveDingTalkAccount(
 
   // Account doesn't exist, return empty config
   return {
-    clientId: "",
-    clientSecret: "",
+    clientId: '',
+    clientSecret: '',
     accountId: id,
     configured: false,
   };