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

package/CHANGELOG.md

@@ -8,15 +8,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [0.8.17] - 2026-04-16
 
 ### 新增 / Added
-- ✨ **钉钉工作台 (DWS) CLI 集成** - 安装插件时自动安装 `dws` CLI 工具，支持 AI 表格、日历、通讯录、群聊与机器人、待办、审批、考勤、日志等钉钉产品能力；凭证自动注入，无需手动配置  
+- ✨ **钉钉 DWS CLI 集成** - 安装插件时自动安装 `dws` CLI 工具，支持 AI 表格、日历、通讯录、群聊与机器人、待办、审批、考勤、日志等钉钉产品能力；凭证自动注入，无需手动配置  
   **DingTalk Workspace (DWS) CLI integration** - Auto-installs `dws` CLI during plugin setup, enabling AI Table, Calendar, Contacts, Chat & Bot, Todo, Approval, Attendance, Report and more; credentials injected automatically
 
 - ✨ **Agent Skills 体系** - 新增三组内置 Skill 文档：`dingtalk-channel-rules`（频道能力路由规范）、`dingtalk-troubleshoot`（常见问题排查）、`dws-cli`（DWS CLI 使用指南与产品参考），通过 `openclaw.plugin.json` 注册  
   **Agent Skills system** - Added three built-in Skill document sets: `dingtalk-channel-rules` (channel capability routing), `dingtalk-troubleshoot` (troubleshooting), `dws-cli` (DWS CLI guide & product references), registered via `openclaw.plugin.json`
 
-- ✨ **多 Agent 协作文档** - 新增 `docs/MULTI_AGENT_COLLABORATION.md`，描述 Connector 与 DWS 的职责边界和协作模式  
-  **Multi-Agent collaboration docs** - Added `docs/MULTI_AGENT_COLLABORATION.md` describing Connector vs DWS responsibility boundary and collaboration patterns
-
 ### 修复 / Fixes
 - 🐛 **AI Card finishAICard QPS 限流** - `finishAICard` 的 PUT 请求现在也经过全局令牌桶限流器 `waitForToken()`，避免多会话并发结束时触发 403 QpsLimit  
   **AI Card finishAICard QPS rate limiting** - `finishAICard` PUT request now goes through global token bucket `waitForToken()` to prevent 403 QpsLimit when multiple conversations finish concurrently

package/README.en.md

@@ -25,6 +25,9 @@ This plugin provides comprehensive DingTalk integration for OpenClaw:
 | Category | Capabilities |
 |----------|-------------|
 | 💬 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 |
 
 Additionally, the plugin supports:
 
@@ -35,17 +38,15 @@ Additionally, the plugin supports:
 - 🖼️ **Rich Media**: Receive images/audio/file attachments, auto-upload local images
 - 🔄 **Session Management**: Multi-turn conversation context, isolated sessions for DMs/groups
 
-> 🚧 **Coming Soon** — The following business capabilities are under active development and launching soon! 🎉
+> 🚧 **Coming Soon** — The following capabilities are under active development!
 
 | Category | Capabilities |
 |----------|-------------|
-| 📄 Docs | Create, append, search, and list DingTalk documents |
-| 📅 Calendar | Create/query events, auto-attach DingTalk meeting links, DING reminders, free/busy queries |
-| 📊 AI Sheets | Create sheets, read/write rows, conditional queries |
-| ✅ Tasks | Create personal/group tasks, check status, set deadlines |
+| 🔔 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 |
-| 🔔 DING | Send urgent DING reminders to users/groups |
+| 📄 Docs | Create, append, search, and list DingTalk documents |
 
 ---
 

package/README.md

@@ -25,6 +25,9 @@
 | 类别 | 能力 |
 |------|------|
 | 💬 消息收发 | 接收群聊/私聊消息，自动回复，发送文本/Markdown，@成员 |
+| ✅ 待办任务 | 创建个人待办，查状态，设截止时间 |
+| 📊 AI 表格 | 创建表格，读写行数据，条件查询 |
+| 📅 日历日程 | 日历管理、日程管理（创建/查询/修改/删除/搜索）、参会人管理、忙闲查询 |
 
 此外，插件还支持：
 
