moltbot-dingtalk-stream 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,61 @@
+# DingTalk Channel for Moltbot
+
+A Moltbot channel plugin for DingTalk (钉钉) using **Stream Mode** for seamless integration.
+
+## Features
+
+- **Stream Mode**: Uses WebSocket for receiving messages (no public IP required)
+- **Zero Configuration**: No webhook setup, ngrok, or firewall configuration needed
+- **Single/Group Chat**: Supports both direct messages and group mentions
+- **Easy Setup**: Just configure your DingTalk app credentials
+
+## Proactive Messaging (CLI)
+
+You can send messages to DingTalk conversations using the Clawdbot CLI. You need the `conversationId` (which you can find in the logs when a message is received).
+
+```bash
+clawdbot send --channel dingtalk --to <conversationId> "Hello from CLI"
+```
+
+## Troubleshooting
+
+- **Logs**: Check `~/.clawdbot/logs/gateway.log` for debug information.
+- **Connection**: Ensure your server has outbound internet access to DingTalk servers.
+- **Permissions**: Verify your DingTalk app has the necessary robot permissions.
+
+## Quick Start
+
+1. Install the plugin:
+   ```bash
+   npm install moltbot-dingtalk-stream
+   ```
+
+2. Configure in your moltbot config:
+   ```json
+   {
+     "channels": {
+       "dingtalk": {
+         "accounts": {
+           "default": {
+             "enabled": true,
+             "clientId": "YOUR_APP_KEY",
+             "clientSecret": "YOUR_APP_SECRET"
+           }
+         }
+       }
+     }
+   }
+   ```
+
+3. Set up your DingTalk app:
+   - Create an enterprise internal app at [DingTalk Developer Console](https://open.dingtalk.com/)
+   - Add Robot capability with **Stream Mode** enabled
+   - Use the AppKey as `clientId` and AppSecret as `clientSecret`
+
+## Documentation
+
+See [DEVELOPMENT.md](./DEVELOPMENT.md) for detailed setup and configuration.
+
+## License
+
+MIT

package/dist/clawdbot.plugin.json

@@ -0,0 +1,19 @@
+{
+    "id": "dingtalk-channel",
+    "name": "DingTalk Channel",
+    "version": "2.0.0",
+    "description": "Custom channel for integrating Clawdbot with DingTalk (Stream Mode)",
+    "author": "Your Name",
+    "license": "MIT",
+    "extensions": [
+        "./index.js"
+    ],
+    "channels": [
+        "dingtalk"
+    ],
+    "configSchema": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {}
+    }
+}

package/dist/index.d.ts

@@ -0,0 +1,39 @@
+interface ClawdbotPluginApi {
+    config: ClawdbotConfig;
+    logger: any;
+    runtime: any;
+    postMessage(params: any): Promise<void>;
+    registerChannel(opts: {
+        plugin: any;
+    }): void;
+    registerService(service: any): void;
+}
+interface ClawdbotConfig {
+    channels?: {
+        dingtalk?: {
+            accounts?: {
+                [key: string]: DingTalkAccountConfig;
+            };
+        };
+        [key: string]: any;
+    };
+}
+interface DingTalkAccountConfig {
+    enabled?: boolean;
+    clientId: string;
+    clientSecret: string;
+    webhookUrl?: string;
+    name?: string;
+}
+declare const plugin: {
+    id: string;
+    name: string;
+    description: string;
+    configSchema: {
+        type: "object";
+        properties: {};
+    };
+    register(api: ClawdbotPluginApi): void;
+};
+export default plugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,UAAU,iBAAiB;IACzB,MAAM,EAAE,cAAc,CAAC;IACvB,MAAM,EAAE,GAAG,CAAC;IACZ,OAAO,EAAE,GAAG,CAAC;IACb,WAAW,CAAC,MAAM,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,eAAe,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,GAAG,CAAA;KAAE,GAAG,IAAI,CAAC;IAC7C,eAAe,CAAC,OAAO,EAAE,GAAG,GAAG,IAAI,CAAC;CACrC;AAED,UAAU,cAAc;IACtB,QAAQ,CAAC,EAAE;QACT,QAAQ,CAAC,EAAE;YACT,QAAQ,CAAC,EAAE;gBACT,CAAC,GAAG,EAAE,MAAM,GAAG,qBAAqB,CAAC;aACtC,CAAC;SACH,CAAC;QACF,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KACpB,CAAC;CACH;AAED,UAAU,qBAAqB;IAC7B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAwUD,QAAA,MAAM,MAAM;;;;;;;;kBAQI,iBAAiB;CAIhC,CAAC;AAEF,eAAe,MAAM,CAAC"}

