@dingtalk-real-ai/dingtalk-connector 0.8.20-beta.7 → 0.8.20

package/CHANGELOG.md

@@ -5,6 +5,19 @@ 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.20] - 2026-04-28
+
+### 修复 / Fixes
+- 🐛 **OpenClaw 插件加载兼容性 (Issue #527)** — `configSchema` 改为延迟初始化，通过 `createRequire` 解析 `openclaw/plugin-sdk/core`，修复插件安装到 `~/.openclaw/extensions/` 时 ESM 裸说明符解析失败导致的 "Cannot find package 'openclaw'" 崩溃  
+  **OpenClaw plugin load compatibility (Issue #527)** — `configSchema` deferred to lazy init via `createRequire`, fixing "Cannot find package 'openclaw'" crash when plugin is installed to `~/.openclaw/extensions/`
+
+- 🐛 **Onboarding 动态导入** — `promptSingleChannelSecretInput` 从静态 import 改为动态 `import()`，避免在 ESM 加载阶段触发同样的裸说明符解析错误  
+  **Onboarding dynamic import** — `promptSingleChannelSecretInput` switched from static to dynamic `import()` to avoid bare specifier resolution error during ESM loading
+
+### 改进 / Improvements
+- ✅ **DWS CLI 版本管理重构** — `ensureDwsCli()` 新增 `compareVersions()` 语义版本比较，支持四种场景：目标版本更高时自动升级、本地版本更高时询问是否覆盖、版本一致时跳过、全新安装时显示已安装版本号  
+  **DWS CLI version management refactor** — `ensureDwsCli()` now uses `compareVersions()` for semver comparison with four scenarios: auto-upgrade when target is newer, prompt before downgrade, skip when equal, show version on fresh install
+
 ## [0.8.19] - 2026-04-25
 
 ### 新增 / Added

package/bin/dingtalk-connector.js

@@ -428,6 +428,22 @@ function getTargetDwsVersion() {
   return versionMatch ? versionMatch[1] : null;
 }
 
+/**
+ * Compare two semver version strings.
+ * Returns: positive if a > b, negative if a < b, 0 if equal.
+ */
+function compareVersions(versionA, versionB) {
+  const partsA = versionA.split('.').map(Number);
+  const partsB = versionB.split('.').map(Number);
+  const maxLength = Math.max(partsA.length, partsB.length);
+  for (let i = 0; i < maxLength; i++) {
+    const partA = partsA[i] || 0;
+    const partB = partsB[i] || 0;
+    if (partA !== partB) return partA - partB;
+  }
+  return 0;
+}
+
 function askUserConfirmation(question) {
   const { createInterface } = createRequire(import.meta.url)('node:readline');
   const rl = createInterface({
@@ -498,33 +514,50 @@ function isDwsAuthenticated() {
 }
 
 async function ensureDwsCli() {
+  const targetVersion = getTargetDwsVersion();
+
   if (isDwsInstalled()) {
     const installedVersion = getInstalledDwsVersion();
-    const targetVersion = getTargetDwsVersion();
     const versionDisplay = installedVersion ? `v${installedVersion}` : 'unknown version';
-
-    console.log(dim(`  ✔ dws CLI already installed (${versionDisplay})`) + '\n');
-
-    // Check if a newer version is available
-    if (installedVersion && targetVersion && installedVersion !== targetVersion) {
-      console.log(orange(`  ℹ A newer version of dws CLI is available: v${targetVersion} (current: v${installedVersion})`) + '\n');
+    const comparison = (installedVersion && targetVersion) ? compareVersions(targetVersion, installedVersion) : 0;
+
+    if (comparison > 0) {
+      // Scenario 1: target > local → upgrade directly
+      console.log(dim(`  ℹ dws CLI detected (${versionDisplay}), upgrading to v${targetVersion}...`) + '\n');
+      console.log(dim(`    v${installedVersion} → v${targetVersion}`) + '\n');
+      const upgraded = installDwsCli();
+      if (upgraded) {
+        const newVersion = getInstalledDwsVersion();
+        console.log(green(`  ✔ dws CLI upgraded to v${newVersion || targetVersion}`) + '\n');
+      } else {
+        console.log(red('  ⚠ Upgrade failed. Continuing with current version.') + '\n');
+      }
+    } else if (comparison < 0) {
+      // Scenario 2: target < local → ask user before downgrading
+      console.log(dim(`  ℹ dws CLI detected (${versionDisplay})`) + '\n');
+      console.log(orange(`  ⚠ Your local dws CLI (v${installedVersion}) is newer than the bundled version (v${targetVersion}).`) + '\n');
+      console.log(dim(`    Overwriting would downgrade: v${installedVersion} → v${targetVersion}`) + '\n');
       const answer = await askUserConfirmation(
-        `  Do you want to upgrade dws CLI to v${targetVersion}? (覆盖安装新版本？) [y/N] `
+        `  Do you want to overwrite with v${targetVersion}? (是否覆盖为旧版本？) [y/N] `
       );
       if (answer === 'y' || answer === 'yes') {
         console.log('');
-        const upgraded = installDwsCli();
-        if (upgraded) {
+        const downgraded = installDwsCli();
+        if (downgraded) {
           const newVersion = getInstalledDwsVersion();
-          console.log(green(`  ✔ dws CLI upgraded to v${newVersion || targetVersion}`) + '\n');
+          console.log(green(`  ✔ dws CLI replaced with v${newVersion || targetVersion}`) + '\n');
         } else {
-          console.log(red('  ⚠ Upgrade failed. Continuing with current version.') + '\n');
+          console.log(red('  ⚠ Overwrite failed. Continuing with current version.') + '\n');
         }
       } else {
         console.log('\n' + dim(`  Keeping current dws CLI v${installedVersion}`) + '\n');
       }
+    } else {
+      // Scenario 3: versions are equal → skip
+      console.log(dim(`  ✔ dws CLI already installed (${versionDisplay}), version is up to date`) + '\n');
     }
 
+    // Check authentication status regardless of version scenario
     if (isDwsAuthenticated()) {
       console.log(dim('  ✔ dws CLI authenticated') + '\n');
     } else {
@@ -534,6 +567,7 @@ async function ensureDwsCli() {
     return;
   }
 
+  // Scenario 4: dws not installed → install and show version
   const installed = installDwsCli();
   if (!installed) {
     console.log(red('  ⚠ Could not install dws CLI automatically.') + '\n');
@@ -544,7 +578,10 @@ async function ensureDwsCli() {
     return;
   }
 
-  console.log(dim('  ℹ dws CLI installed. Authorization will be triggered when Agent uses dws features.') + '\n');
+  const freshVersion = getInstalledDwsVersion();
+  const freshDisplay = freshVersion ? `v${freshVersion}` : (targetVersion ? `v${targetVersion}` : '');
+  console.log(green(`  ✔ dws CLI installed (${freshDisplay})`) + '\n');
+  console.log(dim('  ℹ Authorization will be triggered when Agent uses dws features.') + '\n');
   console.log(dim('    You can also authorize manually anytime: ') + cyan('dws auth login') + '\n');
 }
 

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

@@ -6,7 +6,7 @@ import * as fs from "fs";
 *
 * 职责：
 * - 管理单个钉钉账号的 WebSocket 连接
-* - 实现应用层心跳检测（10 秒间隔 ping，90 秒无 pong 响应则重连）
+* - 实现应用层心跳检测（10 秒间隔，90 秒超时）
 * - 处理连接重连逻辑，带指数退避
 * - 消息去重（内置 Map，5 分钟 TTL）
 *
@@ -18,7 +18,7 @@ import * as fs from "fs";
 /** 心跳间隔（毫秒） */
 const HEARTBEAT_INTERVAL = 10 * 1e3;
 /** 超时阈值（毫秒） */
-const TIMEOUT_THRESHOLD = 90 * 1e3;
+const TIMEOUT_THRESHOLD = 20 * 1e3;
 /** 基础退避时间（毫秒） */
 const BASE_BACKOFF_DELAY = 1e3;
 /** 最大退避时间（毫秒） */
@@ -151,9 +151,6 @@ async function monitorSingleAccount(opts) {
 				client.socket?.once("open", onOpen);
 				client.socket?.once("error", onError);
 			})) throw new Error(`连接建立超时或失败`);
-			setupPongListener();
-			setupMessageListener();
-			setupCloseListener();
 			lastSocketAvailableTime = Date.now();
 			connectionEstablishedTime = Date.now();
 			reconnectAttempts = 0;
@@ -266,6 +263,9 @@ async function monitorSingleAccount(opts) {
 		if (client.socket) client.socket.removeAllListeners();
 		logger.debug(`Connection 已停止`);
 	}
+	setupPongListener();
+	setupMessageListener();
+	setupCloseListener();
 	return new Promise(async (resolve, reject) => {
 		if (abortSignal) {
 			const onAbort = async () => {
@@ -369,10 +369,7 @@ async function monitorSingleAccount(opts) {
 			await client.connect();
 			logger.info(`Connected to DingTalk Stream successfully`);
 			logger.info(`PID: ${process.pid}`);
-			logger.info(`✅ 自定义 keepAlive: true (${HEARTBEAT_INTERVAL / 1e3}秒心跳，${TIMEOUT_THRESHOLD / 1e3}秒超时), 指数退避重连`);
-			setupPongListener();
-			setupMessageListener();
-			setupCloseListener();
+			logger.info(`✅ 自定义 keepAlive: true (10 秒心跳，90 秒超时), 指数退避重连`);
 			onStatusChange?.({
 				connected: true,
 				lastConnectedAt: Date.now()
@@ -402,14 +399,6 @@ async function monitorSingleAccount(opts) {
 				reject(/* @__PURE__ */ new Error(`[DingTalk][${accountId}] Authentication failed (401 Unauthorized):\n  - Your clientId or clientSecret is invalid, expired, or revoked\n  - clientId: ${clientIdStr.substring(0, 8)}...\n  - Please verify your credentials at DingTalk Developer Console\n  - Error details: ${error.message}`));
 				return;
 			}
-			if (error.response?.status === 403 || error.message?.includes("status code 403") || error.message?.includes("403")) {
-				reject(/* @__PURE__ */ new Error(`[DingTalk][${accountId}] Forbidden (403):\n  - 可能原因 / Possible causes:\n    1. 机器人未开启 Stream 模式（需在钉钉开放平台 → 消息接收模式中设置）\n    2. 机器人处于"开发中"状态，尚未发布上线\n    3. API 调用频率超限（QPS Limit）\n  - Error details: ${error.message}\n  - Response data: ${JSON.stringify(error.response?.data || {})}`));
-				return;
-			}
-			if (error.message?.includes("protocol") || error.message?.includes("mismatch") || error.message?.includes("upgrade")) {
-				reject(/* @__PURE__ */ new Error(`[DingTalk][${accountId}] Failed to connect to DingTalk Stream: ${error.message}\n  - 可能原因 / Possible causes:\n    1. dingtalk-stream SDK 版本过旧，请升级插件: npx openclaw@latest add @dingtalk-real-ai/dingtalk-connector\n    2. 网络代理或防火墙拦截了 WebSocket 连接\n    3. 钉钉服务端协议已更新，当前版本不兼容\n  - 建议 / Suggestions:\n    1. 升级到最新版本的 dingtalk-connector 插件\n    2. 检查网络环境是否允许 WebSocket 连接\n    3. 如仍有问题，请提 Issue 并附上完整日志`));
-				return;
-			}
 			reject(/* @__PURE__ */ new Error(`[DingTalk][${accountId}] Failed to connect to DingTalk Stream: ${error.message}`));
 			return;
 		}

package/dist/index.d.mts

@@ -156,6 +156,19 @@ type ResolvedDingtalkAccount = {
 //#endregion
 //#region src/channel.d.ts
 declare const dingtalkPlugin: ChannelPlugin<ResolvedDingtalkAccount>;
+/**
+ * Synchronously initializes `dingtalkPlugin.configSchema` using `createRequire`.
+ *
+ * Static `import ... from "openclaw/plugin-sdk/core"` causes
+ * "Cannot find package 'openclaw'" when the plugin is installed to
+ * `~/.openclaw/extensions/` (Issue #527) because the ESM loader resolves
+ * bare specifiers at parse time before the gateway's jiti alias map is active.
+ *
+ * By deferring the resolve to `register()` time and using `createRequire`
+ * (which searches the gateway's own `node_modules`), we avoid the crash
+ * while keeping the call synchronous as required by the plugin API.
+ */
+declare function initDingtalkPluginConfigSchema(): void;
 //#endregion
 //#region src/runtime.d.ts
 declare const setDingtalkRuntime: (next: PluginRuntime) => void, getDingtalkRuntime: () => PluginRuntime;
@@ -169,4 +182,4 @@ declare function registerGatewayMethods(api: OpenClawPluginApi): void;
 //#region index.d.ts
 declare function register(api: OpenClawPluginApi): void;
 //#endregion
-export { register as default, dingtalkPlugin, registerGatewayMethods, setDingtalkRuntime };
+export { register as default, dingtalkPlugin, initDingtalkPluginConfigSchema, registerGatewayMethods, setDingtalkRuntime };

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { i as dingtalkPlugin, n as setDingtalkRuntime } from "./runtime-C9AAkRdJ.mjs";
+import { a as initDingtalkPluginConfigSchema, i as dingtalkPlugin, n as setDingtalkRuntime } from "./runtime-b4xvqwW6.mjs";
 import { t as registerGatewayMethods } from "./gateway-methods-DI8lkjSd.mjs";
 //#region index.ts
 /**
@@ -37,8 +37,9 @@ function recordAndCheckLoadPath(api) {
 function register(api) {
 	recordAndCheckLoadPath(api);
 	setDingtalkRuntime(api.runtime);
+	initDingtalkPluginConfigSchema();
 	api.registerChannel({ plugin: dingtalkPlugin });
 	registerGatewayMethods(api);
 }
 //#endregion
-export { register as default, dingtalkPlugin, registerGatewayMethods, setDingtalkRuntime };
+export { register as default, dingtalkPlugin, initDingtalkPluginConfigSchema, registerGatewayMethods, setDingtalkRuntime };

package/dist/{message-handler-DAFzVJ-a.mjs → message-handler-_vk6QsWo.mjs}

@@ -1,6 +1,6 @@
 import { u as uploadMediaToDingTalk } from "./media-DUMfXnwJ.mjs";
 import { a as resolveDingtalkAccount } from "./accounts-CF4oK_HZ.mjs";
-import { r as CHANNEL_ID, t as getDingtalkRuntime } from "./runtime-C9AAkRdJ.mjs";
+import { r as CHANNEL_ID, t as getDingtalkRuntime } from "./runtime-b4xvqwW6.mjs";
 import { n as createLoggerFromConfig } from "./logger-BDWwViGT.mjs";
 import { t as dingtalkHttp } from "./http-client-DFWZgO1n.mjs";
 import { i as getOapiAccessToken } from "./utils-CIfI_3Jh.mjs";
@@ -204,7 +204,7 @@ async function uploadAndReplaceFileMarkers(content, sessionWebhook, config, oapi
 }
 //#endregion
 //#region src/reply-dispatcher.ts
-const { createReplyPrefixOptions = () => void 0, createTypingCallbacks = () => ({}), logTypingFailure = () => {} } = await import("openclaw/plugin-sdk/channel-runtime").catch(() => null) ?? {};
+const { createReplyPrefixOptions, createTypingCallbacks, logTypingFailure } = await import("openclaw/plugin-sdk/channel-runtime");
 function createDingtalkReplyDispatcher(params) {
 	const core = getDingtalkRuntime();
 	const { cfg, agentId, conversationId, senderId, isDirect, accountId, sessionWebhook, asyncMode = false, preCreatedCard } = params;

package/dist/{runtime-C9AAkRdJ.mjs → runtime-b4xvqwW6.mjs}

@@ -4,6 +4,7 @@ import { t as createLogger } from "./logger-BDWwViGT.mjs";
 import { t as dingtalkHttp } from "./http-client-DFWZgO1n.mjs";
 import "./utils-CIfI_3Jh.mjs";
 import { n as sendMediaToDingTalk, o as sendTextToDingTalk } from "./messaging-CyIJY4h2.mjs";
+import { createRequire } from "node:module";
 import { z, z as z$1 } from "zod";
 //#region src/secret-input.ts
 function buildSecretInputSchema() {
@@ -481,9 +482,6 @@ async function renderQrCodeText(content) {
 }
 //#endregion
 //#region src/onboarding.ts
-const { promptSingleChannelSecretInput } = await import("openclaw/plugin-sdk/setup").catch(() => ({ promptSingleChannelSecretInput: async () => {
-	throw new Error("openclaw SDK not available — cannot prompt for secret input. Please upgrade OpenClaw.");
-} }));
 const _env$1 = globalThis["process"].env;
 const channel = "dingtalk-connector";
 const DINGTALK_MANUAL_SETUP_DOC = "docs/DINGTALK_MANUAL_SETUP.md";
@@ -750,7 +748,8 @@ const dingtalkOnboardingAdapter = {
 					prompter,
 					initialValue: normalizeString(dingtalkCfg?.clientId) ?? normalizeString(_env$1.DINGTALK_CLIENT_ID)
 				});
-				const clientSecretResult = await promptSingleChannelSecretInput({
+				const { promptSingleChannelSecretInput: promptSecret } = await import("openclaw/plugin-sdk/setup");
+				const clientSecretResult = await promptSecret({
 					cfg: next,
 					prompter,
 					providerHint: "dingtalk",
@@ -906,8 +905,8 @@ async function monitorDingtalkProvider(opts = {}) {
 	const log = createLogger(cfg.channels?.["dingtalk-connector"]?.debug ?? false);
 	const [accountsModule, monitorAccountModule, monitorSingleModule] = await Promise.all([
 		import("./accounts-BSIiLyZa.mjs"),
-		import("./message-handler-DAFzVJ-a.mjs"),
-		import("./connection-CCvXXBXw.mjs")
+		import("./message-handler-_vk6QsWo.mjs"),
+		import("./connection-BZd5NXuh.mjs")
 	]);
 	const { resolveDingtalkAccount, listEnabledDingtalkAccounts } = accountsModule;
 	const { handleDingTalkMessage } = monitorAccountModule;
@@ -949,7 +948,6 @@ async function monitorDingtalkProvider(opts = {}) {
 }
 //#endregion
 //#region src/channel.ts
-const { buildChannelConfigSchema } = await import("openclaw/plugin-sdk/core").catch(() => ({ buildChannelConfigSchema: (schema) => ({ schema }) }));
 /** Channel identifier used across the plugin. Single source of truth. */
 const CHANNEL_ID = "dingtalk-connector";
 /**
@@ -1000,7 +998,7 @@ const dingtalkPlugin = {
 	groups: { resolveToolPolicy: resolveDingtalkGroupToolPolicy },
 	mentions: { stripPatterns: () => ["@[^\\s]+"] },
 	reload: { configPrefixes: [`channels.${CHANNEL_ID}`] },
-	configSchema: buildChannelConfigSchema(DingtalkConfigBaseSchema),
+	configSchema: void 0,
 	config: {
 		listAccountIds: (cfg) => listDingtalkAccountIds(cfg),
 		resolveAccount: (cfg, accountId) => resolveDingtalkAccount({
@@ -1346,6 +1344,23 @@ const dingtalkPlugin = {
 		}
 	} }
 };
+/**
+* Synchronously initializes `dingtalkPlugin.configSchema` using `createRequire`.
+*
+* Static `import ... from "openclaw/plugin-sdk/core"` causes
+* "Cannot find package 'openclaw'" when the plugin is installed to
+* `~/.openclaw/extensions/` (Issue #527) because the ESM loader resolves
+* bare specifiers at parse time before the gateway's jiti alias map is active.
+*
+* By deferring the resolve to `register()` time and using `createRequire`
+* (which searches the gateway's own `node_modules`), we avoid the crash
+* while keeping the call synchronous as required by the plugin API.
+*/
+function initDingtalkPluginConfigSchema() {
+	if (dingtalkPlugin.configSchema != null) return;
+	const { buildChannelConfigSchema } = createRequire(import.meta.url)("openclaw/plugin-sdk/core");
+	dingtalkPlugin.configSchema = buildChannelConfigSchema(DingtalkConfigBaseSchema);
+}
 //#endregion
 //#region src/runtime.ts
 /**
@@ -1372,4 +1387,4 @@ function createRuntimeStore(errorMessage) {
 }
 const { setRuntime: setDingtalkRuntime, getRuntime: getDingtalkRuntime } = createRuntimeStore("DingTalk runtime not initialized");
 //#endregion
-export { dingtalkPlugin as i, setDingtalkRuntime as n, CHANNEL_ID as r, getDingtalkRuntime as t };
+export { initDingtalkPluginConfigSchema as a, dingtalkPlugin as i, setDingtalkRuntime as n, CHANNEL_ID as r, getDingtalkRuntime as t };

package/docs/RELEASE_NOTES_V0.8.20.md

@@ -0,0 +1,49 @@
+# Release Notes - v0.8.20
+
+## 🎉 新版本亮点 / Highlights
+
+本次版本聚焦 **OpenClaw 兼容性修复** 和 **DWS CLI 版本管理优化**。修复了插件安装到 `~/.openclaw/extensions/` 时因 ESM 裸说明符解析导致的加载崩溃（Issue #527），并重构了 DWS CLI 的版本升级/降级策略，提升安装体验。
+
+This release focuses on **OpenClaw compatibility fixes** and **DWS CLI version management improvements**. Fixes a plugin load crash caused by ESM bare specifier resolution when installed to `~/.openclaw/extensions/` (Issue #527), and refactors DWS CLI upgrade/downgrade logic for a smoother install experience.
+
+## 🐛 修复 / Fixes
+
+- **OpenClaw 插件加载兼容性 (Issue #527) / Plugin load compatibility**
+  `configSchema` 改为延迟初始化，通过 `createRequire` 解析 `openclaw/plugin-sdk/core`，修复插件安装到 `~/.openclaw/extensions/` 时 ESM 裸说明符解析失败导致的 "Cannot find package 'openclaw'" 崩溃。
+  `configSchema` deferred to lazy init via `createRequire`, fixing "Cannot find package 'openclaw'" crash when plugin is installed to `~/.openclaw/extensions/`.
+
+- **Onboarding 动态导入 / Dynamic import for onboarding**
+  `promptSingleChannelSecretInput` 从静态 import 改为动态 `import()`，避免在 ESM 加载阶段触发同样的裸说明符解析错误。
+  `promptSingleChannelSecretInput` switched from static to dynamic `import()` to avoid bare specifier resolution error during ESM loading.
+
+## ✅ 改进 / Improvements
+
+- **DWS CLI 版本管理重构 / Version management refactor**
+  `ensureDwsCli()` 新增 `compareVersions()` 语义版本比较，支持四种场景：
+  - 目标版本更高 → 自动升级 / Auto-upgrade when target is newer
+  - 本地版本更高 → 询问是否覆盖 / Prompt before downgrade
+  - 版本一致 → 跳过 / Skip when equal
+  - 全新安装 → 显示已安装版本号 / Show version on fresh install
+
+## 📥 安装升级 / Installation & Upgrade
+
+```bash
+npx openclaw@latest add @dingtalk-real-ai/dingtalk-connector
+```
+
+或指定版本：
+```bash
+npx openclaw@latest add @dingtalk-real-ai/dingtalk-connector@0.8.20
+```
+
+## 🔗 相关链接 / Related Links
+
+- [完整变更日志](https://github.com/DingTalk-Real-AI/dingtalk-openclaw-connector/blob/main/CHANGELOG.md)
+- [使用文档](https://github.com/DingTalk-Real-AI/dingtalk-openclaw-connector/blob/main/README.md)
+- [故障排查](https://github.com/DingTalk-Real-AI/dingtalk-openclaw-connector/blob/main/docs/TROUBLESHOOTING.md)
+
+---
+
+**发布日期 / Release Date**：2026-04-28
+**版本号 / Version**：v0.8.20
+**兼容性 / Compatibility**：OpenClaw Gateway 2026.4.9+

package/index.ts

@@ -15,11 +15,11 @@
  */
 
 import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
-import { dingtalkPlugin } from "./src/channel.ts";
+import { dingtalkPlugin, initDingtalkPluginConfigSchema } from "./src/channel.ts";
 import { setDingtalkRuntime } from "./src/runtime.ts";
 import { registerGatewayMethods } from "./src/gateway-methods.ts";
 
-export { dingtalkPlugin } from "./src/channel.ts";
+export { dingtalkPlugin, initDingtalkPluginConfigSchema } from "./src/channel.ts";
 export { setDingtalkRuntime } from "./src/runtime.ts";
 export { registerGatewayMethods } from "./src/gateway-methods.ts";
 
@@ -71,6 +71,7 @@ function recordAndCheckLoadPath(api: OpenClawPluginApi): void {
 export default function register(api: OpenClawPluginApi) {
   recordAndCheckLoadPath(api);
   setDingtalkRuntime(api.runtime);
+  initDingtalkPluginConfigSchema();
   api.registerChannel({ plugin: dingtalkPlugin });
   registerGatewayMethods(api);
 }

package/openclaw.plugin.json

@@ -1,7 +1,7 @@
 {
   "id": "dingtalk-connector",
   "name": "DingTalk Channel",
-  "version": "0.8.20-beta.7",
+  "version": "0.8.20",
   "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.20-beta.7",
+  "version": "0.8.20",
   "description": "Official OpenClaw DingTalk channel plugin | 钉钉官方 OpenClaw 插件",
   "type": "module",
   "exports": {
@@ -90,7 +90,7 @@
   },
   "dependencies": {
     "axios": "1.14.0",
-    "dingtalk-stream": "2.1.5",
+    "dingtalk-stream": "2.1.4",
     "form-data": "4.0.0",
     "qrcode-terminal": "0.12.0",
     "zod": "4.3.6"

package/src/channel.ts

@@ -1,12 +1,8 @@
+import { createRequire as nodeCreateRequire } from "node:module";
 import type {
   ChannelPlugin,
   ClawdbotConfig,
 } from "openclaw/plugin-sdk";
-// 动态导入 buildChannelConfigSchema，避免 openclaw 包不可达时插件加载崩溃
-const { buildChannelConfigSchema } = await import("openclaw/plugin-sdk/core").catch(() => ({
-  // 降级：直接返回 Zod schema 包装，Gateway 仍可运行（仅丢失 Web UI JSON Schema 展示）
-  buildChannelConfigSchema: (schema: any) => ({ schema }),
-}));
 import {
   createDefaultChannelRuntimeState,
   DEFAULT_ACCOUNT_ID,
@@ -124,7 +120,7 @@ export const dingtalkPlugin: ChannelPlugin<ResolvedDingtalkAccount> = {
     stripPatterns: () => ['@[^\\s]+'], // Strip @mentions
   },
   reload: { configPrefixes: [`channels.${CHANNEL_ID}`] },
-  configSchema: buildChannelConfigSchema(DingtalkConfigBaseSchema),
+  configSchema: undefined as any, // Initialized lazily by initDingtalkPluginConfigSchema()
   config: {
     listAccountIds: (cfg) => listDingtalkAccountIds(cfg),
     resolveAccount: (cfg, accountId) => resolveDingtalkAccount({ cfg, accountId }),
@@ -535,4 +531,23 @@ export const dingtalkPlugin: ChannelPlugin<ResolvedDingtalkAccount> = {
       }
     },
   },
-};
+};
+
+/**
+ * Synchronously initializes `dingtalkPlugin.configSchema` using `createRequire`.
+ *
+ * Static `import ... from "openclaw/plugin-sdk/core"` causes
+ * "Cannot find package 'openclaw'" when the plugin is installed to
+ * `~/.openclaw/extensions/` (Issue #527) because the ESM loader resolves
+ * bare specifiers at parse time before the gateway's jiti alias map is active.
+ *
+ * By deferring the resolve to `register()` time and using `createRequire`
+ * (which searches the gateway's own `node_modules`), we avoid the crash
+ * while keeping the call synchronous as required by the plugin API.
+ */
+export function initDingtalkPluginConfigSchema(): void {
+  if (dingtalkPlugin.configSchema != null) return;
+  const require_ = nodeCreateRequire(import.meta.url);
+  const { buildChannelConfigSchema } = require_("openclaw/plugin-sdk/core");
+  (dingtalkPlugin as any).configSchema = buildChannelConfigSchema(DingtalkConfigBaseSchema);
+}

package/src/core/connection.ts

@@ -3,7 +3,7 @@
  *
  * 职责：
  * - 管理单个钉钉账号的 WebSocket 连接
- * - 实现应用层心跳检测（10 秒间隔 ping，90 秒无 pong 响应则重连）
+ * - 实现应用层心跳检测（10 秒间隔，90 秒超时）
  * - 处理连接重连逻辑，带指数退避
  * - 消息去重（内置 Map，5 分钟 TTL）
  *
@@ -58,7 +58,7 @@ export type MonitorDingtalkAccountOpts = {
 /** 心跳间隔（毫秒） */
 const HEARTBEAT_INTERVAL = 10 * 1000; // 10 秒
 /** 超时阈值（毫秒） */
-const TIMEOUT_THRESHOLD = 90 * 1000; // 90 秒（约 9 次心跳未响应）
+const TIMEOUT_THRESHOLD = 20 * 1000; // 20 秒（2 次心跳未响应）
 /** 基础退避时间（毫秒） */
 const BASE_BACKOFF_DELAY = 1000; // 1 秒
 /** 最大退避时间（毫秒） */
@@ -279,12 +279,7 @@ export async function monitorSingleAccount(
         throw new Error(`连接建立超时或失败`);
       }
 
-      // 4. 重新注册 socket 事件监听器（新连接产生新 socket，旧监听器已失效）
-      setupPongListener();
-      setupMessageListener();
-      setupCloseListener();
-
-      // 5. 重置 socket 可用时间、连接建立时间和重连计数
+      // 4. 重置 socket 可用时间、连接建立时间和重连计数
       lastSocketAvailableTime = Date.now();
       connectionEstablishedTime = Date.now(); // 重置连接建立时间
       reconnectAttempts = 0; // 重连成功，重置计数
@@ -454,8 +449,10 @@ export async function monitorSingleAccount(
     logger.debug(`Connection 已停止`);
   }
 
-  // 注意：socket 事件监听器在 client.connect() 成功后注册（见下方），
-  // 因为 connect 之前 client.socket 为 null，可选链 ?.on() 不会生效。
+  // 初始化：设置所有事件监听器
+  setupPongListener();
+  setupMessageListener();
+  setupCloseListener();
 
   return new Promise<void>(async (resolve, reject) => {
     // Handle abort signal
@@ -644,14 +641,9 @@ export async function monitorSingleAccount(
       logger.info(`Connected to DingTalk Stream successfully`);
       logger.info(`PID: ${process.pid}`);
       logger.info(
-        `✅ 自定义 keepAlive: true (${HEARTBEAT_INTERVAL / 1000}秒心跳，${TIMEOUT_THRESHOLD / 1000}秒超时), 指数退避重连`,
+        `✅ 自定义 keepAlive: true (10 秒心跳，90 秒超时), 指数退避重连`,
       );
 
-      // 连接成功后注册 socket 事件监听器（此时 client.socket 已可用）
-      setupPongListener();
-      setupMessageListener();
-      setupCloseListener();
-
       // 初次连接成功，向框架报告 connected: true
       onStatusChange?.({ connected: true, lastConnectedAt: Date.now() });
 
@@ -710,36 +702,6 @@ export async function monitorSingleAccount(
         return;
       }
 
-     // 处理 403 错误（权限/限流）
-      if (error.response?.status === 403 || error.message?.includes("status code 403") || error.message?.includes("403")) {
-        reject(new Error(
-          `[DingTalk][${accountId}] Forbidden (403):\n` +
-            `  - 可能原因 / Possible causes:\n` +
-            `    1. 机器人未开启 Stream 模式（需在钉钉开放平台 → 消息接收模式中设置）\n` +
-            `    2. 机器人处于"开发中"状态，尚未发布上线\n` +
-            `    3. API 调用频率超限（QPS Limit）\n` +
-            `  - Error details: ${error.message}\n` +
-            `  - Response data: ${JSON.stringify(error.response?.data || {})}`,
-        ));
-        return;
-      }
-
-      // 处理协议不匹配（通常是 dingtalk-stream SDK 版本过旧）
-      if (error.message?.includes('protocol') || error.message?.includes('mismatch') || error.message?.includes('upgrade')) {
-        reject(new Error(
-          `[DingTalk][${accountId}] Failed to connect to DingTalk Stream: ${error.message}\n` +
-            `  - 可能原因 / Possible causes:\n` +
-            `    1. dingtalk-stream SDK 版本过旧，请升级插件: npx openclaw@latest add @dingtalk-real-ai/dingtalk-connector\n` +
-            `    2. 网络代理或防火墙拦截了 WebSocket 连接\n` +
-            `    3. 钉钉服务端协议已更新，当前版本不兼容\n` +
-            `  - 建议 / Suggestions:\n` +
-            `    1. 升级到最新版本的 dingtalk-connector 插件\n` +
-            `    2. 检查网络环境是否允许 WebSocket 连接\n` +
-            `    3. 如仍有问题，请提 Issue 并附上完整日志`,
-        ));
-        return;
-      }
-
       // 处理其他连接错误
       reject(new Error(
         `[DingTalk][${accountId}] Failed to connect to DingTalk Stream: ${error.message}`,

package/src/onboarding.ts

@@ -7,6 +7,7 @@ import type {
   ChannelSetupWizardAdapter,
   ChannelSetupDmPolicy,
   DmPolicy,
+  // promptSingleChannelSecretInput is dynamically imported at call sites (Issue #527)
 } from "openclaw/plugin-sdk/setup";
 import {
   addWildcardAllowFrom,
@@ -14,12 +15,6 @@ import {
   formatDocsLink,
   hasConfiguredSecretInput,
 } from "./sdk/helpers.ts";
-// 动态导入，避免 openclaw 包不可达时插件加载崩溃
-const { promptSingleChannelSecretInput } = await import("openclaw/plugin-sdk/setup").catch(() => ({
-  promptSingleChannelSecretInput: async () => {
-    throw new Error("openclaw SDK not available — cannot prompt for secret input. Please upgrade OpenClaw.");
-  },
-})) as { promptSingleChannelSecretInput: typeof import("openclaw/plugin-sdk/setup")["promptSingleChannelSecretInput"] };
 import { resolveDingtalkAccount, resolveDingtalkCredentials } from "./config/accounts.ts";
 import { probeDingtalk } from "./probe.ts";
 import type { DingtalkConfig } from "./types/index.ts";
@@ -453,7 +448,8 @@ export const dingtalkOnboardingAdapter: ChannelSetupWizardAdapter = {
               normalizeString(dingtalkCfg?.clientId) ?? normalizeString(_env.DINGTALK_CLIENT_ID),
           });
 
-          const clientSecretResult = await promptSingleChannelSecretInput({
+          const { promptSingleChannelSecretInput: promptSecret } = await import("openclaw/plugin-sdk/setup");
+          const clientSecretResult = await promptSecret({
             cfg: next,
             prompter,
             providerHint: "dingtalk",

package/src/reply-dispatcher.ts

@@ -17,14 +17,14 @@ interface ReplyPayload {
   [key: string]: any;
 }
 
-// ✅ 动态导入 channel-runtime 模块，带降级处理
-const channelRuntimeModule = await import("openclaw/plugin-sdk/channel-runtime").catch(() => null) as any;
+// ✅ 动态导入 channel-runtime 模块
+const channelRuntimeModule = await import("openclaw/plugin-sdk/channel-runtime") as any;
 
 const {
-  createReplyPrefixOptions = () => undefined,
-  createTypingCallbacks = () => ({}),
-  logTypingFailure = () => {},
-} = channelRuntimeModule ?? {};
+  createReplyPrefixOptions,
+  createTypingCallbacks,
+  logTypingFailure,
+} = channelRuntimeModule;
 
 import { createLoggerFromConfig } from "./utils/logger.ts";
 import { CHANNEL_ID } from "./channel.ts";