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

package/dist/index.cjs.js

@@ -325,6 +325,36 @@ async function loadOutboundMediaFromUrl(mediaUrl, options = {}) {
     return loadOutboundMediaFromUrlFallback(mediaUrl, options);
 }
 // ============================================================================
+// addWildcardAllowFrom —— 向 allowFrom 列表添加通配符 "*"
+// ============================================================================
+/** fallback 版 addWildcardAllowFrom：确保列表中包含 "*" 通配符 */
+function addWildcardAllowFromFallback(allowFrom) {
+    if (allowFrom.includes("*")) {
+        return allowFrom;
+    }
+    return [...allowFrom, "*"];
+}
+/**
+ * 向 allowFrom 列表添加通配符 "*"（兼容入口）
+ *
+ * 当 dmPolicy 为 "open" 时，需要确保 allowFrom 中包含 "*" 以允许所有来源。
+ * 优先使用 SDK 版本（plugin-sdk/setup 或 plugin-sdk/core），不可用时使用 fallback。
+ *
+ * 注意：此函数为同步函数，与 SDK 原始签名一致。
+ * SDK 引用在模块加载时异步探测并缓存，调用时同步读取缓存。
+ */
+function addWildcardAllowFrom(allowFrom) {
+    if (_cachedAddWildcardAllowFrom) {
+        try {
+            return _cachedAddWildcardAllowFrom(allowFrom);
+        }
+        catch {
+            // SDK 版本异常，降级到 fallback
+        }
+    }
+    return addWildcardAllowFromFallback(allowFrom);
+}
+// ============================================================================
 // getDefaultMediaLocalRoots —— 获取默认媒体本地路径白名单
 // ============================================================================
 /** 解析 openclaw 状态目录 */
@@ -2161,6 +2191,209 @@ function resolveWeComAccount(cfg) {
         config: wecomConfig,
     };
 }
+/**
+ * 设置企业微信账户配置
+ */
+function setWeComAccount(cfg, account) {
+    const existing = (cfg.channels?.[CHANNEL_ID] ?? {});
+    const merged = {
+        enabled: account.enabled ?? existing?.enabled ?? true,
+        botId: account.botId ?? existing?.botId ?? "",
+        secret: account.secret ?? existing?.secret ?? "",
+        allowFrom: account.allowFrom ?? existing?.allowFrom,
+        dmPolicy: account.dmPolicy ?? existing?.dmPolicy,
+        // 以下字段仅在已有配置值或显式传入时才写入，onboarding 时不主动生成
+        ...(account.websocketUrl || existing?.websocketUrl
+            ? { websocketUrl: account.websocketUrl ?? existing?.websocketUrl }
+            : {}),
+        ...(account.name || existing?.name
+            ? { name: account.name ?? existing?.name }
+            : {}),
+        ...(account.sendThinkingMessage !== undefined || existing?.sendThinkingMessage !== undefined
+            ? { sendThinkingMessage: account.sendThinkingMessage ?? existing?.sendThinkingMessage }
+            : {}),
+    };
+    return {
+        ...cfg,
+        channels: {
+            ...cfg.channels,
+            [CHANNEL_ID]: merged,
+        },
+    };
+}
+
+/**
+ * 企业微信 setupWizard — 声明式 CLI setup wizard 配置。
+ *
+ * 框架通过 plugin.setupWizard 字段识别并驱动 channel 的引导配置流程。
+ */
+// ============================================================================
+// 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
+ */
+function setWeComDmPolicy(cfg, dmPolicy) {
+    const account = resolveWeComAccount(cfg);
+    const existingAllowFrom = account.config.allowFrom ?? [];
+    const allowFrom = dmPolicy === "open"
+        ? addWildcardAllowFrom(existingAllowFrom.map((x) => String(x)))
+        : existingAllowFrom.map((x) => String(x));
+    return setWeComAccount(cfg, {
+        dmPolicy,
+        allowFrom,
+    });
+}
+const dmPolicy = {
+    label: "企业微信",
+    channel: CHANNEL_ID,
+    policyKey: `channels.${CHANNEL_ID}.dmPolicy`,
+    allowFromKey: `channels.${CHANNEL_ID}.allowFrom`,
+    getCurrent: (cfg) => {
+        const account = resolveWeComAccount(cfg);
+        return account.config.dmPolicy ?? "open";
+    },
+    setPolicy: (cfg, policy) => {
+        return setWeComDmPolicy(cfg, policy);
+    },
+    promptAllowFrom: async ({ cfg, prompter }) => {
+        const account = resolveWeComAccount(cfg);
+        const existingAllowFrom = account.config.allowFrom ?? [];
+        const entry = await prompter.text({
+            message: "企业微信允许来源（用户ID或群组ID，逗号分隔）",
+            placeholder: "user123, group456",
+            initialValue: existingAllowFrom[0] ? String(existingAllowFrom[0]) : undefined,
+        });
+        const allowFrom = String(entry ?? "")
+            .split(/[\n,;]+/g)
+            .map((s) => s.trim())
+            .filter(Boolean);
+        return setWeComAccount(cfg, { allowFrom });
+    },
+};
+// ============================================================================
+// 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();
+        },
+    },
+    // ── 凭据输入 ──────────────────────────────────────────────────────────
+    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() && !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 });
+    },
+};
 
 /**
  * 使用 SDK 的 sendMessage 主动发送企业微信消息
@@ -2217,6 +2450,8 @@ const wecomPlugin = {
             // Pairing approved for user
         },
     },
+    setupWizard: wecomSetupWizard,
+    setup: wecomSetupAdapter,
     capabilities: {
         chatTypes: ["direct", "group"],
         reactions: false,