package/dist/index.js

@@ -0,0 +1,293 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const dingtalk_stream_1 = require("dingtalk-stream");
+const axios_1 = __importDefault(require("axios"));
+// Store plugin runtime
+let pluginRuntime = null;
+// Store session webhooks for reply
+const sessionWebhooks = new Map();
+// Store active clients for each account
+const activeClients = new Map();
+// Helper functions
+function listDingTalkAccountIds(cfg) {
+    const accounts = cfg.channels?.dingtalk?.accounts;
+    return accounts ? Object.keys(accounts) : [];
+}
+function resolveDingTalkAccount(opts) {
+    const { cfg, accountId = 'default' } = opts;
+    const account = cfg.channels?.dingtalk?.accounts?.[accountId];
+    return {
+        accountId,
+        name: account?.name,
+        enabled: account?.enabled ?? false,
+        configured: Boolean(account?.clientId && account?.clientSecret),
+        config: account || { clientId: '', clientSecret: '' }
+    };
+}
+// DingTalk Channel Plugin
+const dingTalkChannelPlugin = {
+    id: "dingtalk",
+    meta: {
+        id: "dingtalk",
+        label: "钉钉",
+        selectionLabel: "DingTalk Bot (Stream)",
+        docsPath: "/channels/dingtalk",
+        docsLabel: "dingtalk",
+        blurb: "钉钉机器人通道插件 (Stream模式)",
+        order: 100,
+        aliases: ["dt", "ding"],
+    },
+    capabilities: {
+        chatTypes: ["direct", "group"],
+    },
+    reload: { configPrefixes: ["channels.dingtalk"] },
+    configSchema: {
+        type: "object",
+        properties: {
+            channels: {
+                type: "object",
+                properties: {
+                    dingtalk: {
+                        type: "object",
+                        properties: {
+                            accounts: {
+                                type: "object",
+                                additionalProperties: {
+                                    type: "object",
+                                    properties: {
+                                        enabled: { type: "boolean" },
+                                        clientId: { type: "string" },
+                                        clientSecret: { type: "string" },
+                                        webhookUrl: { type: "string" },
+                                        name: { type: "string" },
+                                    },
+                                    required: ["clientId", "clientSecret"],
+                                },
+                            },
+                        },
+                    },
+                },
+            },
+        },
+    },
+    config: {
+        listAccountIds: (cfg) => listDingTalkAccountIds(cfg),
+        resolveAccount: (cfg, accountId) => resolveDingTalkAccount({ cfg, accountId }),
+        defaultAccountId: (_cfg) => 'default',
+        isConfigured: (account) => account.configured,
+        describeAccount: (account) => ({
+            accountId: account.accountId,
+            name: account.name,
+            enabled: account.enabled,
+            configured: account.configured,
+        }),
+    },
+    gateway: {
+        startAccount: async (ctx) => {
+            const account = ctx.account;
+            const config = account.config;
+            const accountId = account.accountId;
+            if (!config.clientId || !config.clientSecret) {
+                ctx.log?.warn?.(`[${accountId}] missing clientId or clientSecret`);
+                return;
+            }
+            ctx.log?.info?.(`[${accountId}] starting DingTalk Stream client`);
+            try {
+                const client = new dingtalk_stream_1.DWClient({
+                    clientId: config.clientId,
+                    clientSecret: config.clientSecret,
+                });
+                // Helper to safely handle messages
+                const handleMessage = async (res) => {
+                    try {
+                        const message = JSON.parse(res.data);
+                        const textContent = message.text?.content || "";
+                        const senderId = message.senderId;
+                        const convoId = message.conversationId;
+                        const msgId = message.msgId;
+                        // Store session webhook if provided (DingTalk Stream mode provides this for replies)
+                        if (message.sessionWebhook) {
+                            sessionWebhooks.set(convoId, message.sessionWebhook);
+                        }
+                        // Log reception
+                        ctx.log?.info?.(`[${accountId}] received message from ${message.senderNick || senderId}: ${textContent}`);
+                        // Filter out empty messages
+                        if (!textContent)
+                            return;
+                        // Simple text cleaning (remove @bot mentions if possible, though DingTalk usually gives clean content or we might need to parse entities)
+                        const cleanedText = textContent.replace(/@\w+\s*/g, '').trim();
+                        // Forward the message to Clawdbot for processing
+                        if (pluginRuntime?.runtime?.channel?.reply) {
+                            const replyModule = pluginRuntime.runtime.channel.reply;
+                            const chatType = String(message.conversationType) === '2' ? 'group' : 'direct';
+                            const fromAddress = chatType === 'group' ? `dingtalk:group:${convoId}` : `dingtalk:${senderId}`;
+                            const ctxPayload = {
+                                Body: cleanedText,
+                                RawBody: textContent,
+                                CommandBody: cleanedText,
+                                From: fromAddress,
+                                To: 'bot',
+                                SessionKey: `dingtalk:${convoId}`,
+                                AccountId: accountId,
+                                ChatType: chatType,
+                                SenderName: message.senderNick,
+                                SenderId: senderId,
+                                Provider: 'dingtalk',
+                                Surface: 'dingtalk',
+                                MessageSid: message.msgId,
+                                Timestamp: message.createAt,
+                                // Required for some logic
+                                GroupSubject: chatType === 'group' ? (message.conversationId) : undefined,
+                            };
+                            const finalizedCtx = replyModule.finalizeInboundContext(ctxPayload);
+                            let replyBuffer = "";
+                            let replySent = false;
+                            const sendToDingTalk = async (text) => {
+                                if (!text)
+                                    return;
+                                if (replySent) {
+                                    ctx.log?.info?.(`[${accountId}] Reply already sent, skipping buffer flush.`);
+                                    return;
+                                }
+                                const replyWebhook = sessionWebhooks.get(convoId) || config.webhookUrl;
+                                if (!replyWebhook) {
+                                    ctx.log?.error?.(`[${accountId}] No webhook to reply to ${convoId}`);
+                                    return;
+                                }
+                                try {
+                                    await axios_1.default.post(replyWebhook, {
+                                        msgtype: "text",
+                                        text: { content: text }
+                                    }, { headers: { 'Content-Type': 'application/json' } });
+                                    replySent = true;
+                                    ctx.log?.info?.(`[${accountId}] Reply sent successfully.`);
+                                }
+                                catch (e) {
+                                    ctx.log?.error?.(`[${accountId}] Failed to send reply: ${e}`);
+                                }
+                            };
+                            const dispatcher = {
+                                sendFinalReply: (payload) => {
+                                    const text = payload.text || payload.content || '';
+                                    sendToDingTalk(text).catch(e => ctx.log?.error?.(`[${accountId}] sendToDingTalk failed: ${e}`));
+                                    return true;
+                                },
+                                typing: async () => { },
+                                reaction: async () => { },
+                                isSynchronous: () => false,
+                                waitForIdle: async () => { },
+                                sendBlockReply: async (block) => {
+                                    // Accumulate text from blocks
+                                    const text = block.text || block.delta || block.content || '';
+                                    if (text) {
+                                        replyBuffer += text;
+                                    }
+                                },
+                                getQueuedCounts: () => ({ active: 0, queued: 0, final: 0 })
+                            };
+                            // Internal dispatch
+                            const dispatchPromise = replyModule.dispatchReplyFromConfig({
+                                ctx: finalizedCtx,
+                                cfg: pluginRuntime.config,
+                                dispatcher: dispatcher,
+                                replyOptions: {}
+                            });
+                            // ACK immediately to prevent retries
+                            if (res.headers && res.headers.messageId) {
+                                client.socketCallBackResponse(res.headers.messageId, { status: "SUCCEED" });
+                            }
+                            // Wait for run to finish
+                            await dispatchPromise;
+                            // If final reply wasn't called but we have buffer (streaming case where agent didn't return final payload?)
+                            if (!replySent && replyBuffer) {
+                                ctx.log?.info?.(`[${accountId}] Sending accumulated buffer from blocks (len=${replyBuffer.length}).`);
+                                await sendToDingTalk(replyBuffer);
+                            }
+                        }
+                        else {
+                            ctx.log?.error?.(`[${accountId}] runtime.channel.reply not available`);
+                        }
+                    }
+                    catch (error) {
+                        ctx.log?.error?.(`[${accountId}] error processing message: ${error instanceof Error ? error.message : String(error)}`);
+                        console.error('DingTalk Handler Error:', error);
+                    }
+                };
+                // Register callback for robot messages
+                client.registerCallbackListener('/v1.0/im/bot/messages/get', handleMessage);
+                // Connect to DingTalk Stream
+                await client.connect();
+                activeClients.set(accountId, client);
+                ctx.log?.info?.(`[${accountId}] DingTalk Stream client connected`);
+                // Handle abort signal for cleanup
+                ctx.abortSignal?.addEventListener('abort', () => {
+                    ctx.log?.info?.(`[${accountId}] stopping DingTalk Stream client`);
+                    client.disconnect();
+                    activeClients.delete(accountId);
+                });
+            }
+            catch (error) {
+                ctx.log?.error?.(`[${accountId}] failed to start: ${error instanceof Error ? error.message : String(error)}`);
+                throw error;
+            }
+        },
+    },
+    outbound: {
+        deliveryMode: "direct",
+        sendText: async (opts) => {
+            const { text, account, target } = opts;
+            const config = account.config;
+            // Try session webhook first (for replies)
+            const sessionWebhook = sessionWebhooks.get(target);
+            if (sessionWebhook) {
+                try {
+                    await axios_1.default.post(sessionWebhook, {
+                        msgtype: "text",
+                        text: { content: text }
+                    }, {
+                        headers: { 'Content-Type': 'application/json' }
+                    });
+                    return { ok: true };
+                }
+                catch (error) {
+                    // Fall through to webhookUrl
+                }
+            }
+            // Fallback to webhookUrl for proactive messages
+            if (config?.webhookUrl) {
+                try {
+                    await axios_1.default.post(config.webhookUrl, {
+                        msgtype: "text",
+                        text: { content: text }
+                    }, {
+                        headers: { 'Content-Type': 'application/json' }
+                    });
+                    return { ok: true };
+                }
+                catch (error) {
+                    return { ok: false, error: error instanceof Error ? error.message : String(error) };
+                }
+            }
+            return { ok: false, error: "No webhook available for sending messages" };
+        }
+    }
+};
+// Plugin object format required by Clawdbot
+const plugin = {
+    id: "dingtalk-channel",
+    name: "DingTalk Channel",
+    description: "DingTalk channel plugin using Stream mode",
+    configSchema: {
+        type: "object",
+        properties: {}
+    },
+    register(api) {
+        pluginRuntime = api;
+        api.registerChannel({ plugin: dingTalkChannelPlugin });
+    }
+};
+exports.default = plugin;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/package.json

