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

package/dist/index.d.ts

@@ -1,11 +1,10 @@
-import * as openclaw_plugin_sdk from 'openclaw/plugin-sdk';
 import { OpenClawPluginApi } from 'openclaw/plugin-sdk/core';
 
 declare const plugin: {
     id: string;
     name: string;
     description: string;
-    configSchema: openclaw_plugin_sdk.OpenClawPluginConfigSchema;
+    configSchema: Record<string, unknown>;
     register(api: OpenClawPluginApi): void;
 };
 

package/dist/index.esm.js

@@ -1,26 +1,14 @@
-import { DEFAULT_ACCOUNT_ID, formatPairingApproveHint, emptyPluginConfigSchema } from 'openclaw/plugin-sdk/core';
-import * as os$1 from 'os';
-import * as path$1 from 'path';
-import { generateReqId, WSClient, WSAuthFailureError, WSReconnectExhaustedError } from '@wecom/aibot-node-sdk';
 import * as fs from 'node:fs/promises';
 import * as path from 'node:path';
 import { dirname, resolve } from 'node:path';
 import * as os from 'node:os';
 import { fileURLToPath } from 'node:url';
+import * as os$1 from 'os';
+import * as path$1 from 'path';
+import { generateReqId, WSClient, WSAuthFailureError, WSReconnectExhaustedError } from '@wecom/aibot-node-sdk';
 import { fileTypeFromBuffer } from 'file-type';
 import { readFileSync } from 'node:fs';
 
-let runtime = null;
-function setWeComRuntime(r) {
-    runtime = r;
-}
-function getWeComRuntime() {
-    if (!runtime) {
-        throw new Error("WeCom runtime not initialized - plugin not registered");
-    }
-    return runtime;
-}
-
 /**
  * openclaw plugin-sdk 高版本方法兼容层
  *
@@ -30,6 +18,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 = {};
@@ -372,6 +361,34 @@ async function getDefaultMediaLocalRoots() {
         path.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;
+}
 
 /**
  * 企业微信渠道常量定义
@@ -2179,39 +2196,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
  */
@@ -2228,7 +2239,7 @@ function setWeComDmPolicy(cfg, dmPolicy) {
 }
 const dmPolicy = {
     label: "企业微信",
-    channel,
+    channel: CHANNEL_ID,
     policyKey: `channels.${CHANNEL_ID}.dmPolicy`,
     allowFromKey: `channels.${CHANNEL_ID}.allowFrom`,
     getCurrent: (cfg) => {
@@ -2242,8 +2253,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 ?? "")
@@ -2253,38 +2264,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"}`];
+        },
     },
-    configure: async ({ cfg, prompter, forceAllowFrom }) => {
+    // ── 引导说明 ──────────────────────────────────────────────────────────
+    introNote: {
+        title: "企业微信设置",
+        lines: [
+            "企业微信机器人需要以下配置信息：",
+            "1. Bot ID: 企业微信机器人 ID",
+            "2. Secret: 企业微信机器人密钥",
+        ],
+        shouldShow: ({ cfg }) => {
+            const account = resolveWeComAccount(cfg);
+            return !account.botId?.trim() || !account.secret?.trim();
+        },
+    },
+    // ── 凭据输入 ──────────────────────────────────────────────────────────
+    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 });
     },
@@ -2345,7 +2423,8 @@ const wecomPlugin = {
             // Pairing approved for user
         },
     },
-    onboarding: wecomOnboardingAdapter,
+    setupWizard: wecomSetupWizard,
+    setup: wecomSetupAdapter,
     capabilities: {
         chatTypes: ["direct", "group"],
         reactions: false,