@@ -35,17 +38,15 @@
 - 🖼️ **富媒体处理**：接收图片/音频/文件附件，自动上传本地图片
 - 🔄 **会话管理**：多轮对话上下文保持，私聊/群聊会话隔离
 
-> 🚧 **Coming Soon** — 以下业务能力正在开发中，即将上线，敬请期待！🎉
+> 🚧 **Coming Soon** — 以下能力正在开发中，敬请期待！
 
 | 类别 | 能力 |
 |------|------|
-| 📄 钉钉文档 | 创建、追加、搜索、列举钉钉文档 |
-| 📅 日历会议 | 创建/查询日程，自动带钉钉会议链接，DING 提醒，忙闲查询 |
-| 📊 AI 表格 | 创建表格，读写行数据，条件查询 |
-| ✅ 待办任务 | 创建个人/群待办，查状态，设截止时间 |
+| ✅ 待办任务 | 创建群待办，查状态，设截止时间 |
+| 🔔 DING 消息 | 向用户/群发送强提醒 DING |
 | 📝 日志 | 提交日报/周报，查历史日志 |
 | 📁 文件云盘 | 上传/下载文件到钉钉云盘 |
-| 🔔 DING 消息 | 向用户/群发送强提醒 DING |
+| 📄 钉钉文档 | 创建、追加、搜索、列举钉钉文档 |
 
 ---
 

package/bin/dingtalk-connector.js

@@ -169,6 +169,32 @@ function clearStaging() {
   } catch {}
 }
 