@@ -0,0 +1,11 @@
+{
+    "name": "moltbot-dingtalk-stream",
+    "version": "1.0.1",
+    "description": "DingTalk channel plugin for Clawdbot (Stream Mode)",
+    "main": "index.js",
+    "clawdbot": {
+        "extensions": [
+            "./index.js"
+        ]
+    }
+}

package/local-test-config.json

@@ -0,0 +1,21 @@
+{
+  "channels": {
+    "dingtalk": {
+      "accounts": {
+        "local_test": {
+          "enabled": true,
+          "clientId": "YOUR_APP_KEY_HERE",
+          "clientSecret": "YOUR_APP_SECRET_HERE",
+          "webhookUrl": ""
+        }
+      }
+    }
+  },
+  "plugins": {
+    "entries": {
+      "dingtalk-channel": {
+        "path": "./dist/index.js"
+      }
+    }
+  }
+}

package/moltbot.plugin.json

@@ -0,0 +1,56 @@
+{
+  "id": "dingtalk-channel",
+  "name": "DingTalk Channel",
+  "version": "2.0.0",
+  "description": "Custom channel for integrating Moltbot with DingTalk (Stream Mode)",
+  "author": "Your Name",
+  "license": "MIT",
+  "extensions": {
+    "channels": [
+      "./dist/index.js"
+    ]
+  },
+  "configSchema": {
+    "type": "object",
+    "properties": {
+      "channels": {
+        "type": "object",
+        "properties": {
+          "dingtalk": {
+            "type": "object",
+            "properties": {
+              "accounts": {
+                "type": "object",
+                "additionalProperties": {
+                  "type": "object",
+                  "properties": {
+                    "enabled": {
+                      "type": "boolean",
+                      "description": "Whether this account is enabled"
+                    },
+                    "clientId": {
+                      "type": "string",
+                      "description": "AppKey from DingTalk developer console"
+                    },
+                    "clientSecret": {
+                      "type": "string",
+                      "description": "AppSecret from DingTalk developer console"
+                    },
+                    "webhookUrl": {
+                      "type": "string",
+                      "description": "Optional webhook URL for proactive messages"
+                    }
+                  },
+                  "required": [
+                    "clientId",
+                    "clientSecret"
+                  ]
+                }
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "moltbot-dingtalk-stream",
+  "version": "1.0.1",
+  "description": "DingTalk custom channel plugin for Moltbot/Clawdbot",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "moltbot",
+    "clawdbot",
+    "plugin",
+    "dingtalk",
+    "channel",
+    "chatbot"
+  ],
+  "author": "Your Name",
+  "license": "MIT",
+  "dependencies": {
+    "axios": "^1.6.0",
+    "dingtalk-stream": "^2.1.4"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.0.0"
+  },
+  "clawdbot": {
+    "extensions": {
+      "channels": [
+        "./dist/index.js"
+      ]
+    }
+  }
+}

package/src/index.ts

@@ -0,0 +1,373 @@
+import { DWClient, DWClientDownStream } from 'dingtalk-stream';
+import axios from 'axios';
+
+// Define interfaces
+interface ClawdbotPluginApi {
+  config: ClawdbotConfig;
+  logger: any;
+  runtime: any;
+  postMessage(params: any): Promise<void>;
+  registerChannel(opts: { plugin: any }): void;
+  registerService(service: any): void;
+}
+
+interface ClawdbotConfig {
+  channels?: {
+    dingtalk?: {
+      accounts?: {
+        [key: string]: DingTalkAccountConfig;
+      };
+    };
+    [key: string]: any;
+  };
+}
+
+interface DingTalkAccountConfig {
+  enabled?: boolean;
+  clientId: string;
+  clientSecret: string;
+  webhookUrl?: string;
+  name?: string;
+}
+
+interface ResolvedDingTalkAccount {
+  accountId: string;
+  name?: string;
+  enabled: boolean;
+  configured: boolean;
+  config: DingTalkAccountConfig;
+}
+
+interface DingTalkRobotMessage {
+  conversationId: string;
+  chatbotCorpId: string;
+  chatbotUserId: string;
+  msgId: string;
+  senderNick: string;
+  isAdmin: boolean;
+  senderStaffId?: string;
+  sessionWebhook: string;
+  sessionWebhookExpiredTime: number;
+  createAt: number;
+  senderCorpId?: string;
+  conversationType: '1' | '2';
+  senderId: string;
+  text?: {
+    content: string;
+  };
+  msgtype: string;
+}
+
+// Store plugin runtime
+let pluginRuntime: ClawdbotPluginApi | null = null;
+
+// Store session webhooks for reply
+const sessionWebhooks: Map<string, string> = new Map();
+// Store active clients for each account
+const activeClients: Map<string, DWClient> = new Map();
+
+// Helper functions
+function listDingTalkAccountIds(cfg: ClawdbotConfig): string[] {
+  const accounts = cfg.channels?.dingtalk?.accounts;
+  return accounts ? Object.keys(accounts) : [];
+}
+
+function resolveDingTalkAccount(opts: { cfg: ClawdbotConfig; accountId?: string }): ResolvedDingTalkAccount {
+  const { cfg, accountId = 'default' } = opts;
+  const account = cfg.channels?.dingtalk?.accounts?.[accountId];
+  return {
+    accountId,
+    name: account?.name,
+    enabled: account?.enabled ?? false,
+    configured: Boolean(account?.clientId && account?.clientSecret),
+    config: account || { clientId: '', clientSecret: '' }
+  };
+}
+
+// DingTalk Channel Plugin
+const dingTalkChannelPlugin = {
+  id: "dingtalk",
+  meta: {
+    id: "dingtalk",
+    label: "钉钉",
+    selectionLabel: "DingTalk Bot (Stream)",
+    docsPath: "/channels/dingtalk",
+    docsLabel: "dingtalk",
+    blurb: "钉钉机器人通道插件 (Stream模式)",
+    order: 100,
+    aliases: ["dt", "ding"],
+  },
+  capabilities: {
+    chatTypes: ["direct", "group"] as const,
+  },
+  reload: { configPrefixes: ["channels.dingtalk"] },
+  configSchema: {
+    type: "object" as const,
+    properties: {
+      channels: {
+        type: "object" as const,
+        properties: {
+          dingtalk: {
+            type: "object" as const,
+            properties: {
+              accounts: {
+                type: "object" as const,
+                additionalProperties: {
+                  type: "object" as const,
+                  properties: {
+                    enabled: { type: "boolean" as const },
+                    clientId: { type: "string" as const },
+                    clientSecret: { type: "string" as const },
+                    webhookUrl: { type: "string" as const },
+                    name: { type: "string" as const },
+                  },
+                  required: ["clientId", "clientSecret"],
+                },
+              },
+            },
+          },
+        },
+      },
+    },
+  },
+  config: {
+    listAccountIds: (cfg: ClawdbotConfig) => listDingTalkAccountIds(cfg),
+    resolveAccount: (cfg: ClawdbotConfig, accountId?: string) => resolveDingTalkAccount({ cfg, accountId }),
+    defaultAccountId: (_cfg: ClawdbotConfig) => 'default',
+    isConfigured: (account: ResolvedDingTalkAccount) => account.configured,
+    describeAccount: (account: ResolvedDingTalkAccount) => ({
+      accountId: account.accountId,
+      name: account.name,
+      enabled: account.enabled,
+      configured: account.configured,
+    }),
+  },
+  gateway: {
+    startAccount: async (ctx: any) => {
+      const account: ResolvedDingTalkAccount = ctx.account;
+      const config = account.config;
+      const accountId = account.accountId;
+
+      if (!config.clientId || !config.clientSecret) {
+        ctx.log?.warn?.(`[${accountId}] missing clientId or clientSecret`);
+        return;
+      }
+
+      ctx.log?.info?.(`[${accountId}] starting DingTalk Stream client`);
+
+      try {
+        const client = new DWClient({
+          clientId: config.clientId,
+          clientSecret: config.clientSecret,
+        });
+
+        // Helper to safely handle messages
+        const handleMessage = async (res: any) => {
+          try {
+            const message = JSON.parse(res.data);
+            const textContent = message.text?.content || "";
+            const senderId = message.senderId;
+            const convoId = message.conversationId;
+            const msgId = message.msgId;
+            // Store session webhook if provided (DingTalk Stream mode provides this for replies)
+            if (message.sessionWebhook) {
+              sessionWebhooks.set(convoId, message.sessionWebhook);
+            }
+
+            // Log reception
+            ctx.log?.info?.(`[${accountId}] received message from ${message.senderNick || senderId}: ${textContent}`);
+
+            // Filter out empty messages
+            if (!textContent) return;
+
+            // Simple text cleaning (remove @bot mentions if possible, though DingTalk usually gives clean content or we might need to parse entities)
+            const cleanedText = textContent.replace(/@\w+\s*/g, '').trim();
+
+            // Forward the message to Clawdbot for processing
+            if (pluginRuntime?.runtime?.channel?.reply) {
+              const replyModule = pluginRuntime.runtime.channel.reply;
+              const chatType = String(message.conversationType) === '2' ? 'group' : 'direct';
+              const fromAddress = chatType === 'group' ? `dingtalk:group:${convoId}` : `dingtalk:${senderId}`;
+
+              const ctxPayload = {
+                Body: cleanedText,
+                RawBody: textContent,
+                CommandBody: cleanedText,
+                From: fromAddress,
+                To: 'bot',
+                SessionKey: `dingtalk:${convoId}`,
+                AccountId: accountId,
+                ChatType: chatType,
+                SenderName: message.senderNick,
+                SenderId: senderId,
+                Provider: 'dingtalk',
+                Surface: 'dingtalk',
+                MessageSid: message.msgId,
+                Timestamp: message.createAt,
+                // Required for some logic
+                GroupSubject: chatType === 'group' ? (message.conversationId) : undefined,
+              };
+
+              const finalizedCtx = replyModule.finalizeInboundContext(ctxPayload);
+
+              let replyBuffer = "";
+              let replySent = false;
+
+              const sendToDingTalk = async (text: string) => {
+                if (!text) return;
+                if (replySent) {
+                  ctx.log?.info?.(`[${accountId}] Reply already sent, skipping buffer flush.`);
+                  return;
+                }
+
+                const replyWebhook = sessionWebhooks.get(convoId) || config.webhookUrl;
+                if (!replyWebhook) {
+                  ctx.log?.error?.(`[${accountId}] No webhook to reply to ${convoId}`);
+                  return;
+                }
+
+                try {
+                  await axios.post(replyWebhook, {
+                    msgtype: "text",
+                    text: { content: text }
+                  }, { headers: { 'Content-Type': 'application/json' } });
+                  replySent = true;
+                  ctx.log?.info?.(`[${accountId}] Reply sent successfully.`);
+                } catch (e) {
+                  ctx.log?.error?.(`[${accountId}] Failed to send reply: ${e}`);
+                }
+              };
+
+              const dispatcher = {
+                sendFinalReply: (payload: any) => {
+                  const text = payload.text || payload.content || '';
+                  sendToDingTalk(text).catch(e => ctx.log?.error?.(`[${accountId}] sendToDingTalk failed: ${e}`));
+                  return true;
+                },
+                typing: async () => { },
+                reaction: async () => { },
+                isSynchronous: () => false,
+                waitForIdle: async () => { },
+                sendBlockReply: async (block: any) => {
+                  // Accumulate text from blocks
+                  const text = block.text || block.delta || block.content || '';
+                  if (text) {
+                    replyBuffer += text;
+                  }
+                },
+                getQueuedCounts: () => ({ active: 0, queued: 0, final: 0 })
+              };
+
+              // Internal dispatch
+              const dispatchPromise = replyModule.dispatchReplyFromConfig({
+                ctx: finalizedCtx,
+                cfg: pluginRuntime.config,
+                dispatcher: dispatcher,
+                replyOptions: {}
+              });
+
+              // ACK immediately to prevent retries
+              if (res.headers && res.headers.messageId) {
+                client.socketCallBackResponse(res.headers.messageId, { status: "SUCCEED" });
+              }
+
+              // Wait for run to finish
+              await dispatchPromise;
+
+              // If final reply wasn't called but we have buffer (streaming case where agent didn't return final payload?)
+              if (!replySent && replyBuffer) {
+                ctx.log?.info?.(`[${accountId}] Sending accumulated buffer from blocks (len=${replyBuffer.length}).`);
+                await sendToDingTalk(replyBuffer);
+              }
+
+            } else {
+              ctx.log?.error?.(`[${accountId}] runtime.channel.reply not available`);
+            }
+          } catch (error) {
+            ctx.log?.error?.(`[${accountId}] error processing message: ${error instanceof Error ? error.message : String(error)}`);
+            console.error('DingTalk Handler Error:', error);
+          }
+        };
+
+        // Register callback for robot messages
+        client.registerCallbackListener('/v1.0/im/bot/messages/get', handleMessage);
+
+        // Connect to DingTalk Stream
+        await client.connect();
+        activeClients.set(accountId, client);
+        ctx.log?.info?.(`[${accountId}] DingTalk Stream client connected`);
+
+        // Handle abort signal for cleanup
+        ctx.abortSignal?.addEventListener('abort', () => {
+          ctx.log?.info?.(`[${accountId}] stopping DingTalk Stream client`);
+          client.disconnect();
+          activeClients.delete(accountId);
+        });
+
+      } catch (error) {
+        ctx.log?.error?.(`[${accountId}] failed to start: ${error instanceof Error ? error.message : String(error)}`);
+        throw error;
+      }
+    },
+  },
+  outbound: {
+    deliveryMode: "direct" as const,
+    sendText: async (opts: { text: string; account: ResolvedDingTalkAccount; target: string; senderId?: string }) => {
+      const { text, account, target } = opts;
+      const config = account.config;
+
+      // Try session webhook first (for replies)
+      const sessionWebhook = sessionWebhooks.get(target);
+
+      if (sessionWebhook) {
+        try {
+          await axios.post(sessionWebhook, {
+            msgtype: "text",
+            text: { content: text }
+          }, {
+            headers: { 'Content-Type': 'application/json' }
+          });
+          return { ok: true as const };
+        } catch (error) {
+          // Fall through to webhookUrl
+        }
+      }
+
+      // Fallback to webhookUrl for proactive messages
+      if (config?.webhookUrl) {
+        try {
+          await axios.post(config.webhookUrl, {
+            msgtype: "text",
+            text: { content: text }
+          }, {
+            headers: { 'Content-Type': 'application/json' }
+          });
+          return { ok: true as const };
+        } catch (error) {
+          return { ok: false as const, error: error instanceof Error ? error.message : String(error) };
+        }
+      }
+
+      return { ok: false as const, error: "No webhook available for sending messages" };
+    }
+  }
+};
+
+
+
+// Plugin object format required by Clawdbot
+const plugin = {
+  id: "dingtalk-channel",
+  name: "DingTalk Channel",
+  description: "DingTalk channel plugin using Stream mode",
+  configSchema: {
+    type: "object" as const,
+    properties: {}
+  },
+  register(api: ClawdbotPluginApi) {
+    pluginRuntime = api;
+    api.registerChannel({ plugin: dingTalkChannelPlugin });
+  }
+};
+
+export default plugin;

package/test-config.json

@@ -0,0 +1,20 @@
+{
+  "channels": {
+    "dingtalk": {
+      "accounts": {
+        "test": {
+          "enabled": true,
+          "clientId": "YOUR_APP_KEY",
+          "clientSecret": "YOUR_APP_SECRET"
+        }
+      }
+    }
+  },
+  "plugins": {
+    "entries": {
+      "dingtalk-channel": {
+        "path": "./dist/index.js"
+      }
+    }
+  }
+}

package/test-local.js

@@ -0,0 +1,90 @@
+/**
+ * Script to test the DingTalk plugin with local Clawdbot
+ * This script will:
+ * 1. Validate the plugin structure
+ * 2. Create a test configuration
+ * 3. Provide instructions for testing
+ */
+
+const fs = require('fs');
+const path = require('path');
+const { execSync } = require('child_process');
+
+console.log('🧪 Testing DingTalk Plugin (Stream Mode)\n');
+
+// Check if the plugin built successfully
+const distDir = path.join(__dirname, 'dist');
+if (!fs.existsSync(distDir)) {
+  console.error('❌ Dist directory does not exist. Please run `npm run build` first.');
+  process.exit(1);
+}
+
+const indexJs = path.join(distDir, 'index.js');
+if (!fs.existsSync(indexJs)) {
+  console.error('❌ dist/index.js does not exist. Please run `npm run build` first.');
+  process.exit(1);
+}
+
+console.log('✅ Plugin built successfully');
+
+// Check if Clawdbot is available
+try {
+  execSync('which clawdbot', { stdio: 'pipe' });
+  console.log('✅ Clawdbot/Moltbot is available');
+} catch (error) {
+  console.log('⚠️  Clawdbot/Moltbot not found, but you can still install manually');
+}
+
+// Create a sample configuration for testing
+const testConfig = {
+  channels: {
+    dingtalk: {
+      accounts: {
+        local_test: {
+          enabled: true,
+          clientId: "YOUR_APP_KEY_HERE",
+          clientSecret: "YOUR_APP_SECRET_HERE"
+        }
+      }
+    }
+  },
+  plugins: {
+    entries: {
+      "dingtalk-channel": {
+        path: path.resolve(__dirname, 'dist/index.js')
+      }
+    }
+  }
+};
+
+const configPath = path.join(__dirname, 'local-test-config.json');
+fs.writeFileSync(configPath, JSON.stringify(testConfig, null, 2));
+console.log(`✅ Created test configuration at ${configPath}`);
+
+// Provide instructions
+console.log('\n📋 Testing Instructions:\n');
+
+console.log('1. Set up your DingTalk app:');
+console.log('   - Go to https://open.dingtalk.com/');
+console.log('   - Create an enterprise internal app');
+console.log('   - Add Robot capability with Stream Mode enabled');
+console.log('   - Get your AppKey (clientId) and AppSecret (clientSecret)\n');
+
+console.log('2. Update the test config:');
+console.log(`   - Edit ${configPath}`);
+console.log('   - Replace YOUR_APP_KEY_HERE with your AppKey');
+console.log('   - Replace YOUR_APP_SECRET_HERE with your AppSecret\n');
+
+console.log('3. Build and test:');
+console.log('   npm run build');
+console.log(`   clawdbot --config ${configPath}\n`);
+
+console.log('4. Test by sending a message to your robot in DingTalk.');
+console.log('   For group chats, @mention the robot.\n');
+
+console.log('💡 Tips:');
+console.log('- No ngrok or public IP needed! Stream mode connects outbound.');
+console.log('- Check Clawdbot logs at ~/.clawdbot/logs/ for debugging');
+console.log('- Session webhooks for replies expire after ~2 hours');
+
+console.log('\n🚀 You\'re ready to test your DingTalk Stream plugin!');

package/test-plugin.js

@@ -0,0 +1,51 @@
+/**
+ * Simple test script to validate the plugin structure
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+// Check if necessary files exist
+const requiredFiles = [
+  'package.json',
+  'moltbot.plugin.json',
+  'tsconfig.json',
+  'src/index.ts',
+];
+
+console.log('🔍 Validating plugin structure...\n');
+
+let allGood = true;
+
+for (const file of requiredFiles) {
+  const filePath = path.join(__dirname, file);
+  if (fs.existsSync(filePath)) {
+    console.log(`✅ ${file}`);
+  } else {
+    console.log(`❌ ${file} - MISSING`);
+    allGood = false;
+  }
+}
+
+// Check if src directory exists and has content
+const srcDir = path.join(__dirname, 'src');
+if (fs.existsSync(srcDir)) {
+  const srcFiles = fs.readdirSync(srcDir);
+  console.log(`\n📁 Source files: ${srcFiles.length} files`);
+  srcFiles.forEach(file => console.log(`   - ${file}`));
+} else {
+  console.log('\n❌ src directory missing');
+  allGood = false;
+}
+
+console.log('\n' + '='.repeat(50));
+
+if (allGood) {
+  console.log('🎉 Plugin structure looks good!');
+  console.log('\nNext steps:');
+  console.log('1. Run `npm install` to install dependencies');
+  console.log('2. Run `npm run build` to compile TypeScript');
+  console.log('3. Test the plugin with your local Clawdbot');
+} else {
+  console.log('❌ Some files are missing. Please check the structure.');
+}

package/tsconfig.json

@@ -0,0 +1,34 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "commonjs",
+    "lib": ["ES2020"],
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "removeComments": false,
+    "noImplicitAny": true,
+    "strictNullChecks": true,
+    "strictFunctionTypes": true,
+    "noImplicitThis": true,
+    "noImplicitReturns": true,
+    "noFallthroughCasesInSwitch": true,
+    "noUncheckedIndexedAccess": true,
+    "noImplicitOverride": true,
+    "allowUnreachableCode": false,
+    "allowUnusedLabels": false
+  },
+  "include": [
+    "src/**/*"
+  ],
+  "exclude": [
+    "node_modules",
+    "dist"
+  ]
+}