@dingtalk-real-ai/dingtalk-connector 0.8.6 → 0.8.8

package/CHANGELOG.md

@@ -5,6 +5,46 @@ 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.8] - 2026-03-29
+
+### 修复 / Fixes
+- 🐛 **多 block 流式响应产生多条独立气泡** ([#369](https://github.com/DingTalk-Real-AI/dingtalk-openclaw-connector/issues/369)) - 重构 `startStreaming` 并发控制逻辑，从 `isCreatingCard` 布尔标志改为 `cardCreationPromise`，彻底消除多 block 响应场景下每个 block 新建独立 AI Card 气泡的问题  
+  **Multi-block streaming response creates multiple bubbles** - Refactored `startStreaming` concurrency control from boolean flag to `cardCreationPromise`, eliminating independent AI Card bubbles per block in multi-block responses
+
+- 🐛 **Web UI Connected / Last inbound 显示 n/a** - 新增 `onStatusChange` 回调在连接建立/断开/收到消息时上报状态字段；补全 `buildSessionContext` 中 `conversationId` 和 `groupSubject` 字段透传  
+  **Web UI shows n/a for Connected and Last inbound** - Added `onStatusChange` callback to report status fields on connection events; fixed `buildSessionContext` field passthrough
+
+- 🐛 **AI Card 函数调用参数错误** - 修复 `reply-dispatcher.ts` 中 `createAICardForTarget`、`streamAICard`、`finishAICard` 参数从 `params.runtime` 改为 `account.config/log`  
+  **AI Card function call parameter error** - Fixed parameters in `reply-dispatcher.ts` from `params.runtime` to `account.config/log`
+
+- 🐛 **sendFileProactive 参数错误导致文件发送失败** - 修复 `processFileMarkers` 和 `processRawMediaPaths` 错误传入 `downloadUrl`，改为正确的 `cleanMediaId`  
+  **File sending failure due to wrong sendFileProactive parameter** - Fixed incorrect `downloadUrl` parameter, now correctly uses `cleanMediaId`
+
+- 🐛 **纯多账号配置下 probe 被跳过** ([#381](https://github.com/DingTalk-Real-AI/dingtalk-openclaw-connector/issues/381)) - `getStatus()` 改用 `resolveDingtalkAccount()` 统一获取账号信息，修复纯多账号配置下状态显示不准确的问题  
+  **Probe skipped in pure multi-account config** - `getStatus()` now uses `resolveDingtalkAccount()` for unified account resolution
+
+### 改进 / Improvements
+- ✅ **音频时长提取安全性改进** ([#134](https://github.com/DingTalk-Real-AI/dingtalk-openclaw-connector/issues/134)) - `extractAudioDuration` 改用 `fluent-ffmpeg` 的 `ffprobe` API，消除安全扫描误报  
+  **Audio duration extraction security improvement** - Changed to `fluent-ffmpeg` `ffprobe` API, eliminating security scan false positives
+
+- ✅ **SDK 接口迁移** - `onboarding.ts` 类型引用迁移到新版 `ChannelSetupWizardAdapter`，导入路径更新为 `openclaw/plugin-sdk/setup`  
+  **SDK interface migration** - Migrated to `ChannelSetupWizardAdapter` and updated import path to `openclaw/plugin-sdk/setup`
+
+## [0.8.7] - 2026-03-26
+
+### 修复 / Fixes
+- 🐛 **账号 ID 大小写敏感修复** - 修复 `normalizeAccountId` 函数强制将账号 ID 转为小写（`.toLowerCase()`）导致驼峰命名账号（如 `zhizaoDashuIP`）无法匹配配置的问题。现在账号 ID 仅做 `trim()` 处理，保留原始大小写，与配置文件中的 key 严格匹配  
+  **Account ID case-sensitivity fix** - Fixed `normalizeAccountId` forcibly lowercasing account IDs, which caused camelCase account IDs (e.g., `zhizaoDashuIP`) to fail configuration lookup. Account IDs are now only trimmed, preserving original casing for strict matching against config keys
+
+- 🐛 **WebSocket 连接代理控制统一** - 修复 `src/core/connection.ts` 中 WebSocket 连接未遵循 `DINGTALK_FORCE_PROXY` 环境变量的问题，现在与 HTTP 请求保持一致的代理控制逻辑  
+  **Unified proxy control for WebSocket connections** - Fixed WebSocket connections not respecting the `DINGTALK_FORCE_PROXY` environment variable; proxy control is now consistent with HTTP requests
+
+- 🐛 **媒体下载代理控制统一** - 修复 `src/core/message-handler.ts` 中图片/文件下载时代理配置与 HTTP 客户端不一致的问题，确保所有媒体下载请求统一遵循代理控制策略  
+  **Unified proxy control for media downloads** - Fixed inconsistent proxy configuration for image/file downloads; all media download requests now follow the unified proxy control policy
+
+- 🐛 **多账号消息去重误判** - 修复多账号（多机器人）场景下，同一条群消息 @多个机器人时，第二个机器人因去重缓存未按账号隔离，误将消息判定为重复而跳过处理的问题。`checkAndMarkDingtalkMessage` 的去重 key 现在带有 `accountId` 前缀，不同机器人账号的去重缓存完全隔离  
+  **Multi-account message deduplication false positive** - Fixed an issue where a group message mentioning multiple bots caused the second bot to skip processing due to a shared deduplication cache. The deduplication key now includes an `accountId` prefix, fully isolating each bot's cache
+
 ## [0.8.6] - 2026-03-24
 
 ### 改进 / Improvements

package/README.en.md

@@ -19,6 +19,7 @@
 - [Configuration](#configuration)
 - [Troubleshooting](#troubleshooting)
 - [Advanced Topics](#advanced-topics)
+- [DingTalk DEAP Agent Integration](docs/DEAP_AGENT_GUIDE.en.md)
 - [License](#license)
 
 ---
@@ -61,19 +62,67 @@ Whenever you see `~/.openclaw/openclaw.json` below, it is equivalent to the abov
 
 ### Step 1: Install the Plugin
 
+#### Method A: Install via npm (Recommended)
+
 ```bash
-# Recommended: Install from npm
 openclaw plugins install @dingtalk-real-ai/dingtalk-connector
+```
+
+#### Method B: Install from Local Source
+
+If you want to develop or modify the plugin, clone the repository first:
+
+```bash
+# 1. Clone the plugin repository
+git clone https://github.com/DingTalk-Real-AI/dingtalk-openclaw-connector.git
+cd dingtalk-openclaw-connector
+
+# 2. Install dependencies (required)
+npm install
+
+# 3. Install in link mode (changes take effect immediately)
+openclaw plugins install -l .
+```
+
+#### Method C: Manual Installation
+
+1. Download or copy this repository to `~/.openclaw/extensions/dingtalk-connector`.
+2. Make sure it contains `index.ts`, `openclaw.plugin.json`, and `package.json`.
+3. Run `npm install` in that directory to install dependencies.
+
+#### Method D: China Mainland Installation (npm Mirror)
+
+If `openclaw plugins install` gets stuck at `Installing plugin dependencies...` or fails with `npm install failed` due to network issues in China, you can specify a mirror registry for that install:
+
+```bash
+NPM_CONFIG_REGISTRY=https://registry.npmmirror.com openclaw plugins install @dingtalk-real-ai/dingtalk-connector
+```
+
+If the plugin is in a partially installed state (e.g., the extension directory exists but dependencies are incomplete), you can manually reinstall dependencies:
+
+```bash
+cd ~/.openclaw/extensions/dingtalk-connector
+rm -rf node_modules package-lock.json
+NPM_CONFIG_REGISTRY=https://registry.npmmirror.com npm install
+```
+
+To make the mirror permanent, set the default npm registry:
 
-# Alternative: Install from Git
-openclaw plugins install https://github.com/DingTalk-Real-AI/dingtalk-openclaw-connector.git
+```bash
+npm config set registry https://registry.npmmirror.com
+```
+
+Or add to `~/.npmrc`:
+
+```
+registry=https://registry.npmmirror.com
 ```
 
 **Verify installation**:
 ```bash
 openclaw plugins list
 ```
-You should see `✓ DingTalk Channel (v0.8.0) - loaded`
+You should see `✓ DingTalk Channel (v0.8.6) - loaded`
 
 ---
 
@@ -412,6 +461,12 @@ dingtalk-openclaw-connector/
 
 ---
 
+## DingTalk DEAP Agent Integration
+
+Connect DingTalk DEAP Agent with OpenClaw Gateway to enable natural language-driven local device operations. See **[DingTalk DEAP Agent Integration Guide](docs/DEAP_AGENT_GUIDE.en.md)** for details.
+
+---
+
 ## License
 
 [MIT](LICENSE)

package/README.md

@@ -19,6 +19,7 @@
 - [配置说明](#配置说明)
 - [常见问题](#常见问题)
 - [进阶主题](#进阶主题)
+- [钉钉 DEAP Agent 集成](docs/DEAP_AGENT_GUIDE.md)
 - [许可证](#许可证)
 
 ---
@@ -93,19 +94,67 @@ yarn global add openclaw@latest
 
 ### 步骤 1：安装插件
 
+#### 方法 A：通过 npm 包安装（推荐）
+
 ```bash
-# 推荐：从 npm 安装
 openclaw plugins install @dingtalk-real-ai/dingtalk-connector
+```
+
+#### 方法 B：通过本地源码安装
+
+如果你想对插件进行二次开发，可以先克隆仓库：
+
+```bash
+# 1. 克隆插件仓库
+git clone https://github.com/DingTalk-Real-AI/dingtalk-openclaw-connector.git
+cd dingtalk-openclaw-connector
+
+# 2. 安装依赖（必需）
+npm install
+
+# 3. 以链接模式安装（方便修改代码后实时生效）
+openclaw plugins install -l .
+```
+
+#### 方法 C：手动安装
+
+1. 将本仓库下载或复制到 `~/.openclaw/extensions/dingtalk-connector`。
+2. 确保包含 `index.ts`、`openclaw.plugin.json` 和 `package.json`。
+3. 在该目录下运行 `npm install` 安装依赖。
+
+#### 方法 D：国内网络环境安装（npm 镜像源）
+
+如果你在国内网络环境下执行 `openclaw plugins install` 时卡在 `Installing plugin dependencies...` 或出现 `npm install failed`，可临时为该次安装指定镜像源：
+
+```bash
+NPM_CONFIG_REGISTRY=https://registry.npmmirror.com openclaw plugins install @dingtalk-real-ai/dingtalk-connector
+```
+
+如果插件已处于半安装状态（例如扩展目录存在但依赖未装全），可进入插件目录手动补装依赖：
+
+```bash
+cd ~/.openclaw/extensions/dingtalk-connector
+rm -rf node_modules package-lock.json
+NPM_CONFIG_REGISTRY=https://registry.npmmirror.com npm install
+```
+
+如果希望长期生效，可设置 npm 默认镜像：
 
-# 或者：从 Git 安装
-openclaw plugins install https://github.com/DingTalk-Real-AI/dingtalk-openclaw-connector.git
+```bash
+npm config set registry https://registry.npmmirror.com
+```
+
+或写入 `~/.npmrc`：
+
+```
+registry=https://registry.npmmirror.com
 ```
 
 **验证安装**：
 ```bash
 openclaw plugins list
 ```
-你应该看到 `✓ DingTalk Channel (v0.8.0) - loaded`
+你应该看到 `✓ DingTalk Channel (v0.8.6) - loaded`
 
 ---
 
@@ -455,6 +504,12 @@ dingtalk-openclaw-connector/
 
 ---
 
+## 钉钉 DEAP Agent 集成
+
+通过钉钉 DEAP Agent 与 OpenClaw Gateway 连接，实现自然语言驱动的本地设备操作能力。详见 **[钉钉 DEAP Agent 集成指南](docs/DEAP_AGENT_GUIDE.md)**。
+
+---
+
 ## 许可证
 
 [MIT](LICENSE)

package/docs/DEAP_AGENT_GUIDE.en.md

@@ -0,0 +1,115 @@
+# DingTalk DEAP Agent Integration
+
+> [中文版](DEAP_AGENT_GUIDE.md)
+
+Connect DingTalk [DEAP](https://deap.dingtalk.com) Agent with [OpenClaw](https://openclaw.ai) Gateway to enable natural language-driven local device operations.
+
+## Key Features
+
+- ✅ **Natural Language Interaction** - Users type natural language commands in the DingTalk chat (e.g., "Find PDF files on my desktop"), and the Agent automatically parses and executes the corresponding operations
+- ✅ **NAT Traversal** - Designed for local devices without public IPs, establishing a stable communication tunnel between local and cloud environments via the Connector client
+- ✅ **Cross-Platform Support** - Provides native binaries for Windows, macOS, and Linux, ensuring smooth operation across all platforms
+
+## System Architecture
+
+This solution uses a layered architecture with three core components:
+
+1. **OpenClaw Gateway** - Deployed on the local device, provides a standardized HTTP interface for receiving and processing operation commands from the cloud, leveraging the OpenClaw engine to execute tasks
+2. **DingTalk OpenClaw Connector** - Runs locally, building a communication tunnel between local and cloud environments to solve the problem of local devices without public IPs
+3. **DingTalk DEAP MCP** - An extension module for the DEAP Agent, responsible for forwarding user natural language requests to the OpenClaw Gateway via the cloud tunnel
+
+```mermaid
+graph LR
+    subgraph "DingTalk App"
+        A["User chats with Agent"] --> B["DEAP Agent"]
+    end
+
+    subgraph "Local Environment"
+        D["DingTalk OpenClaw Connector"] --> C["OpenClaw Gateway"]
+        C --> E["PC Operation Execution"]
+    end
+
+    B -.-> D
+```
+
+## Implementation Guide
+
+### Step 1: Set Up the Local Environment
+
+Ensure the OpenClaw Gateway is installed and running on your local device. The default address is `127.0.0.1:18789`:
+
+```bash
+openclaw gateway start
+```
+
+#### Configure Gateway Parameters
+
+1. Visit the [Configuration Page](http://127.0.0.1:18789/config)
+2. In the **Overview**, set the Gateway Token and save it securely:
+   ![alt text](images/image-5.png)
+3. Switch to **Infrastructure** and enable the `OpenAI Chat Completions Endpoint`:
+   ![alt text](images/image-6.png)
+
+4. Click the `Save` button in the top-right corner to save your configuration
+
+### Step 2: Obtain Required Parameters
+
+#### Get corpId
+
+Log in to the [DingTalk Developer Platform](https://open-dev.dingtalk.com) to find your enterprise CorpId:
+
+<img width="864" height="450" alt="Get corpId from DingTalk Developer Platform" src="https://github.com/user-attachments/assets/18ec9830-2d43-489a-a73f-530972685225" />
+
+#### Get apiKey
+
+Log in to the [DingTalk DEAP Platform](https://deap.dingtalk.com), navigate to **Security & Permissions** → **API-Key Management** to create a new API Key:
+
+<img width="1222" height="545" alt="DingTalk DEAP Platform API-Key Management" src="https://github.com/user-attachments/assets/dfe29984-4432-49c1-8226-0f9b60fbb5bc" />
+
+### Step 3: Start the Connector Client
+
+1. Download the installer for your operating system from the [Releases](https://github.com/hoskii/dingtalk-openclaw-connector/releases/tag/v0.0.1) page
+2. Extract and run the Connector in the corresponding directory (macOS example):
+
+   ```bash
+   unzip connector-mac.zip
+   ./connector-darwin -deapCorpId YOUR_CORP_ID -deapApiKey YOUR_API_KEY
+   ```
+   ![alt text](images/image-7.png)
+
+### Step 4: Configure the DEAP Agent
+
+1. Log in to the [DingTalk DEAP Platform](https://deap.dingtalk.com) and create a new agent:
+
+   <img width="2444" height="1486" alt="Create New Agent" src="https://github.com/user-attachments/assets/0b7f0855-f991-4aeb-b6e6-7576346b4477" />
+
+2. In the skill management page, search for and integrate the OpenClaw skill:
+
+   <img width="3430" height="1732" alt="Add OpenClaw Skill" src="https://github.com/user-attachments/assets/d44f0038-f863-4c1f-afa7-b774d875e4ba" />
+
+3. Configure skill parameters:
+
+   | Parameter    | Source     | Description                                                                            |
+   | ------------ | ---------- | -------------------------------------------------------------------------------------- |
+   | apikey       | From Step 2 | DEAP Platform API Key                                                                  |
+   | apihost      | Default     | Typically `127.0.0.1:18789`. On Windows, you may need to use `localhost:18789` instead |
+   | gatewayToken | From Step 1 | Gateway authentication token                                                           |
+
+   <img width="3426" height="1752" alt="Configure OpenClaw Skill Parameters" src="https://github.com/user-attachments/assets/bc725789-382f-41b5-bbdb-ba8f29923d5c" />
+
+Note that OpenClaw is an MCP, so you also need to configure its trigger rules. The MCP will only be invoked when the rules are satisfied:
+<img width="1088" height="526" alt="image" src="https://github.com/user-attachments/assets/8b0b6f6d-70ff-4edc-b674-7a24126aadfa" />
+
+4. Publish the Agent:
+
+   <img width="3416" height="1762" alt="Publish Agent" src="https://github.com/user-attachments/assets/3f8c3fdb-5f2b-4a4b-8896-35202e713bf3" />
+
+### Step 5: Start Using
+
+1. Search for and find your Agent in the DingTalk App:
+
+   <img width="1260" height="436" alt="Search for Agent" src="https://github.com/user-attachments/assets/30feff80-1b28-4274-830b-7045aed14980" />
+
+2. Start your natural language conversation:
+
+   <img width="1896" height="1240" alt="Chat with Agent" src="https://github.com/user-attachments/assets/2a80aab8-3fbf-4d18-beea-770577cb1a40" />

package/docs/DEAP_AGENT_GUIDE.md

@@ -0,0 +1,115 @@
+# 钉钉 DEAP Agent 集成
+
+> [English Version](DEAP_AGENT_GUIDE.en.md)
+
+通过将钉钉 [DEAP](https://deap.dingtalk.com) Agent 与 [OpenClaw](https://openclaw.ai) Gateway 连接，实现自然语言驱动的本地设备操作能力。
+
+## 核心功能
+
+- ✅ **自然语言交互** - 用户在钉钉对话框中输入自然语言指令（如"帮我查找桌面上的 PDF 文件"），Agent 将自动解析并执行相应操作
+- ✅ **内网穿透机制** - 专为本地设备无公网 IP 场景设计，通过 Connector 客户端建立稳定的内外网通信隧道
+- ✅ **跨平台兼容** - 提供 Windows、macOS 和 Linux 系统的原生二进制执行文件，确保各平台下的顺畅运行
+
+## 系统架构
+
+该方案采用分层架构模式，包含三个核心组件：
+
+1. **OpenClaw Gateway** - 部署于本地设备，提供标准化 HTTP 接口，负责接收并处理来自云端的操作指令，调动 OpenClaw 引擎执行具体任务
+2. **DingTalk OpenClaw Connector** - 运行于本地环境，构建本地与云端的通信隧道，解决内网设备无公网 IP 的问题
+3. **DingTalk DEAP MCP** - 作为 DEAP Agent 的扩展能力模块，负责将用户自然语言请求经由云端隧道转发至 OpenClaw Gateway
+
+```mermaid
+graph LR
+    subgraph "钉钉 App"
+        A["用户与 Agent 对话"] --> B["DEAP Agent"]
+    end
+
+    subgraph "本地环境"
+        D["DingTalk OpenClaw Connector"] --> C["OpenClaw Gateway"]
+        C --> E["PC 操作执行"]
+    end
+
+    B -.-> D
+```
+
+## 实施指南
+
+### 第一步：部署本地环境
+
+确认本地设备已成功安装并启动 OpenClaw Gateway，默认监听地址为 `127.0.0.1:18789`：
+
+```bash
+openclaw gateway start
+```
+
+#### 配置 Gateway 参数
+
+1. 访问 [配置页面](http://127.0.0.1:18789/config)
+2. 在 **概览** 中设置 Gateway Token 并妥善保存：
+   ![alt text](images/image-5.png)
+3. 切换至 **基础设施**，启用 `OpenAI Chat Completions Endpoint` 功能：
+   ![alt text](images/image-6.png)
+
+4. 点击右上角 `Save` 按钮完成配置保存
+
+### 第二步：获取必要参数
+
+#### 获取 corpId
+
+登录 [钉钉开发者平台](https://open-dev.dingtalk.com) 查看企业 CorpId：
+
+<img width="864" height="450" alt="钉钉开发者平台获取 corpId" src="https://github.com/user-attachments/assets/18ec9830-2d43-489a-a73f-530972685225" />
+
+#### 获取 apiKey
+
+登录 [钉钉 DEAP 平台](https://deap.dingtalk.com)，在 **安全与权限** → **API-Key 管理** 页面创建新的 API Key：
+
+<img width="1222" height="545" alt="钉钉 DEAP 平台 API-Key 管理" src="https://github.com/user-attachments/assets/dfe29984-4432-49c1-8226-0f9b60fbb5bc" />
+
+### 第三步：启动 Connector 客户端
+
+1. 从 [Releases](https://github.com/hoskii/dingtalk-openclaw-connector/releases/tag/v0.0.1) 页面下载适配您操作系统的安装包
+2. 解压后在对应目录运行 Connector（以 macOS 为例）：
+
+   ```bash
+   unzip connector-mac.zip
+   ./connector-darwin -deapCorpId YOUR_CORP_ID -deapApiKey YOUR_API_KEY
+   ```
+   ![alt text](images/image-7.png)
+
+### 第四步：配置 DEAP Agent
+
+1. 登录 [钉钉 DEAP 平台](https://deap.dingtalk.com)，创建新的智能体：
+
+   <img width="2444" height="1486" alt="新建智能体界面" src="https://github.com/user-attachments/assets/0b7f0855-f991-4aeb-b6e6-7576346b4477" />
+
+2. 在技能管理页面，搜索并集成 OpenClaw 技能：
+
+   <img width="3430" height="1732" alt="添加 OpenClaw 技能" src="https://github.com/user-attachments/assets/d44f0038-f863-4c1f-afa7-b774d875e4ba" />
+
+3. 配置技能参数：
+
+   | 参数         | 来源       | 说明                                                                                   |
+   | ------------ | ---------- | -------------------------------------------------------------------------------------- |
+   | apikey       | 第二步获取 | DEAP 平台 API Key                                                                      |
+   | apihost      | 默认值     | 通常为 `127.0.0.1:18789`，在Windows环境下可能需要配置为 `localhost:18789` 才能正常工作 |
+   | gatewayToken | 第一步获取 | Gateway 配置的认证令牌                                                                 |
+
+   <img width="3426" height="1752" alt="配置 OpenClaw 技能参数" src="https://github.com/user-attachments/assets/bc725789-382f-41b5-bbdb-ba8f29923d5c" />
+
+注意 OpenClaw 属于一个MCP，还需要配置他的触发规则，满足规则的情况下才会使用这个MCP:
+<img width="1088" height="526" alt="image" src="https://github.com/user-attachments/assets/8b0b6f6d-70ff-4edc-b674-7a24126aadfa" />
+
+4. 发布 Agent：
+
+   <img width="3416" height="1762" alt="发布 Agent" src="https://github.com/user-attachments/assets/3f8c3fdb-5f2b-4a4b-8896-35202e713bf3" />
+
+### 第五步：开始使用
+
+1. 在钉钉 App 中搜索并找到您创建的 Agent：
+
+   <img width="1260" height="436" alt="搜索 Agent" src="https://github.com/user-attachments/assets/30feff80-1b28-4274-830b-7045aed14980" />
+
+2. 开始自然语言对话体验：
+
+   <img width="1896" height="1240" alt="与 Agent 对话" src="https://github.com/user-attachments/assets/2a80aab8-3fbf-4d18-beea-770577cb1a40" />

package/install-npm.sh

@@ -0,0 +1,167 @@
+#!/usr/bin/env bash
+# =============================================================================
+# install-npm.sh
+# 将 dingtalk-connector 插件从本地 git 路径安装切换到 npm 包安装
+#
+# 流程：
+#   1. 备份当前 openclaw.json 配置文件
+#   2. 写入最小化干净配置（让 openclaw plugins 命令能正常运行）
+#   3. 卸载旧插件（清除本地路径安装记录）
+#   4. 从 npm 安装最新版插件
+#   5. 恢复备份的配置文件（保留用户的所有业务配置）
+# =============================================================================
+
+set -euo pipefail
+
+# ============ 常量 ============
+OPENCLAW_CONFIG="$HOME/.openclaw/openclaw.json"
+PLUGIN_NAME="dingtalk-connector"
+NPM_PACKAGE="@dingtalk-real-ai/dingtalk-connector"
+TIMESTAMP=$(date +%Y%m%d_%H%M%S)
+BACKUP_FILE="${OPENCLAW_CONFIG}.migrate_backup.${TIMESTAMP}"
+
+# ============ 颜色输出 ============
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+log_info()    { echo -e "${BLUE}[INFO]${NC}  $*"; }
+log_success() { echo -e "${GREEN}[OK]${NC}    $*"; }
+log_warn()    { echo -e "${YELLOW}[WARN]${NC}  $*"; }
+log_error()   { echo -e "${RED}[ERROR]${NC} $*" >&2; }
+
+# ============ 错误恢复 ============
+# 如果脚本中途失败，自动恢复备份
+restore_on_error() {
+  if [[ -f "$BACKUP_FILE" ]]; then
+    log_warn "脚本异常退出，正在恢复备份配置..."
+    cp "$BACKUP_FILE" "$OPENCLAW_CONFIG"
+    log_warn "已恢复备份: $BACKUP_FILE"
+  fi
+}
+trap restore_on_error ERR
+
+# ============ 前置检查 ============
+echo ""
+echo "============================================================"
+echo "  DingTalk Connector — 切换到 npm 安装"
+echo "============================================================"
+echo ""
+
+if [[ ! -f "$OPENCLAW_CONFIG" ]]; then
+  log_error "找不到 OpenClaw 配置文件: $OPENCLAW_CONFIG"
+  exit 1
+fi
+
+if ! command -v openclaw &>/dev/null; then
+  log_error "找不到 openclaw 命令，请确认已安装 OpenClaw CLI"
+  exit 1
+fi
+
+# ============ 步骤 1：备份配置文件 ============
+log_info "步骤 1/5：备份当前配置文件..."
+cp "$OPENCLAW_CONFIG" "$BACKUP_FILE"
+log_success "备份已保存至: $BACKUP_FILE"
+
+# ============ 步骤 2：写入最小化干净配置 ============
+log_info "步骤 2/5：写入临时干净配置（用于执行插件命令）..."
+
+# 提取当前配置中 plugins 以外的所有字段，保留业务配置结构
+# 同时写入一个空的 plugins 配置，让 openclaw 能正常初始化
+python3 - <<'PYEOF'
+import json, sys, os
+
+config_path = os.path.expanduser("~/.openclaw/openclaw.json")
+
+with open(config_path, "r") as f:
+    original = json.load(f)
+
+# 保留所有非 plugins 字段，plugins 置为空（让 openclaw 重新初始化）
+clean_config = {k: v for k, v in original.items() if k != "plugins"}
+clean_config["plugins"] = {
+    "load": {},
+    "entries": {},
+    "allow": [],
+    "installs": {}
+}
+
+with open(config_path, "w") as f:
+    json.dump(clean_config, f, indent=2)
+
+print("  干净配置写入完成")
+PYEOF
+
+log_success "临时干净配置写入完成"
+
+# ============ 步骤 3：卸载旧插件 ============
+log_info "步骤 3/5：卸载旧版插件 (${PLUGIN_NAME})..."
+if openclaw plugins uninstall "$PLUGIN_NAME" --yes 2>&1 | grep -v "^$"; then
+  log_success "旧插件卸载完成"
+else
+  log_warn "卸载命令返回非零，可能插件本来就未安装，继续执行..."
+fi
+
+# ============ 步骤 4：从 npm 安装最新版插件 ============
+log_info "步骤 4/5：从 npm 安装最新版插件 (${NPM_PACKAGE})..."
+echo ""
+openclaw plugins install "$NPM_PACKAGE"
+echo ""
+log_success "npm 插件安装完成"
+
+# ============ 步骤 5：恢复备份配置（保留业务配置） ============
+log_info "步骤 5/5：将新安装的插件信息合并回原始业务配置..."
+
+python3 - <<'PYEOF'
+import json, os
+
+config_path = os.path.expanduser("~/.openclaw/openclaw.json")
+import glob
+backup_files = sorted(glob.glob(config_path + ".migrate_backup.*"))
+backup_path = backup_files[-1]  # 取最新的备份
+
+with open(config_path, "r") as f:
+    new_config = json.load(f)
+
+with open(backup_path, "r") as f:
+    original_config = json.load(f)
+
+# 策略：以原始业务配置为基础，只替换 plugins.installs 为新安装的结果
+# 这样保留了用户所有的 channels、agents、bindings 等业务配置
+merged = dict(original_config)
+merged["plugins"] = dict(original_config.get("plugins", {}))
+
+# 用新安装的 installs 记录覆盖旧的（包含新的 npm source 信息）
+new_installs = new_config.get("plugins", {}).get("installs", {})
+if new_installs:
+    merged["plugins"]["installs"] = new_installs
+    # 同步更新 entries 和 allow（保留原有的 enabled 状态）
+    for plugin_id in new_installs:
+        if plugin_id not in merged["plugins"].get("entries", {}):
+            merged["plugins"].setdefault("entries", {})[plugin_id] = {"enabled": True}
+        if plugin_id not in merged["plugins"].get("allow", []):
+            merged["plugins"].setdefault("allow", []).append(plugin_id)
+
+with open(config_path, "w") as f:
+    json.dump(merged, f, indent=2)
+
+print(f"  已合并配置，新插件安装信息:")
+for plugin_id, install_info in new_installs.items():
+    print(f"    - {plugin_id}: {install_info.get('spec', 'unknown')} (source: {install_info.get('source', 'unknown')})")
+PYEOF
+
+log_success "配置合并完成"
+
+# ============ 完成 ============
+echo ""
+echo "============================================================"
+log_success "迁移完成！"
+echo ""
+echo "  备份文件: $BACKUP_FILE"
+echo "  如需回滚: cp \"$BACKUP_FILE\" \"$OPENCLAW_CONFIG\""
+echo ""
+echo "  下一步：重启 OpenClaw Gateway 使新插件生效"
+echo "    openclaw gateway --force"
+echo "============================================================"
+echo ""

package/openclaw.plugin.json

@@ -1,7 +1,7 @@
 {
   "id": "dingtalk-connector",
   "name": "DingTalk Channel",
-  "version": "0.8.6",
+  "version": "0.8.8",
   "description": "DingTalk (钉钉) messaging channel via Stream mode with AI Card streaming",
   "author": "DingTalk Real Team",
   "main": "index.ts",