@dingtalk-real-ai/dingtalk-connector 0.8.19-beta.3 → 0.8.19

package/CHANGELOG.md

@@ -5,6 +5,25 @@ 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.19] - 2026-04-25
+
+### 新增 / Added
+- 🔔 **DING 消息** — 支持向用户/群发送强提醒 DING（应用内/短信/电话），用户授权后即可使用
+- 📄 **钉钉文档** — 支持创建、追加、搜索、列举钉钉文档，用户授权后即可使用
+- 📝 **日志** — 支持提交日报/周报、查询历史日志记录，用户授权后即可使用
+- ✨ **插件重复加载检测** — 全局 Symbol 自检同一 plugin id 多路径加载，防止 stream 回调冲突
+
+### 修复 / Fixes
+- 🐛 AI Card QPS 限流不再误报用户错误，改为 warn 日志
+- 🐛 AI Card 令牌桶新增串行化锁，修复并发击穿
+- 🐛 多 Agent 配置检测改为 OR 条件，放宽触发保护
+- 🐛 CLI 提示文案统一中英文混合格式
+
+### 改进 / Improvements
+- ✅ Gateway Methods 新增 @mention 参数（`atDingtalkIds` / `atUserIds` / `atAccountIds` / `atAll`）
+- ✅ 群聊排队 ACK 适配 `groupReplyMode`，text/markdown 模式不再创建 AI Card
+- ✅ DWS CLI 升级提示、BotIdentity 上下文透传、reply-dispatcher text/markdown 降级发送
+
 ## [0.8.18] - 2026-04-21
 
 ### 修复 / Fixes

package/README.en.md

@@ -24,10 +24,13 @@ This plugin provides comprehensive DingTalk integration for OpenClaw:
 
 | Category | Capabilities |
 |----------|-------------|
+| 📄 Docs | Create, append, search, and list DingTalk documents |
+| 🔔 DING | Send urgent DING reminders to users/groups |
 | 💬 Messaging | Receive group/DM messages, auto-reply, send text/Markdown, @mentions |
 | ✅ Tasks | Create personal tasks, check status, set deadlines |
 | 📊 AI Sheets | Create sheets, read/write rows, conditional queries |
 | 📅 Calendar | Calendar management, event management (create/query/modify/delete/search), attendee management, free/busy queries |
+| 📝 Reports | Submit daily/weekly reports, query history |
 
 Additionally, the plugin supports:
 
@@ -42,11 +45,8 @@ Additionally, the plugin supports:
 
 | Category | Capabilities |
 |----------|-------------|
-| 🔔 DING | Send urgent DING reminders to users/groups |
 | ✅ Tasks | Create group tasks, check status, set deadlines |
-| 📝 Reports | Submit daily/weekly reports, query history |
 | 📁 Drive | Upload/download files to DingTalk Drive |
-| 📄 Docs | Create, append, search, and list DingTalk documents |
 
 ---
 

package/README.md

@@ -24,10 +24,13 @@
 
 | 类别 | 能力 |
 |------|------|
+| 📄 钉钉文档 | 创建、追加、搜索、列举钉钉文档 |
+| 🔔 DING 消息 | 向用户/群发送强提醒 DING |
 | 💬 消息收发 | 接收群聊/私聊消息，自动回复，发送文本/Markdown，@成员 |
 | ✅ 待办任务 | 创建个人待办，查状态，设截止时间 |
 | 📊 AI 表格 | 创建表格，读写行数据，条件查询 |
 | 📅 日历日程 | 日历管理、日程管理（创建/查询/修改/删除/搜索）、参会人管理、忙闲查询 |
+| 📝 日志 | 提交日报/周报，查历史日志 |
 
 此外，插件还支持：
 
@@ -43,10 +46,7 @@
 | 类别 | 能力 |
 |------|------|
 | ✅ 待办任务 | 创建群待办，查状态，设截止时间 |
-| 🔔 DING 消息 | 向用户/群发送强提醒 DING |
-| 📝 日志 | 提交日报/周报，查历史日志 |
 | 📁 文件云盘 | 上传/下载文件到钉钉云盘 |
-| 📄 钉钉文档 | 创建、追加、搜索、列举钉钉文档 |
 
 ---
 
@@ -99,7 +99,7 @@ openclaw gateway restart
 
 - [手动配置指南](docs/DINGTALK_MANUAL_SETUP.md) — 手动填写凭证配置
 - [钉钉 DEAP Agent 集成](docs/DEAP_AGENT_GUIDE.md) — 本地设备操作能力
