@wecom/wecom-openclaw-plugin 2026.3.24-beta.2 → 2026.3.24-beta.4

package/dist/index.cjs.js

@@ -2,14 +2,13 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var core = require('openclaw/plugin-sdk/core');
-var os$1 = require('os');
-var path$1 = require('path');
-var aibotNodeSdk = require('@wecom/aibot-node-sdk');
 var fs = require('node:fs/promises');
 var path = require('node:path');
 var os = require('node:os');
 var node_url = require('node:url');
+var os$1 = require('os');
+var path$1 = require('path');
+var aibotNodeSdk = require('@wecom/aibot-node-sdk');
 var fileType = require('file-type');
 var node_fs = require('node:fs');
 
@@ -31,22 +30,11 @@ function _interopNamespaceDefault(e) {
     return Object.freeze(n);
 }
 
-var os__namespace$1 = /*#__PURE__*/_interopNamespaceDefault(os$1);
-var path__namespace$1 = /*#__PURE__*/_interopNamespaceDefault(path$1);
 var fs__namespace = /*#__PURE__*/_interopNamespaceDefault(fs);
 var path__namespace = /*#__PURE__*/_interopNamespaceDefault(path);
 var os__namespace = /*#__PURE__*/_interopNamespaceDefault(os);
-
-let runtime = null;
-function setWeComRuntime(r) {
-    runtime = r;
-}
-function getWeComRuntime() {
-    if (!runtime) {
-        throw new Error("WeCom runtime not initialized - plugin not registered");
-    }
-    return runtime;
-}
+var os__namespace$1 = /*#__PURE__*/_interopNamespaceDefault(os$1);
+var path__namespace$1 = /*#__PURE__*/_interopNamespaceDefault(path$1);
 
 /**
  * openclaw plugin-sdk 高版本方法兼容层
@@ -57,6 +45,7 @@ function getWeComRuntime() {
  * 本模块在加载时一次性探测 SDK 导出，存在则直接 re-export SDK 版本，
  * 不存在则导出 fallback 实现。其他模块统一从本文件导入，无需关心底层兼容细节。
  */
