@dingtalk-real-ai/dingtalk-connector 0.8.18-beta.0 → 0.8.18

package/CHANGELOG.md

@@ -5,6 +5,22 @@ 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.18] - 2026-04-21
+
+### 修复 / Fixes
+- **AI Card 流式中断残留修复 (#463)** — Gateway 重启后 AI Card 卡在思考中动画、表情标签未撤回；新增 `fixStuckCards` Gateway Method 支持手动修复卡住的 AI Card 和撤回残留表情
+  **AI Card stuck state fix (#463)** — After gateway restart, AI Card stuck in thinking animation and emotion tag not recalled; added `fixStuckCards` Gateway Method for manual recovery
+
+- **多 Agent 配置覆盖保护** — 安装向导检测到已有钉钉 channels + bindings 配置时，跳过自动写入，展示凭证信息让用户自行决定，避免多 Agent 路由配置被意外覆盖
+  **Multi-Agent config overwrite protection** — Install wizard detects existing DingTalk channels + bindings config, skips auto-write and shows credentials for user to decide
+
+### 改进 / Improvements
+- **OpenClaw 版本兼容性** — peerDependency 从 >=2026.3.23 升级到 >=2026.4.9，兼容 OpenClaw 2026.4.15 中的 plugin-sdk 变更
+  **OpenClaw version compatibility** — peerDependency bumped from >=2026.3.23 to >=2026.4.9
+
+- **README 能力展示优化** — 已支持的业务能力（待办、AI 表格、日历日程）整合到主能力表，Coming Soon 区域更新
+  **README capability display** — Supported capabilities consolidated into main table; Coming Soon section updated
+
 ## [0.8.17] - 2026-04-16
 
 ### 新增 / Added

package/bin/dingtalk-connector.js

@@ -15,6 +15,7 @@ import { homedir } from 'node:os';
 const cyan = (s) => `\x1b[36m${s}\x1b[0m`;
 const green = (s) => `\x1b[32m${s}\x1b[0m`;
 const red = (s) => `\x1b[31m${s}\x1b[0m`;
+const orange = (s) => `\x1b[38;5;208m${s}\x1b[0m`;
 const dim = (s) => `\x1b[2m${s}\x1b[0m`;
 const bold = (s) => `\x1b[1m${s}\x1b[0m`;
 
@@ -210,13 +211,11 @@ function saveCredentials(clientId, clientSecret, { isLocal = false, pluginInstal
     // overwriting could break multi-Agent routing. Show credentials and let user decide.
     if (hasExistingMultiAgentConfig(cfg)) {
       console.log('\n' + bold('⚠ 检测到已有钉钉 channels 和 bindings 配置（多 Agent 场景）'));
-      console.log(dim('  直接覆盖可能影响现有的多 Agent 路由配置，已跳过自动写入。') + '\n');
+      console.log(orange('  直接覆盖可能影响现有的多 Agent 路由配置，已跳过自动写入。') + '\n');
       console.log(cyan('  本次选择/创建的机器人信息：'));
-      console.log(green(`    Client ID:     ${clientId}`));
-      console.log(green(`    Client Secret: ${clientSecret}`) + '\n');
-      console.log(dim('  请自行决定是否修改 ~/.openclaw/openclaw.json 中的配置。'));
-      console.log(dim('  如需新增账号，可在 channels.dingtalk-connector.accounts 下添加。') + '\n');
-      return;
+      console.log(`    Client ID:     ${clientId}`);
+      console.log(`    Client Secret: ${clientSecret}` + '\n');
+      return { skippedMultiAgent: true };
     }
 
     // ── channels.[CHANNEL_ID] ──
@@ -542,25 +541,31 @@ Options:
     console.log('\n' + dim('Saving local configuration... (正在进行本地配置...)') + '\n');
 
     // Step 5: Save config
-    saveCredentials(creds.clientId, creds.clientSecret, { isLocal, pluginInstalled });
+    const saveResult = saveCredentials(creds.clientId, creds.clientSecret, { isLocal, pluginInstalled });
 
     // Step 5.1: Inject DWS environment variables for dws CLI integration
     injectDwsEnvVars(creds.clientId, creds.clientSecret);
 
-    console.log(green('✔ Success! Bot configured. (机器人配置成功!)'));
-    console.log(dim(`  Configuration saved to ${getConfigPath()}`) + '\n');
-
-    // Step 6: Post-install guidance
-    if (!pluginInstalled && !isLocal) {
-      console.log(red('⚠ Plugin was not installed.') + ' Credentials saved for later.\n');
-      console.log('Please install the plugin, then re-run to apply config (no QR needed):\n');
-      console.log(cyan('  openclaw plugins install ' + getInstallSpec()));
-      console.log(cyan('  npx -y ' + PKG_NAME + ' install') + '\n');
-    } else {
-      console.log(cyan('Please restart the gateway to apply changes:') + '\n');
+    if (saveResult?.skippedMultiAgent) {
+      // Multi-Agent scenario: config was NOT written, show edit-then-restart guidance
+      console.log(cyan('After editing the config, please restart the gateway to apply changes:') + '\n');
       console.log(cyan('  openclaw gateway restart') + '\n');
-      // Note: the ~3 min warm-up is an OpenClaw gateway behaviour, not plugin-specific.
-      console.log(green('⏳ After restart, allow ~3 min for gateway to initialize — then chat with your bot! (网关初始化约3分钟，完成即可对话)') + '\n');
+    } else {
+      console.log(green('✔ Success! Bot configured. (机器人配置成功!)'));
+      console.log(dim(`  Configuration saved to ${getConfigPath()}`) + '\n');
+
+      // Step 6: Post-install guidance
+      if (!pluginInstalled && !isLocal) {
+        console.log(red('⚠ Plugin was not installed.') + ' Credentials saved for later.\n');
+        console.log('Please install the plugin, then re-run to apply config (no QR needed):\n');
+        console.log(cyan('  openclaw plugins install ' + getInstallSpec()));
+        console.log(cyan('  npx -y ' + PKG_NAME + ' install') + '\n');
+      } else {
+        console.log(cyan('Please restart the gateway to apply changes:') + '\n');
+        console.log(cyan('  openclaw gateway restart') + '\n');
+        // Note: the ~3 min warm-up is an OpenClaw gateway behaviour, not plugin-specific.
+        console.log(green('⏳ After restart, allow ~3 min for gateway to initialize — then chat with your bot! (网关初始化约3分钟，完成即可对话)') + '\n');
+      }
     }
   } catch (err) {
     console.error('\n' + red('❌ Authorization failed: ') + err.message + '\n');

package/dist/{connection-DgBppP0q.mjs → connection-JLte7CFe.mjs}

@@ -236,7 +236,6 @@ async function monitorSingleAccount(opts) {
 				}
 				try {
 					client.socket?.ping();
-					lastSocketAvailableTime = Date.now();
 					logger.debug(`💓 发送 PING 心跳成功`);
 				} catch (err) {
 					logger.warn(`发送 PING 失败：${err.message}`);

package/dist/entry-bundled.d.mts

@@ -1,3 +1,6 @@
+import * as _$openclaw_plugin_sdk_channel_entry_contract0 from "openclaw/plugin-sdk/channel-entry-contract";
+import * as _$openclaw_plugin_sdk0 from "openclaw/plugin-sdk";
+
 //#region entry-bundled.d.ts
 /**
  * Bundled entry for openclaw-fork compatibility.
@@ -8,6 +11,6 @@
  * Usage in package.json exports:
  *   "./bundled" → this file
  */
-declare const _default: any;
+declare const _default: _$openclaw_plugin_sdk_channel_entry_contract0.BundledChannelEntryContract<_$openclaw_plugin_sdk0.ChannelPlugin>;
 //#endregion
 export { _default as default };

package/dist/entry-bundled.mjs

@@ -23,7 +23,7 @@ var entry_bundled_default = defineBundledChannelEntry({
 		exportName: "setDingtalkRuntime"
 	},
 	async registerFull(api) {
-		const { registerGatewayMethods } = await import("./gateway-methods-Csm-xIsh.mjs");
+		const { registerGatewayMethods } = await import("./gateway-methods-DzjIk6X4.mjs");
 		registerGatewayMethods(api);
 	}
 });

package/dist/{gateway-methods-B3AEEDTe.mjs → gateway-methods-CWccImhR.mjs}

@@ -1,8 +1,8 @@
 import { a as resolveDingtalkAccount } from "./accounts-CF4oK_HZ.mjs";
 import { t as dingtalkHttp } from "./http-client-DFWZgO1n.mjs";
 import { r as getAccessToken, t as DINGTALK_API } from "./utils-CIfI_3Jh.mjs";
-import { r as sendProactive } from "./messaging-CN_wQxw1.mjs";
-import { c as getUnionId } from "./utils-legacy-CALCPP1t.mjs";
+import { o as finishAICard, r as sendProactive } from "./messaging-CN_wQxw1.mjs";
+import { c as getUnionId, d as recallEmotionReply } from "./utils-legacy-CALCPP1t.mjs";
 //#region src/docs.ts
 var DingtalkDocsClient = class {
 	config;
@@ -482,6 +482,100 @@ function registerGatewayMethods(api) {
 			respond(false, { error: err.message });
 		}
 	});
+	/**
+	* 修复卡住的 AI Card 和/或残留的🤔表情标签
+	*
+	* 使用场景：Gateway 重启导致流式响应中断，AI Card 停留在"思考中"状态，
+	* 或用户消息上的🤔表情标签未被自动撤回。
+	*
+	* @example 修复卡住的 AI Card
+	* ```typescript
+	* await gateway.call('dingtalk-connector.fixStuckCards', {
+	*   cardInstanceId: 'card_1713600000000_abc12345',
+	*   content: '（回复中断，请重新提问）'
+	* });
+	* ```
+	*
+	* @example 撤回残留的🤔表情
+	* ```typescript
+	* await gateway.call('dingtalk-connector.fixStuckCards', {
+	*   msgId: 'msgXXX',
+	*   conversationId: 'cidXXX'
+	* });
+	* ```
+	*
+	* @example 同时修复两者
+	* ```typescript
+	* await gateway.call('dingtalk-connector.fixStuckCards', {
+	*   cardInstanceId: 'card_1713600000000_abc12345',
+	*   msgId: 'msgXXX',
+	*   conversationId: 'cidXXX'
+	* });
+	* ```
+	*/
+	api.registerGatewayMethod("dingtalk-connector.fixStuckCards", async ({ context, params, respond }) => {
+		const { loadConfig } = await import("openclaw/plugin-sdk/config-runtime");
+		const cfg = loadConfig();
+		try {
+			const { cardInstanceId, content, msgId, conversationId, accountId } = params || {};
+			const account = resolveDingtalkAccount({
+				cfg,
+				accountId
+			});
+			if (!account.config?.clientId) return respond(false, { error: "DingTalk not configured" });
+			if (!cardInstanceId && !msgId) return respond(false, {
+				error: "At least one of cardInstanceId or msgId is required",
+				usage: {
+					cardInstanceId: "(optional) AI Card outTrackId, found in logs like \"outTrackId=card_...\"",
+					content: "(optional) Final card content, defaults to \"（回复中断，请重新提问）\"",
+					msgId: "(optional) Message ID for emotion recall, found in logs like \"msgId=...\"",
+					conversationId: "(optional) Required together with msgId for emotion recall"
+				}
+			});
+			const results = {};
+			if (cardInstanceId) try {
+				const { getAccessToken } = await import("./utils-legacy-CFYDBM4r.mjs");
+				const token = await getAccessToken(account.config);
+				await finishAICard({
+					cardInstanceId: String(cardInstanceId),
+					accessToken: token,
+					tokenExpireTime: Date.now() + 7200 * 1e3,
+					inputingStarted: true
+				}, String(content || "（回复中断，请重新提问）"), account.config, log);
+				results.card = { ok: true };
+				log?.info?.(`[Gateway][fixStuckCards] AI Card 修复成功: ${cardInstanceId}`);
+			} catch (err) {
+				results.card = {
+					ok: false,
+					error: err.message
+				};
+				log?.error?.(`[Gateway][fixStuckCards] AI Card 修复失败: ${err.message}`);
+			}
+			if (msgId && conversationId) try {
+				await recallEmotionReply(account.config, {
+					msgId,
+					conversationId,
+					robotCode: account.config.clientId
+				}, log);
+				results.emotion = { ok: true };
+				log?.info?.(`[Gateway][fixStuckCards] 表情撤回成功: msgId=${msgId}`);
+			} catch (err) {
+				results.emotion = {
+					ok: false,
+					error: err.message
+				};
+				log?.error?.(`[Gateway][fixStuckCards] 表情撤回失败: ${err.message}`);
+			}
+			else if (msgId && !conversationId) results.emotion = {
+				ok: false,
+				error: "conversationId is required together with msgId"
+			};
+			respond(Object.values(results).every((r) => r.ok), results);
+		} catch (err) {
+			log?.error?.(`[Gateway][fixStuckCards] 错误: ${err.message}`);
+			respond(false, { error: err.message });
+		}
+	});
 	api.registerGatewayMethod("dingtalk-connector.probe", async ({ context, respond }) => {
 		const { loadConfig } = await import("openclaw/plugin-sdk/config-runtime");
 		const cfg = loadConfig();

package/dist/gateway-methods-DzjIk6X4.mjs

@@ -0,0 +1,2 @@
+import { t as registerGatewayMethods } from "./gateway-methods-CWccImhR.mjs";
+export { registerGatewayMethods };

package/dist/index.mjs

@@ -1,5 +1,5 @@
-import { i as dingtalkPlugin, n as setDingtalkRuntime } from "./runtime-CnauOkGt.mjs";
-import { t as registerGatewayMethods } from "./gateway-methods-B3AEEDTe.mjs";
+import { i as dingtalkPlugin, n as setDingtalkRuntime } from "./runtime-CAQ2GHj-.mjs";
+import { t as registerGatewayMethods } from "./gateway-methods-CWccImhR.mjs";
 //#region index.ts
 function register(api) {
 	setDingtalkRuntime(api.runtime);

package/dist/{message-handler-C17j--kj.mjs → message-handler-C843X4O6.mjs}

@@ -1,6 +1,6 @@
 import { u as uploadMediaToDingTalk } from "./media-DUMfXnwJ.mjs";
 import { a as resolveDingtalkAccount } from "./accounts-CF4oK_HZ.mjs";
-import { r as CHANNEL_ID, t as getDingtalkRuntime } from "./runtime-CnauOkGt.mjs";
+import { r as CHANNEL_ID, t as getDingtalkRuntime } from "./runtime-CAQ2GHj-.mjs";
 import { n as createLoggerFromConfig } from "./logger-BDWwViGT.mjs";
 import { t as dingtalkHttp } from "./http-client-DFWZgO1n.mjs";
 import { i as getOapiAccessToken } from "./utils-CIfI_3Jh.mjs";

package/dist/{runtime-CnauOkGt.mjs → runtime-CAQ2GHj-.mjs}

@@ -890,8 +890,8 @@ async function monitorDingtalkProvider(opts = {}) {
 	const log = createLogger(cfg.channels?.["dingtalk-connector"]?.debug ?? false);
 	const [accountsModule, monitorAccountModule, monitorSingleModule] = await Promise.all([
 		import("./accounts-BSIiLyZa.mjs"),
-		import("./message-handler-C17j--kj.mjs"),
-		import("./connection-DgBppP0q.mjs")
+		import("./message-handler-C843X4O6.mjs"),
+		import("./connection-JLte7CFe.mjs")
 	]);
 	const { resolveDingtalkAccount, listEnabledDingtalkAccounts } = accountsModule;
 	const { handleDingTalkMessage } = monitorAccountModule;

package/docs/RELEASE_NOTES_V0.8.18.md

@@ -0,0 +1,64 @@
+# Release Notes - v0.8.18
+
+## 🎉 新版本亮点 / Highlights
+
+本次版本聚焦 **流式中断故障恢复** 和 **多 Agent 安装保护**。新增 `fixStuckCards` Gateway Method 解决 Gateway 重启后 AI Card 卡住和表情残留问题；安装向导增加多 Agent 配置检测，防止已有路由配置被意外覆盖。
+
+This release focuses on **streaming interruption recovery** and **multi-Agent install protection**. Added `fixStuckCards` Gateway Method to fix stuck AI Cards and lingering emotion tags after gateway restart; install wizard now detects existing multi-Agent config to prevent accidental overwrite.
+
+## 🐛 修复 / Fixes
+
+- **AI Card 流式中断残留修复 (#463) / AI Card stuck state fix**
+  Gateway 重启导致流式响应中断时，AI Card 停留在"思考中"动画、用户消息上的🤔表情标签未自动撤回。新增 `dingtalk-connector.fixStuckCards` Gateway Method，支持手动修复卡住的 AI Card 和/或撤回残留表情。
+  When streaming is interrupted by gateway restart, AI Card stays in "thinking" animation and 🤔 emotion tag is not auto-recalled. Added `dingtalk-connector.fixStuckCards` Gateway Method for manual recovery.
+
+  ```typescript
+  // 修复卡住的 AI Card
+  await gateway.call('dingtalk-connector.fixStuckCards', {
+    cardInstanceId: 'card_1713600000000_abc12345',
+    content: '（回复中断，请重新提问）'
+  });
+
+  // 撤回残留的🤔表情
+  await gateway.call('dingtalk-connector.fixStuckCards', {
+    msgId: 'msgXXX',
+    conversationId: 'cidXXX'
+  });
+  ```
+
+- **多 Agent 配置覆盖保护 / Multi-Agent config overwrite protection**
+  安装向导检测到 `openclaw.json` 中已有钉钉 channels + bindings 配置（多 Agent 场景）时，**跳过自动写入**，展示本次选择的机器人凭证信息，让用户自行决定是否修改配置。避免多 Agent 路由被意外覆盖。
+  Install wizard detects existing DingTalk channels + bindings config (multi-Agent scenario), skips auto-write, and displays credentials for user to decide. Prevents accidental multi-Agent routing breakage.
+
+## ✅ 改进 / Improvements
+
+- **OpenClaw 版本兼容性 / OpenClaw version compatibility**
+  `peerDependency` 从 `>=2026.3.23` 升级到 `>=2026.4.9`，兼容 OpenClaw 2026.4.15 中的 plugin-sdk 变更。
+  `peerDependency` bumped from `>=2026.3.23` to `>=2026.4.9`, compatible with OpenClaw 2026.4.15 plugin-sdk changes.
+
+- **README 能力展示优化 / README capability display**
+  已支持的业务能力（待办任务、AI 表格、日历日程）从独立区块整合到主能力表格，Coming Soon 区域同步更新。
+  Supported business capabilities (Todo, AI Table, Calendar) consolidated into main capability table; Coming Soon section updated.
+
+## 📥 安装升级 / Installation & Upgrade
+
+```bash
+npx openclaw@latest add @dingtalk-real-ai/dingtalk-connector
+```
+
+或指定版本：
+```bash
+npx openclaw@latest add @dingtalk-real-ai/dingtalk-connector@0.8.18
+```
+
+## 🔗 相关链接 / Related Links
+
+- [完整变更日志 / Full Changelog](https://github.com/DingTalk-Real-AI/dingtalk-openclaw-connector/blob/main/CHANGELOG.md)
+- [使用文档 / Documentation](https://github.com/DingTalk-Real-AI/dingtalk-openclaw-connector/blob/main/README.md)
+- [故障排查 / Troubleshooting](https://github.com/DingTalk-Real-AI/dingtalk-openclaw-connector/blob/main/docs/TROUBLESHOOTING.md)
+
+---
+
+**发布日期 / Release Date**：2026-04-21
+**版本号 / Version**：v0.8.18
+**兼容性 / Compatibility**：OpenClaw Gateway 2026.4.9+

package/openclaw.plugin.json

@@ -1,7 +1,7 @@
 {
   "id": "dingtalk-connector",
   "name": "DingTalk Channel",
-  "version": "0.8.18-beta.0",
+  "version": "0.8.18",
   "description": "Official OpenClaw DingTalk channel plugin | 钉钉官方 OpenClaw 插件",
   "author": "DingTalk Real Team",
   "main": "index.ts",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dingtalk-real-ai/dingtalk-connector",
-  "version": "0.8.18-beta.0",
+  "version": "0.8.18",
   "description": "Official OpenClaw DingTalk channel plugin | 钉钉官方 OpenClaw 插件",
   "type": "module",
   "exports": {

package/src/core/connection.ts

@@ -403,10 +403,10 @@ export async function monitorSingleAccount(
           return;
         }
 
-        // 【发送原生 Ping】更新可用时间
+        // 【发送原生 Ping】仅发送，不刷新时间戳；
+        // 只有收到 pong 响应时才更新 lastSocketAvailableTime（见 setupPongListener）
         try {
           client.socket?.ping();
-          lastSocketAvailableTime = Date.now();
           logger.debug(`💓 发送 PING 心跳成功`);
         } catch (err: any) {
           logger.warn(`发送 PING 失败：${err.message}`);

package/src/gateway-methods.ts

@@ -8,7 +8,9 @@ import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
 import { resolveDingtalkAccount } from "./config/accounts.ts";
 import { DingtalkDocsClient } from "./docs.ts";
 import { sendProactive } from "./services/messaging.ts";
-import { getUnionId } from "./utils/utils-legacy.ts";
+import { getUnionId, recallEmotionReply } from "./utils/utils-legacy.ts";
+import { finishAICard } from "./services/messaging/card.ts";
+import type { AICardInstance } from "./services/messaging/card.ts";
 
 /**
  * 注册所有 Gateway Methods
@@ -380,6 +382,111 @@ export function registerGatewayMethods(api: OpenClawPluginApi) {
     }
   });
 
+  // ============ 故障恢复类 ============
+
+  /**
+   * 修复卡住的 AI Card 和/或残留的🤔表情标签
+   *
+   * 使用场景：Gateway 重启导致流式响应中断，AI Card 停留在"思考中"状态，
+   * 或用户消息上的🤔表情标签未被自动撤回。
+   *
+   * @example 修复卡住的 AI Card
+   * ```typescript
+   * await gateway.call('dingtalk-connector.fixStuckCards', {
+   *   cardInstanceId: 'card_1713600000000_abc12345',
+   *   content: '（回复中断，请重新提问）'
+   * });
+   * ```
+   *
+   * @example 撤回残留的🤔表情
+   * ```typescript
+   * await gateway.call('dingtalk-connector.fixStuckCards', {
+   *   msgId: 'msgXXX',
+   *   conversationId: 'cidXXX'
+   * });
+   * ```
+   *
+   * @example 同时修复两者
+   * ```typescript
+   * await gateway.call('dingtalk-connector.fixStuckCards', {
+   *   cardInstanceId: 'card_1713600000000_abc12345',
+   *   msgId: 'msgXXX',
+   *   conversationId: 'cidXXX'
+   * });
+   * ```
+   */
+  api.registerGatewayMethod('dingtalk-connector.fixStuckCards', async ({ context, params, respond }) => {
+    const { loadConfig } = await import('openclaw/plugin-sdk/config-runtime');
+    const cfg = loadConfig();
+    try {
+      const { cardInstanceId, content, msgId, conversationId, accountId } = (params || {}) as any;
+      const account = resolveDingtalkAccount({ cfg, accountId: accountId as string | undefined });
+
+      if (!account.config?.clientId) {
+        return respond(false, { error: 'DingTalk not configured' });
+      }
+
+      if (!cardInstanceId && !msgId) {
+        return respond(false, {
+          error: 'At least one of cardInstanceId or msgId is required',
+          usage: {
+            cardInstanceId: '(optional) AI Card outTrackId, found in logs like "outTrackId=card_..."',
+            content: '(optional) Final card content, defaults to "（回复中断，请重新提问）"',
+            msgId: '(optional) Message ID for emotion recall, found in logs like "msgId=..."',
+            conversationId: '(optional) Required together with msgId for emotion recall',
+          },
+        });
+      }
+
+      const results: { card?: { ok: boolean; error?: string }; emotion?: { ok: boolean; error?: string } } = {};
+
+      // 1. 修复卡住的 AI Card
+      if (cardInstanceId) {
+        try {
+          const { getAccessToken } = await import('./utils/utils-legacy.ts');
+          const token = await getAccessToken(account.config);
+          const card: AICardInstance = {
+            cardInstanceId: String(cardInstanceId),
+            accessToken: token,
+            tokenExpireTime: Date.now() + 2 * 60 * 60 * 1000,
+            inputingStarted: true,
+          };
+          const finalContent = String(content || '（回复中断，请重新提问）');
+          await finishAICard(card, finalContent, account.config, log);
+          results.card = { ok: true };
+          log?.info?.(`[Gateway][fixStuckCards] AI Card 修复成功: ${cardInstanceId}`);
+        } catch (err: any) {
+          results.card = { ok: false, error: err.message };
+          log?.error?.(`[Gateway][fixStuckCards] AI Card 修复失败: ${err.message}`);
+        }
+      }
+
+      // 2. 撤回残留的🤔表情
+      if (msgId && conversationId) {
+        try {
+          await recallEmotionReply(account.config, {
+            msgId,
+            conversationId,
+            robotCode: account.config.clientId,
+          }, log);
+          results.emotion = { ok: true };
+          log?.info?.(`[Gateway][fixStuckCards] 表情撤回成功: msgId=${msgId}`);
+        } catch (err: any) {
+          results.emotion = { ok: false, error: err.message };
+          log?.error?.(`[Gateway][fixStuckCards] 表情撤回失败: ${err.message}`);
+        }
+      } else if (msgId && !conversationId) {
+        results.emotion = { ok: false, error: 'conversationId is required together with msgId' };
+      }
+
+      const allOk = Object.values(results).every(r => r.ok);
+      respond(allOk, results);
+    } catch (err: any) {
+      log?.error?.(`[Gateway][fixStuckCards] 错误: ${err.message}`);
+      respond(false, { error: err.message });
+    }
+  });
+
   api.registerGatewayMethod('dingtalk-connector.probe', async ({ context, respond }) => {
     const { loadConfig } = await import('openclaw/plugin-sdk/config-runtime');
     const cfg = loadConfig();

package/dist/gateway-methods-Csm-xIsh.mjs

@@ -1,2 +0,0 @@
-import { t as registerGatewayMethods } from "./gateway-methods-B3AEEDTe.mjs";
-export { registerGatewayMethods };