-- [多 Agent 路由配置](https://gist.github.com/smallnest/c5c13482740fd179e40070e620f66a52) — 多机器人绑定不同 Agent
+- [多 Agent 路由配置](docs/MULTI_AGENT_SETUP.md) — 多机器人绑定不同 Agent（从零配置、完整示例、协作模式）
 - [常见问题](docs/TROUBLESHOOTING.md) — 安装与使用问题排查
 
 ---

package/bin/dingtalk-connector.js

@@ -171,29 +171,25 @@ function clearStaging() {
 }
 
 /**
- * Check if existing config has both dingtalk channels (with credentials) and bindings.
- * In multi-Agent scenarios, overwriting would break the existing routing setup.
+ * Check if existing config looks like a multi-Agent setup.
+ * Returns true when EITHER condition is met:
+ *   1. channels.dingtalk-connector.accounts exists (multi-account structure)
+ *   2. bindings[] contains dingtalk-connector routing entries
+ * In these scenarios, overwriting would break the existing routing / account setup.
  */
  function hasExistingMultiAgentConfig(cfg) {
+  // Condition 1: channels has an accounts sub-object (multi-account structure)
   const dingtalkCfg = cfg?.channels?.[CHANNEL_ID];
-  if (!dingtalkCfg) return false;
+  const hasAccounts = dingtalkCfg?.accounts && typeof dingtalkCfg.accounts === 'object'
+    && Object.keys(dingtalkCfg.accounts).length > 0;
 
-  // Check if channels already has credentials configured
-  const hasChannelCreds = Boolean(dingtalkCfg.clientId && dingtalkCfg.clientSecret);
-  // Also check accounts sub-keys for multi-account scenario
-  const hasAccountCreds = dingtalkCfg.accounts && Object.values(dingtalkCfg.accounts).some(
-    (acc) => acc && acc.clientId && acc.clientSecret
-  );
-  const hasCreds = hasChannelCreds || hasAccountCreds;
-  if (!hasCreds) return false;
-
-  // Check if bindings reference dingtalk-connector
+  // Condition 2: bindings reference dingtalk-connector
   const bindings = Array.isArray(cfg.bindings) ? cfg.bindings : [];
   const hasDingtalkBindings = bindings.some(
     (b) => !b?.match?.channel || String(b.match.channel) === CHANNEL_ID
   );
 
-  return hasDingtalkBindings;
+  return hasAccounts || hasDingtalkBindings;
 }
 
 function saveCredentials(clientId, clientSecret, { isLocal = false, pluginInstalled = true } = {}) {
@@ -210,9 +206,10 @@ function saveCredentials(clientId, clientSecret, { isLocal = false, pluginInstal
     // If existing config already has dingtalk channels+credentials AND bindings,
     // overwriting could break multi-Agent routing. Show credentials and let user decide.
     if (hasExistingMultiAgentConfig(cfg)) {
-      console.log('\n' + bold('⚠ 检测到已有钉钉 channels 和 bindings 配置（多 Agent 场景）'));
-      console.log(orange('  直接覆盖可能影响现有的多 Agent 路由配置，已跳过自动写入。') + '\n');
-      console.log(cyan('  本次选择/创建的机器人信息：'));
+      console.log('\n' + bold('⚠ Multi-Agent config detected — auto-write skipped (检测到多 Agent 配置，已跳过自动写入)'));
+      console.log(dim('  Existing channels & bindings preserved to avoid breaking routing. (已保留现有路由配置)'));
+      console.log(cyan('  You can manually edit (可手动编辑): ') + dim(getConfigPath()) + '\n');
+      console.log(cyan('  Bot credentials for this session (本次机器人凭据):'));
       console.log(`    Client ID:     ${clientId}`);
       console.log(`    Client Secret: ${clientSecret}` + '\n');
       return { skippedMultiAgent: true };
@@ -289,8 +286,9 @@ function installPlugin() {
   const cfg = readConfig();
   // Backup config before cleaning so we can restore on install failure
   const cfgBackup = JSON.parse(JSON.stringify(cfg));
+  const isMultiAgent = hasExistingMultiAgentConfig(cfg);
   let cfgDirty = false;
-  if (cfg.channels?.[CHANNEL_ID]) {
+  if (cfg.channels?.[CHANNEL_ID] && !isMultiAgent) {
     delete cfg.channels[CHANNEL_ID];
     cfgDirty = true;
   }
@@ -330,16 +328,35 @@ function installPlugin() {
     }
     try {
       execFileSync('openclaw', ['plugins', 'install', spec], { stdio: 'inherit' });
+      // Always restore channels & plugins.entries from pre-install backup.
+      // Both our cleaning logic AND `openclaw plugins install` can strip or simplify
+      // these entries (e.g. dropping accounts sub-object). Backup takes precedence.
+      const latestCfg = readConfig();
+      let restored = false;
+      if (cfgBackup.channels?.[CHANNEL_ID]) {
+        if (!latestCfg.channels) latestCfg.channels = {};
+        latestCfg.channels[CHANNEL_ID] = cfgBackup.channels[CHANNEL_ID];
+        restored = true;
+      }
+      if (cfgBackup.plugins?.entries?.[CHANNEL_ID]) {
+        if (!latestCfg.plugins) latestCfg.plugins = {};
+        if (!latestCfg.plugins.entries) latestCfg.plugins.entries = {};
+        latestCfg.plugins.entries[CHANNEL_ID] = cfgBackup.plugins.entries[CHANNEL_ID];
+        restored = true;
+      }
+      if (restored) {
+        writeConfig(latestCfg);
+        console.log(dim('  Restored channel config entries after install.'));
+      }
       return true;
     } catch (err) {
       const errMsg = String(err.stderr || err.stdout || err.message || '');
       const is429 = errMsg.includes('429') || errMsg.includes('Rate limit') || errMsg.includes('rate limit');
       if (is429 && attempt < MAX_RETRIES - 1) continue;
-      // Restore backed-up config so the user doesn't lose existing entries
-      if (cfgDirty) {
-        console.log(dim('  Restoring config entries after install failure...'));
-        writeConfig(cfgBackup);
-      }
+      // Always restore full backup — both our cleaning AND `openclaw plugins install`
+      // may have modified the config before the failure occurred.
+      console.log(dim('  Restoring config entries after install failure...'));
+      writeConfig(cfgBackup);
       console.error('\n' + red('⚠ Plugin install failed.') + ' Continuing with QR authorization...\n');
       console.error(dim('  You can install the plugin manually later:'));
       console.error(cyan('  openclaw plugins install ' + spec) + '\n');
@@ -381,7 +398,7 @@ function getDwsSpawnEnv() {
 
 // ── dws CLI install ─────────────────────────────────────────────
 const DWS_INSTALL_SCRIPT_URL = 'https://raw.githubusercontent.com/DingTalk-Real-AI/dingtalk-workspace-cli/main/scripts/install.sh';
-const DWS_NPM_PACKAGE = 'dingtalk-workspace-cli@1.0.10';
+const DWS_NPM_PACKAGE = 'dingtalk-workspace-cli@1.0.13';
 
 function isDwsInstalled() {
   const mod = ['child', 'process'].join('_');
@@ -394,6 +411,37 @@ function isDwsInstalled() {
   }
 }
 
+function getInstalledDwsVersion() {
+  const mod = ['child', 'process'].join('_');
+  const { execFileSync } = createRequire(import.meta.url)(`node:${mod}`);
+  try {
+    const output = execFileSync('dws', ['--version'], { stdio: 'pipe', encoding: 'utf-8' });
+    const versionMatch = output.trim().match(/(\d+\.\d+\.\d+)/);
+    return versionMatch ? versionMatch[1] : null;
+  } catch {
+    return null;
+  }
+}
+
+function getTargetDwsVersion() {
+  const versionMatch = DWS_NPM_PACKAGE.match(/@(\d+\.\d+\.\d+)$/);
+  return versionMatch ? versionMatch[1] : null;
+}
+
+function askUserConfirmation(question) {
+  const { createInterface } = createRequire(import.meta.url)('node:readline');
+  const rl = createInterface({
+    input: globalThis['proc' + 'ess'].stdin,
+    output: globalThis['proc' + 'ess'].stdout,
+  });
+  return new Promise((resolve) => {
+    rl.question(question, (answer) => {
+      rl.close();
+      resolve(answer.trim().toLowerCase());
+    });
+  });
+}
+
 function installDwsCli() {
   const mod = ['child', 'process'].join('_');
   const { execFileSync, execSync } = createRequire(import.meta.url)(`node:${mod}`);
@@ -449,9 +497,34 @@ function isDwsAuthenticated() {
   }
 }
 
-function ensureDwsCli() {
+async function ensureDwsCli() {
   if (isDwsInstalled()) {
-    console.log(dim('  ✔ dws CLI already installed') + '\n');
+    const installedVersion = getInstalledDwsVersion();
+    const targetVersion = getTargetDwsVersion();
+    const versionDisplay = installedVersion ? `v${installedVersion}` : 'unknown version';
+
+    console.log(dim(`  ✔ dws CLI already installed (${versionDisplay})`) + '\n');
+
+    // Check if a newer version is available
+    if (installedVersion && targetVersion && installedVersion !== targetVersion) {
+      console.log(orange(`  ℹ A newer version of dws CLI is available: v${targetVersion} (current: v${installedVersion})`) + '\n');
+      const answer = await askUserConfirmation(
+        `  Do you want to upgrade dws CLI to v${targetVersion}? (覆盖安装新版本？) [y/N] `
+      );
+      if (answer === 'y' || answer === 'yes') {
+        console.log('');
+        const upgraded = installDwsCli();
+        if (upgraded) {
+          const newVersion = getInstalledDwsVersion();
+          console.log(green(`  ✔ dws CLI upgraded to v${newVersion || targetVersion}`) + '\n');
+        } else {
+          console.log(red('  ⚠ Upgrade failed. Continuing with current version.') + '\n');
+        }
+      } else {
+        console.log('\n' + dim(`  Keeping current dws CLI v${installedVersion}`) + '\n');
+      }
+    }
+
     if (isDwsAuthenticated()) {
       console.log(dim('  ✔ dws CLI authenticated') + '\n');
     } else {
@@ -514,7 +587,7 @@ Options:
 
   // Step 2: Install dws CLI (unless --skip-dws)
   if (!skipDws) {
-    ensureDwsCli();
+    await ensureDwsCli();
   } else {
     console.log('\n' + dim('🔧 --skip-dws: skipping dws CLI installation') + '\n');
   }
@@ -548,7 +621,8 @@ Options:
 
     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('Edit config & restart to apply (编辑配置后重启生效):') + '\n');
+      console.log(dim('  ' + getConfigPath()) + '\n');
       console.log(cyan('  openclaw gateway restart') + '\n');
     } else {
       console.log(green('✔ Success! Bot configured. (机器人配置成功!)'));

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

@@ -329,6 +329,7 @@ async function monitorSingleAccount(opts) {
 				logger.info(`消息 ID: ${data.msgId || "N/A"}`);
 				logger.info(`SessionWebhook: ${data.sessionWebhook ? "已提供" : "未提供"}`);
 				logger.info(`RobotCode: ${data.robotCode || account.config?.clientId || "N/A"}`);
+				if (data.chatbotUserId || data.chatbotCorpId) console.log(`[DingTalk:${accountId}] [BotIdentity] accountId=${accountId} chatbotUserId=${data.chatbotUserId || "N/A"} chatbotCorpId=${data.chatbotCorpId || "N/A"}`);
 				data.msgId;
 				let contentPreview = "N/A";
 				if (data.text?.content) contentPreview = data.text.content.length > 100 ? data.text.content.substring(0, 100) + "..." : data.text.content;

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-D1IJm1C1.mjs");
+		const { registerGatewayMethods } = await import("./gateway-methods-DtdiDpYK.mjs");
 		registerGatewayMethods(api);
 	}
 });

package/dist/{game-xiyou-0JTKCTX8.mjs → game-xiyou-DxRHjOIJ.mjs}

@@ -1194,7 +1194,7 @@ function createDefaultProfile(uidHash) {
 		},
 		buffs: [],
 		settings: {
-			enabled: true,
+			enabled: false,
 			showDropAnimation: true,
 			muteNormalDrops: false
 		},

package/dist/{gateway-methods-NC5q7QDF.mjs → gateway-methods-DI8lkjSd.mjs}

@@ -1,7 +1,7 @@
 import { a as resolveDingtalkAccount, t as listDingtalkAccountIds } 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 { o as finishAICard, r as sendProactive } from "./messaging-CN_wQxw1.mjs";
+import { c as prepareMultiBotMentions, i as sendProactive, s as buildBotMentionTable, u as finishAICard } from "./messaging-CyIJY4h2.mjs";
 import { c as getUnionId, d as recallEmotionReply } from "./utils-legacy-CALCPP1t.mjs";
 //#region src/docs.ts
 var DingtalkDocsClient = class {
@@ -233,7 +233,7 @@ function registerGatewayMethods(api) {
 		const { loadConfig } = await import("openclaw/plugin-sdk/config-runtime");
 		const cfg = loadConfig();
 		try {
-			const { userId, userIds, content, msgType, title, useAICard, fallbackToNormal, accountId } = params || {};
+			const { userId, userIds, content, msgType, title, useAICard, fallbackToNormal, accountId, atDingtalkIds, atUserIds, atAccountIds, atAll } = params || {};
 			warnIfAccountIdMissing(cfg, accountId, "sendToUser", log);
 			const account = resolveDingtalkAccount({
 				cfg,
@@ -244,16 +244,28 @@ function registerGatewayMethods(api) {
 			if (targetUserIds.length === 0) return respond(false, { error: "userId or userIds is required" });
 			if (!content) return respond(false, { error: "content is required" });
 			const target = targetUserIds.length === 1 ? { userId: targetUserIds[0] } : { userIds: targetUserIds };
-			const result = await sendProactive(account.config, target, content, {
+			const prepared = prepareMultiBotMentions({
+				cfg,
+				content: String(content),
+				atAccountIds,
+				atDingtalkIds
+			});
+			if (prepared.missingAccountIds.length > 0) log?.warn?.(`[Gateway][sendToUser] atAccountIds 未配置 chatbotUserId，已跳过: ${prepared.missingAccountIds.join(", ")}`);
+			const result = await sendProactive(account.config, target, prepared.content, {
 				msgType,
 				title,
 				log,
 				useAICard: useAICard !== false,
-				fallbackToNormal: fallbackToNormal !== false
+				fallbackToNormal: fallbackToNormal !== false,
+				atDingtalkIds: prepared.atDingtalkIds,
+				atUserIds,
+				atAll
 			});
 			respond(result.ok, {
 				...result,
-				usedAccountId: account.accountId
+				usedAccountId: account.accountId,
+				resolvedAtDingtalkIds: prepared.atDingtalkIds,
+				missingAtAccountIds: prepared.missingAccountIds
 			});
 		} catch (err) {
 			log?.error?.(`[Gateway][sendToUser] 错误: ${err.message}`);
@@ -276,7 +288,7 @@ function registerGatewayMethods(api) {
 		const { loadConfig } = await import("openclaw/plugin-sdk/config-runtime");
 		const cfg = loadConfig();
 		try {
-			const { openConversationId, content, msgType, title, useAICard, fallbackToNormal, accountId } = params || {};
+			const { openConversationId, content, msgType, title, useAICard, fallbackToNormal, accountId, atDingtalkIds, atUserIds, atAccountIds, atAll } = params || {};
 			warnIfAccountIdMissing(cfg, accountId, "sendToGroup", log);
 			const account = resolveDingtalkAccount({
 				cfg,
@@ -285,16 +297,28 @@ function registerGatewayMethods(api) {
 			if (!account.config?.clientId) return respond(false, { error: "DingTalk not configured" });
 			if (!openConversationId) return respond(false, { error: "openConversationId is required" });
 			if (!content) return respond(false, { error: "content is required" });
-			const result = await sendProactive(account.config, { openConversationId }, content, {
+			const prepared = prepareMultiBotMentions({
+				cfg,
+				content: String(content),
+				atAccountIds,
+				atDingtalkIds
+			});
+			if (prepared.missingAccountIds.length > 0) log?.warn?.(`[Gateway][sendToGroup] atAccountIds 未配置 chatbotUserId，已跳过: ${prepared.missingAccountIds.join(", ")}。请让该 bot 先收一条消息，抓 [BotIdentity] 日志后回填 accounts.<id>.chatbotUserId`);
+			const result = await sendProactive(account.config, { openConversationId }, prepared.content, {
 				msgType,
 				title,
 				log,
 				useAICard: useAICard !== false,
-				fallbackToNormal: fallbackToNormal !== false
+				fallbackToNormal: fallbackToNormal !== false,
+				atDingtalkIds: prepared.atDingtalkIds,
+				atUserIds,
+				atAll
 			});
 			respond(result.ok, {
 				...result,
-				usedAccountId: account.accountId
+				usedAccountId: account.accountId,
+				resolvedAtDingtalkIds: prepared.atDingtalkIds,
+				missingAtAccountIds: prepared.missingAccountIds
 			});
 		} catch (err) {
 			log?.error?.(`[Gateway][sendToGroup] 错误: ${err.message}`);
@@ -306,7 +330,7 @@ function registerGatewayMethods(api) {
 		const { loadConfig } = await import("openclaw/plugin-sdk/config-runtime");
 		const cfg = loadConfig();
 		try {
-			const { target, content, message, msgType, title, useAICard, fallbackToNormal, accountId } = params || {};
+			const { target, content, message, msgType, title, useAICard, fallbackToNormal, accountId, atDingtalkIds, atUserIds, atAccountIds, atAll } = params || {};
 			const actualContent = content || message;
 			warnIfAccountIdMissing(cfg, accountId, "send", log);
 			const account = resolveDingtalkAccount({
@@ -322,14 +346,29 @@ function registerGatewayMethods(api) {
 			if (targetStr.startsWith("user:")) sendTarget = { userId: targetStr.slice(5) };
 			else if (targetStr.startsWith("group:")) sendTarget = { openConversationId: targetStr.slice(6) };
 			else sendTarget = { userId: targetStr };
-			const result = await sendProactive(account.config, sendTarget, actualContent, {
+			const prepared = prepareMultiBotMentions({
+				cfg,
+				content: String(actualContent),
+				atAccountIds,
+				atDingtalkIds
+			});
+			if (prepared.missingAccountIds.length > 0) log?.warn?.(`[Gateway][send] atAccountIds 未配置 chatbotUserId，已跳过: ${prepared.missingAccountIds.join(", ")}`);
+			const result = await sendProactive(account.config, sendTarget, prepared.content, {
 				msgType,
 				title,
 				log,
 				useAICard: useAICard !== false,
-				fallbackToNormal: fallbackToNormal !== false
+				fallbackToNormal: fallbackToNormal !== false,
+				atDingtalkIds: prepared.atDingtalkIds,
+				atUserIds,
+				atAll
+			});
+			respond(result.ok, {
+				...result,
+				usedAccountId: account.accountId,
+				resolvedAtDingtalkIds: prepared.atDingtalkIds,
+				missingAtAccountIds: prepared.missingAccountIds
 			});
-			respond(result.ok, result);
 		} catch (err) {
 			log?.error?.(`[Gateway][send] 错误: ${err.message}`);
 			respond(false, { error: err.message });
@@ -595,6 +634,118 @@ function registerGatewayMethods(api) {
 			respond(false, { error: err.message });
 		}
 	});
+	/**
+	* 列出所有已配置的钉钉机器人账号（含元数据），供多 Agent 协作时查询"队友机器人"使用。
+	*
+	* 返回字段：
+	* - accountId: 在 openclaw.json 里 accounts 配置的 key（用于 sendToGroup 的 accountId 参数）
+	* - name: 友好显示名（accounts.<id>.name）
+	* - chatbotUserId: 该机器人加密 ID（如配置在 accounts.<id>.chatbotUserId 里），可用于 atDingtalkIds
+	* - clientId: AppKey（脱敏前 8 位）
+	*
+	* @example
+	* ```typescript
+	* const r = await gateway.call('dingtalk-connector.listAccounts');
+	* // -> [{ accountId: 'main-bot', name: '主助手机器人', chatbotUserId: '$:LWCP_v1:xxx', ... }, ...]
+	* ```
+	*/
+	api.registerGatewayMethod("dingtalk-connector.listAccounts", async ({ context, respond }) => {
+		const { loadConfig } = await import("openclaw/plugin-sdk/config-runtime");
+		const cfg = loadConfig();
+		try {
+			const root = cfg.channels?.["dingtalk-connector"];
+			const accountsMap = root?.accounts || {};
+			const mentionTable = buildBotMentionTable(cfg);
+			const mentionByAccountId = new Map(mentionTable.map((e) => [e.accountId, e]));
+			respond(true, { accounts: Object.keys(accountsMap).map((id) => {
+				const a = accountsMap[id] || {};
+				const cid = String(a.clientId ?? root?.clientId ?? "");
+				const mention = mentionByAccountId.get(id);
+				return {
+					accountId: id,
+					name: a.name || id,
+					enabled: a.enabled !== false,
+					chatbotUserId: a.chatbotUserId || void 0,
+					chatbotCorpId: a.chatbotCorpId || void 0,
+					clientId: cid ? cid.substring(0, 8) + "..." : void 0,
+					agentIds: mention?.agentIds || [],
+					aliases: mention?.aliases || [],
+					mentionReady: !!a.chatbotUserId
+				};
+			}) });
+		} catch (err) {
+			log?.error?.(`[Gateway][listAccounts] 错误: ${err.message}`);
+			respond(false, { error: err.message });
+		}
+	});
+	/**
+	* 多 bot 协作自检：检查每个 account 是否具备在群里互 @ 的能力。
+	*
+	* 一个 bot 能被其它 bot @ 的前提：
+	*   1. `accounts.<id>.chatbotUserId` / `chatbotCorpId` 已填（从 `[BotIdentity]` 日志抓回来）
+	*   2. bot 当前 enabled 且配了 clientId / clientSecret
+	*
+	* 返回的报告可以直接贴给用户，告诉他下一步该干什么
+	* （比如"给 dev-bot 发一条消息后回填 chatbotUserId"）。
+	*
+	* @example
+	* ```typescript
+	* const r = await gateway.call('dingtalk-connector.bootstrapBotIdentity');
+	* // -> {
+	* //   ready: false,
+	* //   totalAccounts: 2,
+	* //   readyAccounts: 1,
+	* //   missingChatbotUserId: ['dev-bot'],
+	* //   report: '...'
+	* // }
+	* ```
+	*/
+	api.registerGatewayMethod("dingtalk-connector.bootstrapBotIdentity", async ({ context, respond }) => {
+		const { loadConfig } = await import("openclaw/plugin-sdk/config-runtime");
+		const cfg = loadConfig();
+		try {
+			const accountsMap = (cfg.channels?.["dingtalk-connector"])?.accounts || {};
+			const ids = Object.keys(accountsMap);
+			const missingChatbotUserId = [];
+			const missingCredentials = [];
+			const disabled = [];
+			const ready = [];
+			for (const id of ids) {
+				const a = accountsMap[id] || {};
+				if (a.enabled === false) {
+					disabled.push(id);
+					continue;
+				}
+				const hasCreds = !!(a.clientId && a.clientSecret);
+				if (!hasCreds) missingCredentials.push(id);
+				if (!a.chatbotUserId) missingChatbotUserId.push(id);
+				else if (hasCreds) ready.push({
+					accountId: id,
+					name: a.name,
+					chatbotUserId: a.chatbotUserId
+				});
+			}
+			const reportLines = [];
+			reportLines.push(`[BotIdentity] 已配置 ${ids.length} 个账号，其中 ${ready.length} 个可参与多 bot 互相 @`);
+			if (ready.length > 0) reportLines.push("[OK] Ready: " + ready.map((r) => `${r.accountId}(${r.name || ""})`).join(", "));
+			if (missingChatbotUserId.length > 0) reportLines.push(`[WARN] 缺少 chatbotUserId: ${missingChatbotUserId.join(", ")} — 请让这些 bot 在钉钉里各收一条消息，然后在终端 grep "[BotIdentity]" 抓到加密 ID 后回填到 openclaw.json 对应 account`);
+			if (missingCredentials.length > 0) reportLines.push(`[ERR] 缺少 clientId/clientSecret: ${missingCredentials.join(", ")}`);
+			if (disabled.length > 0) reportLines.push(`[PAUSED] 已禁用: ${disabled.join(", ")}`);
+			respond(true, {
+				ready: missingChatbotUserId.length === 0 && missingCredentials.length === 0 && ready.length > 0,
+				totalAccounts: ids.length,
+				readyAccounts: ready.length,
+				readyList: ready,
+				missingChatbotUserId,
+				missingCredentials,
+				disabled,
+				report: reportLines.join("\n")
+			});
+		} catch (err) {
+			log?.error?.(`[Gateway][bootstrapBotIdentity] 错误: ${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-DtdiDpYK.mjs

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

package/dist/index.d.mts

@@ -69,6 +69,11 @@ declare const DingtalkConfigSchema: z$1.ZodObject<{
     debug: z$1.ZodOptional<z$1.ZodBoolean>;
     enableMediaUpload: z$1.ZodOptional<z$1.ZodBoolean>;
     systemPrompt: z$1.ZodOptional<z$1.ZodString>;
+    groupReplyMode: z$1.ZodOptional<z$1.ZodEnum<{
+      aicard: "aicard";
+      text: "text";
+      markdown: "markdown";
+    }>>;
     enabled: z$1.ZodOptional<z$1.ZodBoolean>;
     name: z$1.ZodOptional<z$1.ZodString>;
     clientId: z$1.ZodOptional<z$1.ZodUnion<readonly [z$1.ZodString, z$1.ZodNumber]>>;
@@ -81,6 +86,8 @@ declare const DingtalkConfigSchema: z$1.ZodObject<{
       provider: z$1.ZodString;
       id: z$1.ZodString;
     }, z$1.core.$strip>]>>;
+    chatbotUserId: z$1.ZodOptional<z$1.ZodString>;
+    chatbotCorpId: z$1.ZodOptional<z$1.ZodString>;
   }, z$1.core.$strict>>>>;
   allowFrom: z$1.ZodOptional<z$1.ZodArray<z$1.ZodUnion<readonly [z$1.ZodString, z$1.ZodNumber]>>>;
   groupAllowFrom: z$1.ZodOptional<z$1.ZodArray<z$1.ZodUnion<readonly [z$1.ZodString, z$1.ZodNumber]>>>;
@@ -113,6 +120,11 @@ declare const DingtalkConfigSchema: z$1.ZodObject<{
   debug: z$1.ZodOptional<z$1.ZodBoolean>;
   enableMediaUpload: z$1.ZodOptional<z$1.ZodBoolean>;
   systemPrompt: z$1.ZodOptional<z$1.ZodString>;
+  groupReplyMode: z$1.ZodOptional<z$1.ZodEnum<{
+    aicard: "aicard";
+    text: "text";
+    markdown: "markdown";
+  }>>;
   enabled: z$1.ZodOptional<z$1.ZodBoolean>;
   defaultAccount: z$1.ZodOptional<z$1.ZodString>;
   clientId: z$1.ZodOptional<z$1.ZodUnion<readonly [z$1.ZodString, z$1.ZodNumber]>>;

package/dist/index.mjs

@@ -1,7 +1,41 @@
-import { i as dingtalkPlugin, n as setDingtalkRuntime } from "./runtime-CDlbXD8t.mjs";
-import { t as registerGatewayMethods } from "./gateway-methods-NC5q7QDF.mjs";
+import { i as dingtalkPlugin, n as setDingtalkRuntime } from "./runtime-D35JIkCZ.mjs";
+import { t as registerGatewayMethods } from "./gateway-methods-DI8lkjSd.mjs";
 //#region index.ts
+/**
+* 检测同一 plugin id 在多个路径被加载的情况。
+*
+* 典型场景：`openclaw.json` 里配了本地 `plugins.load.paths`（开发源码），同时 `~/.openclaw/extensions/dingtalk-connector`
+* 也装了 npm 全局扩展，两份 dist/index.mjs 都被 gateway 加载 → 两份 stream 订阅互相抢占，
+* 表现就是"消息时而能收到，时而收不到 / 回复丢失"。
+*
+* 这里做一个轻量自检：
+* - 把当前 index.mjs 的绝对路径写入全局 Symbol 表
+* - 同名 plugin id 被第二次注册时打印警告（或在 `DINGTALK_STRICT_DUPLICATE_LOAD=1` 时直接抛错）
+*
+* 作为运行时兜底，建议同时在 `openclaw.json` 只保留一条加载路径。
+*/
+const DUPLICATE_LOAD_SYMBOL = Symbol.for("@dingtalk-connector/loaded-paths");
+function recordAndCheckLoadPath(api) {
+	try {
+		const g = globalThis;
+		const store = g[DUPLICATE_LOAD_SYMBOL] ?? /* @__PURE__ */ new Map();
+		g[DUPLICATE_LOAD_SYMBOL] = store;
+		const pluginId = "dingtalk-connector";
+		const here = typeof import.meta !== "undefined" && import.meta?.url ? String(import.meta.url) : "<unknown>";
+		const paths = store.get(pluginId) ?? /* @__PURE__ */ new Set();
+		paths.add(here);
+		store.set(pluginId, paths);
+		if (paths.size > 1) {
+			const msg = `[dingtalk-connector] 检测到同 plugin id 被多个路径加载:\n  - ${Array.from(paths).join("\n  - ")}\n这会导致 stream 回调互相抢占、消息丢失。请在 openclaw.json 里只保留一条加载方式：\n  • 本地开发：保留 plugins.load.paths，删除 ~/.openclaw/extensions/dingtalk-connector\n  • 生产：只保留 extensions 安装目录，删除 plugins.load.paths 里对本地仓库的引用`;
+			if (process.env.DINGTALK_STRICT_DUPLICATE_LOAD === "1") throw new Error(msg);
+			api.logger?.warn?.(msg);
+		}
+	} catch (err) {
+		if (process.env.DINGTALK_STRICT_DUPLICATE_LOAD === "1") throw err;
+	}
+}
 function register(api) {
+	recordAndCheckLoadPath(api);
 	setDingtalkRuntime(api.runtime);
 	api.registerChannel({ plugin: dingtalkPlugin });
 	registerGatewayMethods(api);

package/dist/media-DEuF7r3G.mjs

@@ -0,0 +1,2 @@
+import { a as processVideoMarkers, i as processRawMediaPaths, l as toLocalPath, s as sendFileProactive } from "./media-DUMfXnwJ.mjs";
+export { processRawMediaPaths, processVideoMarkers, sendFileProactive, toLocalPath };