@huo15/dingtalk-connector-pro 1.0.5 → 1.0.12

package/README.en.md

@@ -1,441 +1,168 @@
 <div align="center">
-  <img alt="DingTalk" src="docs/images/dingtalk.svg" width="72" height="72" />
-  <h1>Official DingTalk OpenClaw Connector</h1>
-  <p>Connect DingTalk bots to OpenClaw Gateway with AI Card streaming and session management</p>
-  
-  <p>
-    <a href="README.md">简体中文</a> •
-    <a href="CHANGELOG.md">Changelog</a>
-  </p>
+  <img src="https://tools.huo15.com/uploads/images/system/logo-colours.png" alt="huo15" width="120" />
 </div>
 
----
-
-## 📋 Table of Contents
-
-- [Prerequisites](#prerequisites)
-- [Quick Start](#quick-start)
-- [Features](#features)
-- [Configuration](#configuration)
-- [Troubleshooting](#troubleshooting)
-- [Advanced Topics](#advanced-topics)
-- [DingTalk DEAP Agent Integration](docs/DEAP_AGENT_GUIDE.en.md)
-- [License](#license)
-
----
-
-## Prerequisites
-
-Before you begin, ensure you have:
+<div align="center">
 
-> This connector is used as an OpenClaw Gateway plugin, and you usually don't need to install or manage Node.js runtime by yourself.
+**Breaking Information Silos. Driving Enterprise Growth with One System.**
+**Accelerating Enterprise Users' Transition to Full-Scenario AI Robots.**
 
-### 1. OpenClaw Gateway
+</div>
 
-- **Official Website**: https://openclaw.ai/
-- **Installation**: Follow the official guide to install OpenClaw
-- **Verify installation**:
-  ```bash
-  openclaw gateway status
-  ```
-  Expected output: `✓ Gateway is running on http://127.0.0.1:18789`
+<div align="center">
 
-### 2. DingTalk Enterprise Account
+| 🏫 Institution | 👨‍🏫 Instructor | 📧 Contact | 💬 QQ Group | 📺 Video |
+|:-----------:|:--------:|:------------------:|:-----------:|:-----------------------------------:|
+| Yixunzhiku | Job | support@huo15.com | 1093992108 | [📺 Bilibili](https://space.bilibili.com/400418085) |
 
-- You need a DingTalk enterprise account to create internal applications
-- Official Website: https://www.dingtalk.com/
+</div>
 
 ---
 
-## Quick Start
-
-> 💡 **Goal**: Get your DingTalk bot working in ~5 minutes
-
-### Operating System Support
-
-- macOS / Linux: Use the default shell (zsh, bash, etc.).
-- Windows:
-  - Recommended: **PowerShell** or **Windows Terminal**.
-  - OpenClaw config file path (default): `C:\Users\<YourUserName>\.openclaw\openclaw.json`.
-
-Whenever you see `~/.openclaw/openclaw.json` below, it is equivalent to the above path on Windows.
-
-### Step 1: Install the Plugin
-
-#### Method A: Install via npm (Recommended)
-
-```bash
-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:
-
-```bash
-npm config set registry https://registry.npmmirror.com
-```
+<div align="center">
 
-Or add to `~/.npmrc`:
+# 🔔 @huo15/dingtalk-openclaw-connector
 
-```
-registry=https://registry.npmmirror.com
-```
+**的火一五定制版钉钉 OpenClaw 连接器 | Huo15 Customized DingTalk Connector for OpenClaw**
 
-**Verify installation**:
-```bash
-openclaw plugins list
-```
-You should see `✓ DingTalk Channel (v0.8.6) - loaded`
+> **Author**: 青岛火一五信息科技有限公司 (Huo15 Information Technology)
+> **Version**: v1.0.0
+> **Based on**: [dingtalk-openclaw-connector](https://github.com/DingTalk-Real-AI/dingtalk-openclaw-connector) v0.8.12
+> **npm**: [@huo15/dingtalk-openclaw-connector](https://www.npmjs.com/package/@huo15/dingtalk-openclaw-connector)
+> **Trigger**: 钉钉、钉钉连接器、dingtalk
 
 ---
 
-### Step 2: Create a DingTalk Bot
-
-#### 2.1 Create Application
-
-1. Go to [DingTalk Open Platform](https://open-dev.dingtalk.com/)
-2. Click **"Application Development"**
-
-![Create Application](docs/images/image-1.png)
-
-#### 2.2 Add Bot Capability
-
-1. On the application details page, use the “one-click OpenClaw bot app” flow
+</div>
 
-![Create OpenClaw bot app](docs/images/image-2.png)
+## 一、Introduction | 简介
 
-#### 2.3 Get Credentials
+火一五定制版钉钉 OpenClaw 连接器，基于官方 dingtalk-openclaw-connector v0.8.12 定制，支持 huo15-memory-evolution 记忆系统集成和 Claude Code 能力增强。
 
-1. Finish creation and open **"Credentials & Basic Info"**
-2. Copy your **AppKey** (Client ID)
-3. Copy your **AppSecret** (Client Secret)
+Huo15 customized DingTalk connector for OpenClaw, based on official dingtalk-openclaw-connector v0.8.12, with huo15-memory-evolution integration and Claude Code capability enhancements.
 
-![Finish creation](docs/images/image-3.png)
+---
 
-![Get credentials](docs/images/image-4.png)
+## 二、Core Features | 核心特性
 
-> ⚠️ **Important**: Client ID and Client Secret are your bot’s unique credentials. Store them safely.
+| Feature | Description |
+|---------|-------------|
+| 🤖 **Memory System** | huo15-memory-evolution integration |
+| 💬 **AI Card Streaming** | Typewriter effect with real-time streaming |
+| 🔒 **Session Persistence** | Multi-turn context preservation |
+| 🎯 **Session Isolation** | Separate sessions for DMs / groups |
+| ⏰ **Auto Session Reset** | 30 min inactivity timeout |
+| 📁 **Rich Media** | JPEG/PNG image + file attachments |
+| 🎵 **Audio Messages** | mp3, wav, amr, ogg support |
+| 📄 **DingTalk Docs API** | Create, append, search, list docs |
+| 🔗 **Multi-Agent Routing** | Multiple bots → multiple agents |
 
 ---
 
-### Step 3: Configure OpenClaw
+## 三、Quick Start | 快速开始
 
-You have three options to configure the connector:
+### 3.1 Prerequisites
 
-#### Option A: Configuration Wizard (Recommended for Beginners)
+- OpenClaw Gateway installed and running
+- DingTalk enterprise account
 
-> You can directly copy and paste the following command into your terminal to run the configuration wizard.
+### 3.2 Install
 
 ```bash
-openclaw channels add
-```
+# Clone the fork
+git clone https://github.com/zhaobod1/huo15-dingtalk-openclaw-connector.git
+cd huo15-dingtalk-openclaw-connector
 
-Select **"DingTalk (钉钉)"** and follow the prompts to enter:
-- `clientId` (AppKey)
-- `clientSecret` (AppSecret)
+# Install dependencies
+npm install
+
+# Link mode (dev-friendly, changes take effect immediately)
+openclaw plugins install -l .
+```
 
-#### Option B: Edit Configuration File
+### 3.3 Configure
 
-Edit the configuration file:
+1. Get DingTalk credentials at [DingTalk Open Platform](https://open-dev.dingtalk.com/)
+   - Create an internal app → get **AppKey** and **AppSecret**
 
-- macOS / Linux: `~/.openclaw/openclaw.json`
-- Windows: `C:\Users\<YourUserName>\.openclaw\openclaw.json`
+2. Edit `~/.openclaw/openclaw.json`:
 
 ```json
 {
   "channels": {
     "dingtalk-connector": {
       "enabled": true,
-      "clientId": "dingxxxxxxxxx",
-      "clientSecret": "your_app_secret"
+      "clientId": "yourAppKey",
+      "clientSecret": "yourAppSecret"
     }
   }
 }
 ```
 
-> 💡 **Tip**: If the file already has content, add the `dingtalk-connector` section under the `channels` node.
-
----
-
-### Step 4: Restart and Test
+### 3.4 Restart & Verify
 
 ```bash
-# Restart OpenClaw Gateway
 openclaw gateway restart
-
-# Watch logs in real-time
+openclaw plugins list
 openclaw logs --follow
 ```
 
-**Test your bot**:
-1. Open DingTalk app
-2. Find your bot in the contact list
-3. Send a message: `Hello`
-4. You should receive a response within 10 seconds
-
----
-
-## Features
-
-### ✅ Core Features
-
-- **AI Card Streaming** - Typewriter-like replies with real-time streaming
-- **Session Management** - Multi-turn conversations with context preservation
-- **Session Isolation** - Separate sessions for DMs, groups, and different groups
-- **Auto Session Reset** - Automatic new session after 30 minutes of inactivity
-- **Manual Session Reset** - Send `/new` or `新会话` to clear conversation history
-- **Image Auto-Upload** - Local image paths automatically uploaded to DingTalk
-- **Proactive Messaging** - Send messages to users or groups programmatically
-- **Rich Media Reception** - Receive and process JPEG/PNG images, pass to vision models
-- **File Attachment Extraction** - Parse .docx, .pdf, text files, and binary files
-- **Audio Message Support** - Send audio messages in multiple formats (mp3, wav, amr, ogg)
-- **DingTalk Docs API** - Create, append, search, and list DingTalk documents
-- **Multi-Agent Routing** - Connect multiple bots to different agents for specialized services
-- **Markdown Table Conversion** - Auto-convert Markdown tables to DingTalk-compatible format
-- **Async Mode** - Immediate acknowledgment with background processing (optional)
-
 ---
 
-## Configuration
-
-### Basic Configuration
-
-| Option | Environment Variable | Description |
-|--------|---------------------|-------------|
-| `clientId` | — | DingTalk AppKey |
-| `clientSecret` | — | DingTalk AppSecret |
-
-### Session Management
-
-| Option | Default | Description |
-|--------|---------|-------------|
-| `separateSessionByConversation` | `true` | Separate sessions for DMs/groups |
-| `groupSessionScope` | `group` | Group session scope: `group` (shared) or `group_sender` (per-user) |
-| `sharedMemoryAcrossConversations` | `false` | Share memory across different conversations |
-
-### Session routing policies (`pmpolicy` / `groupPolicy`)
-
-Both session routing/message policy options (including `pmpolicy` and `groupPolicy`) are supported now, so you **do not need to remove** them from existing configurations.
+## 四、Features | 功能列表
 
-> Note: field names may vary across versions/upstream; on the connector side, related policies are supported and applied (for example, `dmPolicy`/`groupPolicy` default to `open`).
+### 4.1 Basic Features
 
-### Async Mode
-
-| Option | Default | Description |
-|--------|---------|-------------|
-| `asyncMode` | `false` | Enable async mode for long-running tasks |
-| `ackText` | `🫡 任务已接收，处理中...` | Acknowledgment message text |
+- **AI Card Streaming** — Real-time typewriter replies
+- **Session Management** — Multi-turn context
+- **Session Isolation** — DMs / groups / group_sender per user
+- **Auto Session Reset** — `/new` or 30 min inactivity
+- **Image Auto-Upload** — Local images → DingTalk CDN
+- **Rich Media Reception** — JPEG/PNG → vision models
+- **File Attachments** — .docx, .pdf, text, binary
+- **Audio Messages** — mp3, wav, amr, ogg
+- **DingTalk Docs API** — Create, append, search, list
+- **Multi-Agent Routing** — Multiple bots → multiple agents
+- **Markdown Tables** — Auto-convert to DingTalk format
 
 ---
 
-## Troubleshooting
-
-### Bot Not Responding
-
-**Symptoms**: Bot doesn't reply to messages
-
-**Solutions**:
-1. Check plugin status: `openclaw plugins list`
-2. Check gateway status: `openclaw gateway status`
-3. Check logs: `openclaw logs --follow`
-4. Verify the app is published/enabled in DingTalk Open Platform
+## 五、Development Roadmap | 开发计划
 
----
+### 5.1 Huo15 Memory Evolution Integration
 
-### HTTP 401 Error
+- [ ] Integrate huo15-memory-evolution
+- [ ] Session memory persistence
+- [ ] user / feedback / project / reference memory types
+- [ ] Auto Capture for highlights
+- [ ] Dream Agent daily log summarization
 
-**Symptoms**: Error message shows "401 Unauthorized"
+### 5.2 Claude Code Capability Integration
 
-**Solution**: Upgrade to the latest version.
+- [ ] findRelevantMemories smart retrieval
+- [ ] CLAUDE.md project-level injection
+- [ ] Manifest pre-inject
+- [ ] Forked extraction
+- [ ] Before recommending rules
 
 ---
 
-### Stream Connection 400 Error
-
-**Symptoms**: Logs show "Request failed with status code 400"
-
-**Common Causes**:
-
-| Cause | Solution |
-|-------|----------|
-| App not published | DingTalk Open Platform → Version Management → Publish |
-| Invalid credentials | Check `clientId`/`clientSecret` for typos or extra spaces |
-| Not Stream mode | Verify bot is configured for Stream mode (not Webhook) |
-| IP whitelist | Check if the app has IP whitelist restrictions |
+## 六、Comparison with Official | 与官方版对比
 
-**Verification Steps**:
-1. Check app status in [DingTalk Open Platform](https://open-dev.dingtalk.com/)
-2. After any configuration change, click **Save** → **Publish**
+| Feature | Official | Huo15 Custom |
+|---------|----------|-------------|
+| Basic features | ✅ | ✅ |
+| Memory system integration | ❌ | ✅ huo15-memory-evolution |
+| Claude Code capability | ❌ | ✅ WIP |
+| AI Card streaming | ✅ | ✅ |
+| Multi-agent routing | ✅ | ✅ |
 
 ---
 
-## Advanced Topics
+## 七、Project Structure | 项目结构
 
-### Multi-Agent Configuration
-
-Configure multiple bots connected to different agents:
-
-```json5
-{
-  "agents": {
-    "list": [
-      {
-        "id": "ding-bot1",
-        "name": "Customer Service Bot",
-        "model": "your-model-config",
-        "workspace": "~/.openclaw/workspace-bot1",
-        "identity": {
-          "name": "Service Assistant",
-          "theme": "customer service",
-          "emoji": "🤝"
-        }
-        // Other agent configurations...
-      },
-      {
-        "id": "ding-bot2",
-        "name": "Technical Support Bot",
-        "model": "your-model-config",
-        "workspace": "~/.openclaw/workspace-bot2",
-        "identity": {
-          "name": "Tech Expert",
-          "theme": "technical support",
-          "emoji": "🔧"
-        }
-        // Other agent configurations...
-      }
-    ]
-  },
-  "channels": {
-    "dingtalk-connector": {
-      "enabled": true,
-      "accounts": {
-        "bot1": {
-          "enabled": true,
-          "clientId": "ding_bot1_app_key",
-          "clientSecret": "bot1_secret"
-        },
-        "bot2": {
-          "enabled": true,
-          "clientId": "ding_bot2_app_key",
-          "clientSecret": "bot2_secret"
-        }
-      }
-    }
-  },
-  "bindings": [
-    {
-      "agentId": "ding-bot1",
-      "match": {
-        "channel": "dingtalk-connector",
-        "accountId": "bot1"
-      }
-    },
-    {
-      "agentId": "ding-bot2",
-      "match": {
-        "channel": "dingtalk-connector",
-        "accountId": "bot2"
-      }
-    }
-  ]
-}
-```
-
-For more details, see [OpenClaw Multi-Agent Configuration Guide](https://gist.github.com/smallnest/c5c13482740fd179e40070e620f66a52).
-
----
-
-### Session Commands
-
-Users can send the following commands to start a fresh session:
-
-- `/new`, `/reset`, `/clear`
-- `新会话`, `重新开始`, `清空对话`
-
----
-
-### DingTalk Docs via MCP (`docs.*`)
-
-DingTalk Docs capabilities (`docs.*`, including `docs.create` / `docs.append` / `docs.search` / `docs.list` / `docs.read`) require MCP (Model Context Protocol) to provide the underlying tools. To enable `docs.*`, install and enable the corresponding MCP Server/Tool in the OpenClaw Gateway/Agent.
-
-- **Where to get MCP Server/Tool**: via the [DingTalk MCP Marketplace](https://mcp.dingtalk.com/) (or your team’s internal MCP marketplace). You can also use a third-party marketplace to source an equivalent “DingTalk Docs Read / DingTalk Docs Reader” capability and connect it to OpenClaw.
-- **Where to configure**: usually at the **Gateway or Agent tool configuration** level (not in this connector).
-- **How it takes effect**: restart the Gateway and ensure the tool is exposed to the target agent.
-
-References (OpenClaw configuration docs):
-- `https://docs.openclaw.ai/configuration`
-- `https://docs.openclaw.ai/gateway/configuration-reference`
-
-Create and manage DingTalk documents from your agent:
-
-```javascript
-// Create document
-dingtalk-connector.docs.create({
-  spaceId: "your-space-id",
-  title: "Test Document",
-  content: "# Test Content"
-})
-
-// Append content
-dingtalk-connector.docs.append({
-  docId: "your-doc-id",
-  markdownContent: "\n## Appended Content"
-})
-
-// Search documents
-dingtalk-connector.docs.search({
-  keyword: "search keyword"
-})
-
-// List documents
-dingtalk-connector.docs.list({
-  spaceId: "your-space-id"
-})
 ```
-
----
-
-## Project Structure
-
-```
-dingtalk-openclaw-connector/
+huo15-dingtalk-openclaw-connector/
 ├── src/
 │   ├── core/           # Core connector logic
 │   ├── services/       # DingTalk API services
@@ -444,36 +171,31 @@ dingtalk-openclaw-connector/
 ├── docs/
 │   └── images/         # Documentation images
 ├── openclaw.plugin.json # Plugin manifest
-├── package.json        # npm dependencies
+├── package.json         # npm dependencies
 └── LICENSE
 ```
 
 ---
 
-## Dependencies
+## 八、Related Links | 相关链接
 
-| Package | Purpose |
-|---------|---------|
-| `dingtalk-stream` | DingTalk Stream protocol client |
-| `axios` | HTTP client |
-| `mammoth` | Word document (.docx) parsing |
-| `pdf-parse` | PDF document parsing |
+- **Official**: https://github.com/DingTalk-Real-AI/dingtalk-openclaw-connector
+- **Fork**: https://github.com/zhaobod1/huo15-dingtalk-openclaw-connector
+- **OpenClaw**: https://openclaw.ai
+- **Huo15 Memory**: https://clawhub.ai/jobzhao15/huo15-memory-evolution
+- **DingTalk Platform**: https://open-dev.dingtalk.com/
 
 ---
 
-## DingTalk DEAP Agent Integration
+<div align="center">
 
-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.
+**Company**: 青岛火一五信息科技有限公司 (Huo15 Information Technology)
+**Email**: postmaster@huo15.com | **QQ**: 1093992108
 
 ---
 
-## License
+**Follow Yixunzhiku for more updates**
 
-[MIT](LICENSE)
+<img src="https://tools.huo15.com/uploads/images/system/qrcode_yxzk.jpg" alt="Yixunzhiku QRCode" width="200" />
 
----
-
-## Support
-
-- **Issues**: [GitHub Issues](https://github.com/DingTalk-Real-AI/dingtalk-openclaw-connector/issues)
-- **Changelog**: [CHANGELOG.md](CHANGELOG.md)
+</div>

package/README.md

@@ -1,3 +1,7 @@
+# @huo15/dingtalk-openclaw-connector
+
+---
+
 <div align="center">
 
 <img src="https://tools.huo15.com/uploads/images/system/logo-colours.png" alt="火一五Logo" style="width: 120px; height: auto; display: inline; margin: 0;" />
@@ -21,11 +25,10 @@
 
 ---
 
-# 🔔 huo15-dingtalk-connector-pro
-
 > **作者**: 火一五信息科技有限公司
 > **版本**: v1.0.0
 > **参考**: [dingtalk-openclaw-connector](https://github.com/DingTalk-Real-AI/dingtalk-openclaw-connector) v0.8.12
+> **npm**: [@huo15/dingtalk-openclaw-connector](https://www.npmjs.com/package/@huo15/dingtalk-openclaw-connector)
 > **触发词**: 钉钉、钉钉连接器、dingtalk
 
 ---
@@ -63,13 +66,13 @@
 
 ```bash
 # 克隆仓库
-git clone https://github.com/huo15/huo15-dingtalk-connector-pro.git
-cd huo15-dingtalk-connector-pro
+git clone https://github.com/zhaobod1/huo15-dingtalk-openclaw-connector.git
+cd huo15-dingtalk-openclaw-connector
 
 # 安装依赖
 npm install
 
-# 以链接模式安装
+# 以链接模式安装（方便开发调试）
 openclaw plugins install -l .
 ```
 
@@ -80,15 +83,7 @@ openclaw plugins install -l .
    - 创建企业内部应用
    - 获取 AppKey 和 AppSecret
 
-2. 配置连接器
-
-```bash
-# 方式一：使用配置向导
-openclaw channels add
-
-# 方式二：直接编辑配置文件
-# macOS: ~/.openclaw/openclaw.json
-```
+2. 配置连接器（编辑 `~/.openclaw/openclaw.json`）
 
 ```json
 {
@@ -170,16 +165,16 @@ openclaw logs --follow
 ## 七、项目结构
 
 ```
-huo15-dingtalk-connector-pro/
+huo15-dingtalk-openclaw-connector/
 ├── src/
 │   ├── core/           # 核心连接器逻辑
 │   ├── services/       # 钉钉 API 服务
-│   ├── utils/         # 工具函数
+│   ├── utils/          # 工具函数
 │   └── types/          # TypeScript 类型定义
 ├── docs/
-│   └── images/        # 文档图片
+│   └── images/         # 文档图片
 ├── openclaw.plugin.json # 插件清单
-├── package.json        # npm 依赖
+├── package.json         # npm 依赖
 └── LICENSE
 ```
 
@@ -188,6 +183,7 @@ huo15-dingtalk-connector-pro/
 ## 八、相关链接
 
 - **官方版**: https://github.com/DingTalk-Real-AI/dingtalk-openclaw-connector
+- **Fork 仓库**: https://github.com/zhaobod1/huo15-dingtalk-openclaw-connector
 - **OpenClaw**: https://openclaw.ai
 - **火一五记忆系统**: https://clawhub.ai/jobzhao15/huo15-memory-evolution
 - **钉钉开放平台**: https://open-dev.dingtalk.com/