@larksuite/openclaw-lark 2026.3.9

package/src/channel/monitor.js

@@ -0,0 +1,128 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * WebSocket monitoring for the Feishu/Lark channel plugin.
+ *
+ * Manages per-account WSClient connections and routes inbound Feishu
+ * events (messages, bot membership changes, read receipts) to the
+ * appropriate handlers.
+ */
+import { getLarkAccount, getEnabledLarkAccounts } from '../core/accounts';
+import { LarkClient } from '../core/lark-client';
+import { MessageDedup } from '../messaging/inbound/dedup';
+import { larkLogger } from '../core/lark-logger';
+import { drainShutdownHooks } from '../core/shutdown-hooks';
+import { handleMessageEvent, handleReactionEvent, handleBotMembershipEvent, handleCardActionEvent, } from './event-handlers';
+const mlog = larkLogger('channel/monitor');
+// ---------------------------------------------------------------------------
+// Single-account monitor
+// ---------------------------------------------------------------------------
+/**
+ * Start monitoring a single Feishu account.
+ *
+ * Creates a LarkClient, probes bot identity, registers event handlers,
+ * and starts a WebSocket connection. Returns a Promise that resolves
+ * when the abort signal fires (or immediately if already aborted).
+ */
+async function monitorSingleAccount(params) {
+    const { cfg, account, runtime, abortSignal } = params;
+    const { accountId } = account;
+    const log = runtime?.log ?? ((...args) => mlog.info(args.map(String).join(' ')));
+    const error = runtime?.error ?? ((...args) => mlog.error(args.map(String).join(' ')));
+    // Only websocket mode is supported in the monitor path.
+    const connectionMode = account.config.connectionMode ?? 'websocket';
+    if (connectionMode !== 'websocket') {
+        log(`feishu[${accountId}]: webhook mode not implemented in monitor`);
+        return;
+    }
+    // Message dedup — filters duplicate deliveries from WebSocket reconnects.
+    const dedupCfg = account.config.dedup;
+    const messageDedup = new MessageDedup({
+        ttlMs: dedupCfg?.ttlMs,
+        maxEntries: dedupCfg?.maxEntries,
+    });
+    log(`feishu[${accountId}]: message dedup enabled (ttl=${messageDedup['ttlMs']}ms, max=${messageDedup['maxEntries']})`);
+    log(`feishu[${accountId}]: starting WebSocket connection...`);
+    // Create LarkClient instance — manages SDK client, WS, and bot identity.
+    const lark = LarkClient.fromAccount(account);
+    // Attach dedup instance so it is disposed together with the client.
+    lark.messageDedup = messageDedup;
+    /** Per-chat history maps (used for group-chat context window). */
+    const chatHistories = new Map();
+    const ctx = {
+        cfg,
+        lark,
+        accountId,
+        chatHistories,
+        messageDedup,
+        runtime,
+        log,
+        error,
+    };
+    await lark.startWS({
+        handlers: {
+            'im.message.receive_v1': (data) => handleMessageEvent(ctx, data),
+            'im.message.message_read_v1': async () => { },
+            'im.message.reaction.created_v1': (data) => handleReactionEvent(ctx, data),
+            'im.chat.member.bot.added_v1': (data) => handleBotMembershipEvent(ctx, data, 'added'),
+            'im.chat.member.bot.deleted_v1': (data) => handleBotMembershipEvent(ctx, data, 'removed'),
+            // 飞书 SDK EventDispatcher.register 不支持带返回值的处理器，此处 as any 是 SDK 类型限制的变通
+            'card.action.trigger': ((data) => 
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            handleCardActionEvent(ctx, data)),
+        },
+        abortSignal,
+    });
+    // startWS resolves when abortSignal fires — probe result is logged inside startWS.
+    log(`feishu[${accountId}]: bot open_id resolved: ${lark.botOpenId ?? 'unknown'}`);
+    log(`feishu[${accountId}]: WebSocket client started`);
+    mlog.info(`websocket started for account ${accountId}`);
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Start monitoring for all enabled Feishu accounts (or a single
+ * account when `opts.accountId` is specified).
+ */
+export async function monitorFeishuProvider(opts = {}) {
+    const cfg = opts.config;
+    if (!cfg) {
+        throw new Error('Config is required for Feishu monitor');
+    }
+    // Store the original global config so plugin commands (doctor, diagnose)
+    // can access cross-account information even when running inside an
+    // account-scoped config context.
+    LarkClient.setGlobalConfig(cfg);
+    const log = opts.runtime?.log ?? ((...args) => mlog.info(args.map(String).join(' ')));
+    // Single-account mode.
+    if (opts.accountId) {
+        const account = getLarkAccount(cfg, opts.accountId);
+        if (!account.enabled || !account.configured) {
+            throw new Error(`Feishu account "${opts.accountId}" not configured or disabled`);
+        }
+        await monitorSingleAccount({
+            cfg,
+            account,
+            runtime: opts.runtime,
+            abortSignal: opts.abortSignal,
+        });
+        await drainShutdownHooks({ log });
+        return;
+    }
+    // Multi-account mode: start all enabled accounts in parallel.
+    const accounts = getEnabledLarkAccounts(cfg);
+    if (accounts.length === 0) {
+        throw new Error('No enabled Feishu accounts configured');
+    }
+    log(`feishu: starting ${accounts.length} account(s): ${accounts.map((a) => a.accountId).join(', ')}`);
+    await Promise.all(accounts.map((account) => monitorSingleAccount({
+        cfg,
+        account,
+        runtime: opts.runtime,
+        abortSignal: opts.abortSignal,
+    })));
+    await drainShutdownHooks({ log });
+}
+//# sourceMappingURL=monitor.js.map

package/src/channel/monitor.js.map

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

package/src/channel/onboarding-config.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Onboarding configuration mutation helpers.
+ *
+ * Pure functions that apply Feishu channel configuration changes
+ * to a ClawdbotConfig. Extracted from onboarding.ts for reuse
+ * in CLI commands and other configuration flows.
+ */
+import type { ClawdbotConfig, DmPolicy } from 'openclaw/plugin-sdk';
+export declare function setFeishuDmPolicy(cfg: ClawdbotConfig, dmPolicy: DmPolicy): ClawdbotConfig;
+export declare function setFeishuAllowFrom(cfg: ClawdbotConfig, allowFrom: string[]): ClawdbotConfig;
+export declare function setFeishuGroupPolicy(cfg: ClawdbotConfig, groupPolicy: 'open' | 'allowlist' | 'disabled'): ClawdbotConfig;
+export declare function setFeishuGroupAllowFrom(cfg: ClawdbotConfig, groupAllowFrom: string[]): ClawdbotConfig;
+export declare function setFeishuGroups(cfg: ClawdbotConfig, groups: Record<string, object>): ClawdbotConfig;
+export declare function parseAllowFromInput(raw: string): string[];
+//# sourceMappingURL=onboarding-config.d.ts.map

package/src/channel/onboarding-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"onboarding-config.d.ts","sourceRoot":"","sources":["../../../src/channel/onboarding-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAOpE,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,cAAc,EAAE,QAAQ,EAAE,QAAQ,GAAG,cAAc,CAiBzF;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,cAAc,CAW3F;AAED,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,cAAc,EACnB,WAAW,EAAE,MAAM,GAAG,WAAW,GAAG,UAAU,GAC7C,cAAc,CAYhB;AAED,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,EAAE,GAAG,cAAc,CAWrG;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,cAAc,CAWnG;AAMD,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAKzD"}

package/src/channel/onboarding-config.js

@@ -0,0 +1,89 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Onboarding configuration mutation helpers.
+ *
+ * Pure functions that apply Feishu channel configuration changes
+ * to a ClawdbotConfig. Extracted from onboarding.ts for reuse
+ * in CLI commands and other configuration flows.
+ */
+import { addWildcardAllowFrom } from 'openclaw/plugin-sdk';
+// ---------------------------------------------------------------------------
+// Config mutation helpers
+// ---------------------------------------------------------------------------
+export function setFeishuDmPolicy(cfg, dmPolicy) {
+    const allowFrom = dmPolicy === 'open'
+        ? addWildcardAllowFrom(cfg.channels?.feishu?.allowFrom)?.map((entry) => String(entry))
+        : undefined;
+    return {
+        ...cfg,
+        channels: {
+            ...cfg.channels,
+            feishu: {
+                ...cfg.channels?.feishu,
+                dmPolicy,
+                ...(allowFrom ? { allowFrom } : {}),
+            },
+        },
+    };
+}
+export function setFeishuAllowFrom(cfg, allowFrom) {
+    return {
+        ...cfg,
+        channels: {
+            ...cfg.channels,
+            feishu: {
+                ...cfg.channels?.feishu,
+                allowFrom,
+            },
+        },
+    };
+}
+export function setFeishuGroupPolicy(cfg, groupPolicy) {
+    return {
+        ...cfg,
+        channels: {
+            ...cfg.channels,
+            feishu: {
+                ...cfg.channels?.feishu,
+                enabled: true,
+                groupPolicy,
+            },
+        },
+    };
+}
+export function setFeishuGroupAllowFrom(cfg, groupAllowFrom) {
+    return {
+        ...cfg,
+        channels: {
+            ...cfg.channels,
+            feishu: {
+                ...cfg.channels?.feishu,
+                groupAllowFrom,
+            },
+        },
+    };
+}
+export function setFeishuGroups(cfg, groups) {
+    return {
+        ...cfg,
+        channels: {
+            ...cfg.channels,
+            feishu: {
+                ...cfg.channels?.feishu,
+                groups,
+            },
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// Input helpers
+// ---------------------------------------------------------------------------
+export function parseAllowFromInput(raw) {
+    return raw
+        .split(/[\n,;]+/g)
+        .map((entry) => entry.trim())
+        .filter(Boolean);
+}
+//# sourceMappingURL=onboarding-config.js.map

package/src/channel/onboarding-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"onboarding-config.js","sourceRoot":"","sources":["../../../src/channel/onboarding-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAE3D,8EAA8E;AAC9E,0BAA0B;AAC1B,8EAA8E;AAE9E,MAAM,UAAU,iBAAiB,CAAC,GAAmB,EAAE,QAAkB;IACvE,MAAM,SAAS,GACb,QAAQ,KAAK,MAAM;QACjB,CAAC,CAAC,oBAAoB,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACtF,CAAC,CAAC,SAAS,CAAC;IAEhB,OAAO;QACL,GAAG,GAAG;QACN,QAAQ,EAAE;YACR,GAAG,GAAG,CAAC,QAAQ;YACf,MAAM,EAAE;gBACN,GAAG,GAAG,CAAC,QAAQ,EAAE,MAAM;gBACvB,QAAQ;gBACR,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACpC;SACF;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,GAAmB,EAAE,SAAmB;IACzE,OAAO;QACL,GAAG,GAAG;QACN,QAAQ,EAAE;YACR,GAAG,GAAG,CAAC,QAAQ;YACf,MAAM,EAAE;gBACN,GAAG,GAAG,CAAC,QAAQ,EAAE,MAAM;gBACvB,SAAS;aACV;SACF;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,GAAmB,EACnB,WAA8C;IAE9C,OAAO;QACL,GAAG,GAAG;QACN,QAAQ,EAAE;YACR,GAAG,GAAG,CAAC,QAAQ;YACf,MAAM,EAAE;gBACN,GAAG,GAAG,CAAC,QAAQ,EAAE,MAAM;gBACvB,OAAO,EAAE,IAAI;gBACb,WAAW;aACZ;SACF;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,GAAmB,EAAE,cAAwB;IACnF,OAAO;QACL,GAAG,GAAG;QACN,QAAQ,EAAE;YACR,GAAG,GAAG,CAAC,QAAQ;YACf,MAAM,EAAE;gBACN,GAAG,GAAG,CAAC,QAAQ,EAAE,MAAM;gBACvB,cAAc;aACf;SACF;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,GAAmB,EAAE,MAA8B;IACjF,OAAO;QACL,GAAG,GAAG;QACN,QAAQ,EAAE;YACR,GAAG,GAAG,CAAC,QAAQ;YACf,MAAM,EAAE;gBACN,GAAG,GAAG,CAAC,QAAQ,EAAE,MAAM;gBACvB,MAAM;aACP;SACF;KACF,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,gBAAgB;AAChB,8EAA8E;AAE9E,MAAM,UAAU,mBAAmB,CAAC,GAAW;IAC7C,OAAO,GAAG;SACP,KAAK,CAAC,UAAU,CAAC;SACjB,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;SAC5B,MAAM,CAAC,OAAO,CAAC,CAAC;AACrB,CAAC"}

package/src/channel/onboarding-migrate.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Legacy groupAllowFrom migration for Feishu onboarding.
+ *
+ * Handles the migration of chat_id entries (oc_xxx) from
+ * groupAllowFrom to the groups config, preserving the original
+ * semantic of "allow this group for any sender".
+ */
+import type { ClawdbotConfig, WizardPrompter } from 'openclaw/plugin-sdk';
+/**
+ * Detect and migrate legacy chat_id entries in groupAllowFrom.
+ *
+ * Old semantic: groupAllowFrom contained chat_ids (oc_xxx) to control
+ * which groups could use the bot.
+ * New semantic: groupAllowFrom is for sender filtering (open_ids like ou_xxx).
+ *
+ * This function prompts the user and, if confirmed, moves chat_ids
+ * to the groups config and keeps only sender IDs in groupAllowFrom.
+ */
+export declare function migrateLegacyGroupAllowFrom(params: {
+    cfg: ClawdbotConfig;
+    prompter: WizardPrompter;
+}): Promise<ClawdbotConfig>;
+//# sourceMappingURL=onboarding-migrate.d.ts.map

package/src/channel/onboarding-migrate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"onboarding-migrate.d.ts","sourceRoot":"","sources":["../../../src/channel/onboarding-migrate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAI1E;;;;;;;;;GASG;AACH,wBAAsB,2BAA2B,CAAC,MAAM,EAAE;IACxD,GAAG,EAAE,cAAc,CAAC;IACpB,QAAQ,EAAE,cAAc,CAAC;CAC1B,GAAG,OAAO,CAAC,cAAc,CAAC,CA0D1B"}

package/src/channel/onboarding-migrate.js

@@ -0,0 +1,68 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Legacy groupAllowFrom migration for Feishu onboarding.
+ *
+ * Handles the migration of chat_id entries (oc_xxx) from
+ * groupAllowFrom to the groups config, preserving the original
+ * semantic of "allow this group for any sender".
+ */
+import { setFeishuGroups, setFeishuGroupAllowFrom } from './onboarding-config';
+/**
+ * Detect and migrate legacy chat_id entries in groupAllowFrom.
+ *
+ * Old semantic: groupAllowFrom contained chat_ids (oc_xxx) to control
+ * which groups could use the bot.
+ * New semantic: groupAllowFrom is for sender filtering (open_ids like ou_xxx).
+ *
+ * This function prompts the user and, if confirmed, moves chat_ids
+ * to the groups config and keeps only sender IDs in groupAllowFrom.
+ */
+export async function migrateLegacyGroupAllowFrom(params) {
+    let next = params.cfg;
+    const { prompter } = params;
+    const existingGroupAllowFrom = next.channels?.feishu?.groupAllowFrom ?? [];
+    const legacyChatIds = existingGroupAllowFrom.filter((e) => String(e).startsWith('oc_'));
+    const senderAllowFrom = existingGroupAllowFrom.filter((e) => !String(e).startsWith('oc_'));
+    if (legacyChatIds.length === 0) {
+        return next;
+    }
+    await prompter.note([
+        `⚠️  Detected legacy config: groupAllowFrom contains chat_ids (${legacyChatIds.join(', ')})`,
+        '',
+        'Old semantic: groupAllowFrom controlled which groups could use the bot.',
+        'New semantic: groupAllowFrom is for SENDER filtering (open_ids like ou_xxx).',
+        '',
+        'Recommended migration:',
+        `  1. Move chat_ids (oc_xxx) → channels.feishu.groups`,
+        `  2. Keep sender IDs (ou_xxx) in groupAllowFrom`,
+    ].join('\n'), 'Legacy config detected');
+    const migrate = await prompter.confirm({
+        message: `Migrate ${legacyChatIds.length} chat_id(s) to groups config?`,
+        initialValue: true,
+    });
+    if (migrate) {
+        const existingGroups = next.channels?.feishu?.groups ?? {};
+        const migratedGroups = {
+            ...existingGroups,
+        };
+        for (const chatId of legacyChatIds) {
+            if (!migratedGroups[String(chatId)]) {
+                migratedGroups[String(chatId)] = {
+                    enabled: true,
+                    groupPolicy: 'open',
+                };
+            }
+        }
+        next = setFeishuGroups(next, migratedGroups);
+        next = setFeishuGroupAllowFrom(next, senderAllowFrom);
+        await prompter.note(`✅ Migrated: ${legacyChatIds.length} chat_id(s) moved to groups, ` +
+            `${senderAllowFrom.length} sender(s) kept in groupAllowFrom`, 'Migration complete');
+    }
+    else {
+        await prompter.note('Skipped migration. Please update config manually to avoid issues.', 'Migration skipped');
+    }
+    return next;
+}
+//# sourceMappingURL=onboarding-migrate.js.map

package/src/channel/onboarding-migrate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"onboarding-migrate.js","sourceRoot":"","sources":["../../../src/channel/onboarding-migrate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAE/E;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAAC,MAGjD;IACC,IAAI,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC;IACtB,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC;IAE5B,MAAM,sBAAsB,GAAI,IAAI,CAAC,QAAQ,EAAE,MAAmC,EAAE,cAAc,IAAI,EAAE,CAAC;IACzG,MAAM,aAAa,GAAG,sBAAsB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;IACxF,MAAM,eAAe,GAAG,sBAAsB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;IAE3F,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,QAAQ,CAAC,IAAI,CACjB;QACE,iEAAiE,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;QAC5F,EAAE;QACF,yEAAyE;QACzE,8EAA8E;QAC9E,EAAE;QACF,wBAAwB;QACxB,sDAAsD;QACtD,iDAAiD;KAClD,CAAC,IAAI,CAAC,IAAI,CAAC,EACZ,wBAAwB,CACzB,CAAC;IAEF,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC;QACrC,OAAO,EAAE,WAAW,aAAa,CAAC,MAAM,+BAA+B;QACvE,YAAY,EAAE,IAAI;KACnB,CAAC,CAAC;IAEH,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,cAAc,GAAI,IAAI,CAAC,QAAQ,EAAE,MAAmC,EAAE,MAAM,IAAI,EAAE,CAAC;QACzF,MAAM,cAAc,GAAsC;YACxD,GAAG,cAAc;SAClB,CAAC;QACF,KAAK,MAAM,MAAM,IAAI,aAAa,EAAE,CAAC;YACnC,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;gBACpC,cAAc,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG;oBAC/B,OAAO,EAAE,IAAI;oBACb,WAAW,EAAE,MAAM;iBACC,CAAC;YACzB,CAAC;QACH,CAAC;QACD,IAAI,GAAG,eAAe,CAAC,IAAI,EAAE,cAAwC,CAAC,CAAC;QAEvE,IAAI,GAAG,uBAAuB,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;QAEtD,MAAM,QAAQ,CAAC,IAAI,CACjB,eAAe,aAAa,CAAC,MAAM,+BAA+B;YAChE,GAAG,eAAe,CAAC,MAAM,mCAAmC,EAC9D,oBAAoB,CACrB,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,MAAM,QAAQ,CAAC,IAAI,CAAC,mEAAmE,EAAE,mBAAmB,CAAC,CAAC;IAChH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/src/channel/onboarding.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Onboarding wizard adapter for the Feishu/Lark channel plugin.
+ *
+ * Implements the ChannelOnboardingAdapter interface so the `openclaw
+ * setup` wizard can configure Feishu credentials, domain, group
+ * policies, and DM allowlists interactively.
+ */
+import type { ChannelOnboardingAdapter } from 'openclaw/plugin-sdk';
+export declare const feishuOnboardingAdapter: ChannelOnboardingAdapter;
+//# sourceMappingURL=onboarding.d.ts.map

package/src/channel/onboarding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"onboarding.d.ts","sourceRoot":"","sources":["../../../src/channel/onboarding.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EACV,wBAAwB,EAIzB,MAAM,qBAAqB,CAAC;AAkL7B,eAAO,MAAM,uBAAuB,EAAE,wBA6KrC,CAAC"}