+const DEFAULT_ACCOUNT_ID = "default";
 const _sdkReady = import('openclaw/plugin-sdk/core')
     .then((sdk) => {
     const exports$1 = {};
@@ -399,6 +388,34 @@ async function getDefaultMediaLocalRoots() {
         path__namespace.join(stateDir, "sandboxes"),
     ];
 }
+function emptyPluginConfigSchema() {
+    return {
+        type: 'object',
+        additionalProperties: false,
+        properties: {},
+    };
+}
+/**
+ * 格式化配对审批提示信息（参考 moltbot 实现）
+ * @param channelId 频道ID
+ * @returns 配对审批提示字符串
+ */
+function formatPairingApproveHint(channelId) {
+    const listCmd = `openclaw pairing list ${channelId}`;
+    const approveCmd = `openclaw pairing approve ${channelId} <code>`;
+    return `向 ${channelId} 机器人发送消息以完成配对审批（命令行：${listCmd} / ${approveCmd}）`;
+}
+
+let runtime = null;
+function setWeComRuntime(r) {
+    runtime = r;
+}
+function getWeComRuntime() {
+    if (!runtime) {
+        throw new Error("WeCom runtime not initialized - plugin not registered");
+    }
+    return runtime;
+}
 
 /**
  * 企业微信渠道常量定义
@@ -2164,7 +2181,7 @@ const DefaultWsUrl = "wss://openws.work.weixin.qq.com";
 function resolveWeComAccount(cfg) {
     const wecomConfig = (cfg.channels?.[CHANNEL_ID] ?? {});
     return {
-        accountId: core.DEFAULT_ACCOUNT_ID,
+        accountId: DEFAULT_ACCOUNT_ID,
         name: wecomConfig.name ?? "企业微信",
         enabled: wecomConfig.enabled ?? false,
         websocketUrl: wecomConfig.websocketUrl || DefaultWsUrl,
@@ -2206,39 +2223,33 @@ function setWeComAccount(cfg, account) {
 }
 
 /**
- * 企业微信 onboarding adapter for CLI setup wizard.
- */
-const channel = CHANNEL_ID;
-/**
- * 企业微信设置帮助说明
- */
-async function noteWeComSetupHelp(prompter) {
-    await prompter.note([
-        "企业微信机器人需要以下配置信息：",
-        "1. Bot ID: 企业微信机器人id",
-        "2. Secret: 企业微信机器人密钥",
-    ].join("\n"), "企业微信设置");
-}
-/**
- * 提示输入 Bot ID
- */
-async function promptBotId(prompter, account) {
-    return String(await prompter.text({
-        message: "企业微信机器人 Bot ID",
-        initialValue: account?.botId ?? "",
-        validate: (value) => (value?.trim() ? undefined : "Required"),
-    })).trim();
-}
-/**
- * 提示输入 Secret
+ * 企业微信 setupWizard — 声明式 CLI setup wizard 配置。
+ *
+ * 框架通过 plugin.setupWizard 字段识别并驱动 channel 的引导配置流程。
  */
-async function promptSecret(prompter, account) {
-    return String(await prompter.text({
-        message: "企业微信机器人 Secret",
-        initialValue: account?.secret ?? "",
-        validate: (value) => (value?.trim() ? undefined : "Required"),
-    })).trim();
-}
+// ============================================================================
+// ChannelSetupAdapter — 框架用于应用配置输入的适配器
+// ============================================================================
+const wecomSetupAdapter = {
+    applyAccountConfig: ({ cfg, input }) => {
+        const patch = {};
+        if (input.token !== undefined) {
+            patch.botId = String(input.token).trim();
+        }
+        if (input.privateKey !== undefined) {
+            patch.secret = String(input.privateKey).trim();
+        }
+        // 如果是首次配置，默认启用
+        const account = resolveWeComAccount(cfg);
+        if (!account.botId && !account.secret) {
+            patch.enabled = true;
+        }
+        return setWeComAccount(cfg, patch);
+    },
+};
+// ============================================================================
+// DM Policy 配置
+// ============================================================================
 /**
  * 设置企业微信 dmPolicy
  */
@@ -2255,7 +2266,7 @@ function setWeComDmPolicy(cfg, dmPolicy) {
 }
 const dmPolicy = {
     label: "企业微信",
-    channel,
+    channel: CHANNEL_ID,
     policyKey: `channels.${CHANNEL_ID}.dmPolicy`,
     allowFromKey: `channels.${CHANNEL_ID}.allowFrom`,
     getCurrent: (cfg) => {
@@ -2269,8 +2280,8 @@ const dmPolicy = {
         const account = resolveWeComAccount(cfg);
         const existingAllowFrom = account.config.allowFrom ?? [];
         const entry = await prompter.text({
-            message: "企业微信允许来源（用户ID或群组ID，每行一个，推荐用于安全控制）",
-            placeholder: "user123 或 group456",
+            message: "企业微信允许来源（用户ID或群组ID，逗号分隔）",
+            placeholder: "user123, group456",
             initialValue: existingAllowFrom[0] ? String(existingAllowFrom[0]) : undefined,
         });
         const allowFrom = String(entry ?? "")
@@ -2280,38 +2291,105 @@ const dmPolicy = {
         return setWeComAccount(cfg, { allowFrom });
     },
 };
-const wecomOnboardingAdapter = {
-    channel,
-    getStatus: async ({ cfg }) => {
-        const account = resolveWeComAccount(cfg);
-        const configured = Boolean(account.botId?.trim() &&
-            account.secret?.trim());
-        return {
-            channel,
-            configured,
-            statusLines: [`企业微信: ${configured ? "已配置" : "需要 Bot ID 和 Secret"}`],
-            selectionHint: configured ? "已配置" : "需要设置",
-        };
+// ============================================================================
+// ChannelSetupWizard — 声明式 setup wizard 配置
+// ============================================================================
+const wecomSetupWizard = {
+    channel: CHANNEL_ID,
+    // ── 状态 ──────────────────────────────────────────────────────────────
+    status: {
+        configuredLabel: "已配置 ✓",
+        unconfiguredLabel: "需要 Bot ID 和 Secret",
+        configuredHint: "已配置",
+        unconfiguredHint: "需要设置",
+        resolveConfigured: ({ cfg }) => {
+            const account = resolveWeComAccount(cfg);
+            return Boolean(account.botId?.trim() && account.secret?.trim());
+        },
+        resolveStatusLines: ({ cfg, configured }) => {
+            return [`企业微信: ${configured ? "已配置" : "需要 Bot ID 和 Secret"}`];
+        },
+    },
+    // ── 引导说明 ──────────────────────────────────────────────────────────
+    introNote: {
+        title: "企业微信设置",
+        lines: [
+            "企业微信机器人需要以下配置信息：",
+            "1. Bot ID: 企业微信机器人 ID",
+            "2. Secret: 企业微信机器人密钥",
+        ],
+        shouldShow: ({ cfg }) => {
+            const account = resolveWeComAccount(cfg);
+            return !account.botId?.trim() || !account.secret?.trim();
+        },
     },
-    configure: async ({ cfg, prompter, forceAllowFrom }) => {
+    // ── 凭据输入 ──────────────────────────────────────────────────────────
+    credentials: [
+        {
+            inputKey: "token",
+            providerHint: "企业微信",
+            credentialLabel: "Bot ID",
+            envPrompt: "使用环境变量中的 Bot ID？",
+            keepPrompt: "Bot ID 已配置，保留当前值？",
+            inputPrompt: "企业微信机器人 Bot ID",
+            inspect: ({ cfg }) => {
+                const account = resolveWeComAccount(cfg);
+                const hasValue = Boolean(account.botId?.trim());
+                return {
+                    accountConfigured: hasValue,
+                    hasConfiguredValue: hasValue,
+                    resolvedValue: account.botId || undefined,
+                };
+            },
+            applySet: ({ cfg, resolvedValue }) => {
+                return setWeComAccount(cfg, { botId: resolvedValue });
+            },
+        },
+        {
+            inputKey: "privateKey",
+            providerHint: "企业微信",
+            credentialLabel: "Secret",
+            envPrompt: "使用环境变量中的 Secret？",
+            keepPrompt: "Secret 已配置，保留当前值？",
+            inputPrompt: "企业微信机器人 Secret",
+            inspect: ({ cfg }) => {
+                const account = resolveWeComAccount(cfg);
+                const hasValue = Boolean(account.secret?.trim());
+                return {
+                    accountConfigured: hasValue,
+                    hasConfiguredValue: hasValue,
+                    resolvedValue: account.secret || undefined,
+                };
+            },
+            applySet: ({ cfg, resolvedValue }) => {
+                return setWeComAccount(cfg, { secret: resolvedValue });
+            },
+        },
+    ],
+    // ── 完成后的最终处理 ──────────────────────────────────────────────────
+    finalize: async ({ cfg }) => {
+        // 确保配置完成后 channel 处于启用状态
         const account = resolveWeComAccount(cfg);
-        if (!account.botId?.trim() || !account.secret?.trim()) {
-            await noteWeComSetupHelp(prompter);
-        }
-        // 提示输入必要的配置信息：Bot ID 和 Secret
-        const botId = await promptBotId(prompter, account);
-        const secret = await promptSecret(prompter, account);
-        // 使用默认值配置其他选项
-        const cfgWithAccount = setWeComAccount(cfg, {
-            botId,
-            secret,
-            enabled: true,
-            dmPolicy: account.config.dmPolicy ?? "open",
-            allowFrom: account.config.allowFrom ?? [],
-        });
-        return { cfg: cfgWithAccount };
+        if (account.botId?.trim() && account.secret?.trim() && !account.enabled) {
+            return { cfg: setWeComAccount(cfg, { enabled: true }) };
+        }
+        return undefined;
+    },
+    // ── 完成提示 ──────────────────────────────────────────────────────────
+    completionNote: {
+        title: "企业微信配置完成",
+        lines: [
+            "企业微信机器人已配置完成。",
+            "运行 `openclaw start` 启动服务。",
+        ],
+        shouldShow: ({ cfg }) => {
+            const account = resolveWeComAccount(cfg);
+            return Boolean(account.botId?.trim() && account.secret?.trim());
+        },
     },
+    // ── DM 策略 ──────────────────────────────────────────────────────────
     dmPolicy,
+    // ── 禁用 ─────────────────────────────────────────────────────────────
     disable: (cfg) => {
         return setWeComAccount(cfg, { enabled: false });
     },
@@ -2322,7 +2400,7 @@ const wecomOnboardingAdapter = {
  * 无需依赖 reqId，直接向指定会话推送消息
  */
 async function sendWeComMessage({ to, content, accountId, }) {
-    const resolvedAccountId = accountId ?? core.DEFAULT_ACCOUNT_ID;
+    const resolvedAccountId = accountId ?? DEFAULT_ACCOUNT_ID;
     // 从 to 中提取 chatId（格式是 "${CHANNEL_ID}:chatId" 或直接是 chatId）
     const channelPrefix = new RegExp(`^${CHANNEL_ID}:`, "i");
     const chatId = to.replace(channelPrefix, "");
@@ -2372,7 +2450,8 @@ const wecomPlugin = {
             // Pairing approved for user
         },
     },
-    onboarding: wecomOnboardingAdapter,
+    setupWizard: wecomSetupWizard,
+    setup: wecomSetupAdapter,
     capabilities: {
         chatTypes: ["direct", "group"],
         reactions: false,
@@ -2384,11 +2463,11 @@ const wecomPlugin = {
     reload: { configPrefixes: [`channels.${CHANNEL_ID}`] },
     config: {
         // 列出所有账户 ID（最小实现只支持默认账户）
-        listAccountIds: () => [core.DEFAULT_ACCOUNT_ID],
+        listAccountIds: () => [DEFAULT_ACCOUNT_ID],
         // 解析账户配置
         resolveAccount: (cfg) => resolveWeComAccount(cfg),
         // 获取默认账户 ID
-        defaultAccountId: () => core.DEFAULT_ACCOUNT_ID,
+        defaultAccountId: () => DEFAULT_ACCOUNT_ID,
         // 设置账户启用状态
         setAccountEnabled: ({ cfg, enabled }) => {
             const wecomConfig = (cfg.channels?.[CHANNEL_ID] ?? {});
@@ -2444,7 +2523,7 @@ const wecomPlugin = {
                 allowFrom: account.config.allowFrom ?? [],
                 policyPath: `${basePath}dmPolicy`,
                 allowFromPath: basePath,
-                approveHint: core.formatPairingApproveHint(CHANNEL_ID),
+                approveHint: formatPairingApproveHint(CHANNEL_ID),
                 normalizeEntry: (raw) => raw.replace(new RegExp(`^${CHANNEL_ID}:`, "i"), "").trim(),
             };
         },
@@ -2500,7 +2579,7 @@ const wecomPlugin = {
             return sendWeComMessage({ to, content: text, accountId: accountId ?? undefined });
         },
         sendMedia: async ({ to, text, mediaUrl, mediaLocalRoots, accountId }) => {
-            const resolvedAccountId = accountId ?? core.DEFAULT_ACCOUNT_ID;
+            const resolvedAccountId = accountId ?? DEFAULT_ACCOUNT_ID;
             const channelPrefix = new RegExp(`^${CHANNEL_ID}:`, "i");
             const chatId = to.replace(channelPrefix, "");
             // 获取 WSClient 实例
@@ -2545,14 +2624,14 @@ const wecomPlugin = {
     },
     status: {
         defaultRuntime: {
-            accountId: core.DEFAULT_ACCOUNT_ID,
+            accountId: DEFAULT_ACCOUNT_ID,
             running: false,
             lastStartAt: null,
             lastStopAt: null,
             lastError: null,
         },
         collectStatusIssues: (accounts) => accounts.flatMap((entry) => {
-            const accountId = String(entry.accountId ?? core.DEFAULT_ACCOUNT_ID);
+            const accountId = String(entry.accountId ?? DEFAULT_ACCOUNT_ID);
             const enabled = entry.enabled !== false;
             const configured = entry.configured === true;
             if (!enabled) {
@@ -2719,7 +2798,7 @@ const inflightInitRequests = new Map();
  * @returns 完整的 response.body 配置对象（至少包含 url 字段）
  */
 async function fetchMcpConfig(category) {
-    const wsClient = getWeComWebSocket(core.DEFAULT_ACCOUNT_ID);
+    const wsClient = getWeComWebSocket(DEFAULT_ACCOUNT_ID);
     if (!wsClient) {
         throw new Error("WSClient 未连接，无法拉取 MCP 配置");
     }
@@ -3460,7 +3539,7 @@ const plugin = {
     id: "wecom-openclaw-plugin",
     name: "企业微信",
     description: "企业微信 OpenClaw 插件",
-    configSchema: core.emptyPluginConfigSchema(),
+    configSchema: emptyPluginConfigSchema(),
     register(api) {
         setWeComRuntime(api.runtime);
         api.registerChannel({ plugin: wecomPlugin });