@dingtalk-real-ai/dingtalk-connector 0.8.18-beta.1 → 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/index.mjs

@@ -1,4 +1,4 @@
-import { i as dingtalkPlugin, n as setDingtalkRuntime } from "./runtime-CnauOkGt.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) {

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.1",
+  "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.1",
+  "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}`);