+/**
+ * Check if existing config has both dingtalk channels (with credentials) and bindings.
+ * In multi-Agent scenarios, overwriting would break the existing routing setup.
+ */
+ function hasExistingMultiAgentConfig(cfg) {
+  const dingtalkCfg = cfg?.channels?.[CHANNEL_ID];
+  if (!dingtalkCfg) return false;
+
+  // 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
+  const bindings = Array.isArray(cfg.bindings) ? cfg.bindings : [];
+  const hasDingtalkBindings = bindings.some(
+    (b) => !b?.match?.channel || String(b.match.channel) === CHANNEL_ID
+  );
+
+  return hasDingtalkBindings;
+}
+
 function saveCredentials(clientId, clientSecret, { isLocal = false, pluginInstalled = true } = {}) {
   const cfg = readConfig();
 
@@ -179,6 +205,20 @@ function saveCredentials(clientId, clientSecret, { isLocal = false, pluginInstal
   const writePluginEntries = pluginInstalled || isLocal;
 
   if (writePluginEntries) {
+    // ── Multi-Agent protection ──
+    // 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(dim('  直接覆盖可能影响现有的多 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;
+    }
+
     // ── channels.[CHANNEL_ID] ──
     if (!cfg.channels) cfg.channels = {};
     if (!cfg.channels[CHANNEL_ID]) cfg.channels[CHANNEL_ID] = {};

package/docs/RELEASE_NOTES_V0.8.17.md

@@ -2,13 +2,13 @@
 
 ## 🎉 新版本亮点 / Highlights
 
-本次版本最大亮点是 **钉钉工作台 (DWS) CLI 集成** 和 **Agent Skills 体系**，让钉钉机器人不仅能聊天，还能直接操作 AI 表格、日历、通讯录、待办、审批等钉钉产品能力。同时引入 `tsdown` 预编译构建，提升插件启动速度和兼容性。
+本次版本最大亮点是 **钉钉 DWS CLI 集成** 和 **Agent Skills 体系**，让钉钉机器人不仅能聊天，还能直接操作 AI 表格、日历、通讯录、待办、审批等钉钉产品能力。同时引入 `tsdown` 预编译构建，提升插件启动速度和兼容性。
 
 The highlight of this release is **DingTalk Workspace (DWS) CLI integration** and the **Agent Skills system**, enabling the bot to not only chat but also directly operate DingTalk products like AI Table, Calendar, Contacts, Todo, Approval, and more. Additionally, `tsdown` pre-compiled build is introduced for faster startup and better compatibility.
 
 ## ✨ 新增 / Added
 
-- **钉钉工作台 (DWS) CLI 集成 / DWS CLI Integration**  
+- **钉钉 DWS CLI 集成 / DWS CLI Integration**  
   安装插件时自动安装 `dws` CLI 工具，支持 AI 表格、日历、通讯录、群聊与机器人、待办、审批、考勤、日志等钉钉产品能力。凭证自动注入，无需手动配置。可通过 `--skip-dws` 参数跳过。  
   Auto-installs `dws` CLI during plugin setup, enabling AI Table, Calendar, Contacts, Chat & Bot, Todo, Approval, Attendance, Report and more. Credentials injected automatically. Use `--skip-dws` to skip.
 
@@ -23,10 +23,6 @@ The highlight of this release is **DingTalk Workspace (DWS) CLI integration** an
   - `dingtalk-troubleshoot` — Troubleshooting guide  
   - `dws-cli` — DWS CLI guide with 9 product reference docs (AI Table, Calendar, Contacts, etc.)
 
-- **多 Agent 协作文档 / Multi-Agent Collaboration Docs**  
-  新增 `docs/MULTI_AGENT_COLLABORATION.md`，描述 Connector 与 DWS 的协作模式。  
-  Added `docs/MULTI_AGENT_COLLABORATION.md` describing Connector vs DWS collaboration patterns.
-
 ## 🐛 修复 / Fixes
 
 - **AI Card finishAICard QPS 限流 / finishAICard QPS rate limiting**  
@@ -70,7 +66,7 @@ The highlight of this release is **DingTalk Workspace (DWS) CLI integration** an
 ## 📥 安装升级 / Installation & Upgrade
 
 ```bash
-npx --yes --package @dingtalk-real-ai/dingtalk-connector dingtalk-connector install
+npx -y @dingtalk-real-ai/dingtalk-connector@0.8.17 install
 ```
 
 或手动安装：

package/openclaw.plugin.json

@@ -1,7 +1,7 @@
 {
   "id": "dingtalk-connector",
   "name": "DingTalk Channel",
-  "version": "0.8.17",
+  "version": "0.8.18-beta.0",
   "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.17",
+  "version": "0.8.18-beta.0",
   "description": "Official OpenClaw DingTalk channel plugin | 钉钉官方 OpenClaw 插件",
   "type": "module",
   "exports": {
@@ -99,7 +99,7 @@
     "mammoth": "^1.8.0"
   },
   "peerDependencies": {
-    "openclaw": ">=2026.3.23"
+    "openclaw": ">=2026.4.9"
   },
   "peerDependenciesMeta": {
     "openclaw": {
@@ -138,7 +138,7 @@
     "@types/node": "^20.19.37",
     "@vitest/coverage-v8": "^2.0.0",
     "@vitest/ui": "^2.1.9",
-    "openclaw": ">=2026.3.23",
+    "openclaw": "^2026.4.9",
     "tsdown": "^0.21.4",
     "typescript": "^5.6.0",
     "vitest": "^2.1.9"

package/docs/MULTI_AGENT_COLLABORATION.md

@@ -1,116 +0,0 @@
-# 钉钉多 Agent 协作指南 (Multi-Agent Collaboration)
-
-本文档旨在介绍如何在 DingTalk OpenClaw Connector 环境下实现多 Agent 的支持与深度协作。
-
----
-
-## 一、多 Agent 能力支持 (Support)
-
-多 Agent 支持是指将同一个钉钉连接器实例（Connector）连接到多个专业的 AI Agent，根据会话来源（如特定的用户或特定的群聊）将消息路由到对应的 Agent 处理。
-
-### 1.1 核心路由逻辑
-Connector 通过读取 `openclaw.json` 中的 `bindings` 配置来决定消息去向。
-- **配置位置**: `openclaw.json` -> `bindings`
-- **匹配维度**: 账号 ID (`accountId`)、会话类型 (`peer.kind`)、具体 ID (`peer.id`)。
-- **代码实现参考**: [message-handler.ts](file:///Users/xinzhizhu/dingtalk-openclaw-connector/src/core/message-handler.ts) 中的 `Agent 路由解析`。
-
-### 1.2 配置示例
-以下示例展示了如何将“客服账号”路由到 `support-agent`，将“技术群”路由到 `dev-agent`：
-
-```json
-{
-  "bindings": [
-    {
-      "agentId": "dev-agent",
-      "match": {
-        "channel": "dingtalk-connector",
-        "peer": { "kind": "group", "id": "cid_tech_group_id_xxx" }
-      }
-    },
-    {
-      "agentId": "support-agent",
-      "match": {
-        "channel": "dingtalk-connector",
-        "accountId": "customer_service_bot"
-      }
-    }
-  ],
-  "defaultAgent": "main"
-}
-```
-
-> [!TIP]
-> 详见 [AGENT_ROUTING.md](file:///Users/xinzhizhu/dingtalk-openclaw-connector/docs/AGENT_ROUTING.md) 获取完整的路由匹配与 Session 隔离规范。
-
----
-
-## 二、协作模式一：基于钉钉文档的状态共享 (State Sharing)
-
-多 Agent 协作最常见的场景是“信息接力”。例如，Agent A 负责分析需求并写入文档，Agent B 随后读取该文档并生成代码。
-
-### 2.1 协作原理
-利用 `docs.*` 系列工具，Agent 可以打破会话上下文的限制，通过外部媒介（钉钉文档）进行异步协作。
-- **能力提供者**: [docs.ts](file:///Users/xinzhizhu/dingtalk-openclaw-connector/src/docs.ts)
-- **核心工具**:
-    - `docs.create`: 创建协作起点。
-    - `docs.append`: 追加处理进度或中间产物。
-    - `docs.read`: 获取协作文档的最新内容。
-
-### 2.2 协作流程示例
-1. **Agent A (项目经理)**: 收到群聊指令，调用 `docs.create` 创建《项目需求.md》。
-2. **Agent B (架构师)**: 监听或被提及后，调用 `docs.read` 读取该文档，并使用 `docs.append` 补充架构方案。
-3. **用户**: 在钉钉中直接看到文档链接并参与评论。
-
----
-
-## 三、协作模式二：基于 Gateway Methods 的跨 Agent 通信
-
-Connector 注册了一系列 RPC 方法（Gateway Methods），允许一个 Agent 间接地触达另一个 Agent 的用户或环境。
-
-### 3.1 关键 RPC 方法
-- **`dingtalk-connector.sendToGroup`**: 允许 Agent 跨越自身绑定的群聊，向其他群发送通知。
-- **`dingtalk-connector.docs.create/append`**: 允许 Agent 在没有直接文档访问权限的情况下，通过 Connector 代理操作。
-
-### 3.2 协作场景：自动化报警接力
-1. **运维 Agent**: 检测到系统异常，调用 `gateway.call('dingtalk-connector.sendToGroup', { ... })` 向“紧急处理群”发送报警。
-2. **值班 Agent**: 在该群接收到消息（由于 bindings 配置），开始介入处理。
-
----
-
-## 四、实战：构建多 Agent 协作工作流
-
-以下是一个完整的配置片段，展示了多账号与多 Agent 的配合：
-
-```json5
-{
-  "agents": {
-    "list": [
-      { "id": "manager", "name": "项目主管" },
-      { "id": "executor", "name": "执行专家" }
-    ]
-  },
-  "channels": {
-    "dingtalk-connector": {
-      "accounts": {
-        "bot_a": { "clientId": "...", "clientSecret": "..." },
-        "bot_b": { "clientId": "...", "clientSecret": "..." }
-      }
-    }
-  },
-  "bindings": [
-    // bot_a 接收所有指令，由 manager 处理
-    { "agentId": "manager", "match": { "accountId": "bot_a" } },
-    // 所有的执行类任务路由到 executor
-    { "agentId": "executor", "match": { "peer": { "kind": "group", "id": "executor_group_id" } } }
-  ]
-}
-```
-
-### 协作建议
-- **使用统一的 Workspace**: 确保协作的 Agent 能够访问到相同的本地媒体文件路径（通过 `resolveAgentWorkspaceDir` 实现）。
-- **统一 SessionKey**: 如需强耦合，可配置 `sharedMemoryAcrossConversations: true` 共享长期记忆。
-
----
-
-> [!IMPORTANT]
-> 本文档为初版，由 DingTalk Real Team持续维护。如有问题请提交 Issue。