@larksuite/openclaw-lark 2026.3.9

package/src/channel/probe.js

@@ -0,0 +1,22 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+import { LarkClient } from '../core/lark-client';
+/**
+ * Probe the Feishu bot connection by calling the bot/v3/info API.
+ *
+ * Returns a result indicating whether the bot is reachable and its
+ * basic identity (name, open_id).  Used by onboarding and status
+ * checks to verify credentials before committing them to config.
+ */
+export async function probeFeishu(credentials) {
+    if (!credentials?.appId || !credentials?.appSecret) {
+        return {
+            ok: false,
+            error: 'missing credentials (appId, appSecret)',
+        };
+    }
+    return LarkClient.fromCredentials(credentials).probe();
+}
+//# sourceMappingURL=probe.js.map

package/src/channel/probe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"probe.js","sourceRoot":"","sources":["../../../src/channel/probe.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,UAAU,EAA8B,MAAM,qBAAqB,CAAC;AAE7E;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,WAAmC;IACnE,IAAI,CAAC,WAAW,EAAE,KAAK,IAAI,CAAC,WAAW,EAAE,SAAS,EAAE,CAAC;QACnD,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,wCAAwC;SAChD,CAAC;IACJ,CAAC;IAED,OAAO,UAAU,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC,KAAK,EAAE,CAAC;AACzD,CAAC"}

package/src/channel/types.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Channel type definitions for the Feishu/Lark channel plugin.
+ */
+import type { ClawdbotConfig, RuntimeEnv, HistoryEntry } from 'openclaw/plugin-sdk';
+import type { LarkClient } from '../core/lark-client';
+import type { MessageDedup } from '../messaging/inbound/dedup';
+export type { FeishuProbeResult } from '../core/types';
+export interface MonitorFeishuOpts {
+    config?: ClawdbotConfig;
+    runtime?: RuntimeEnv;
+    abortSignal?: AbortSignal;
+    accountId?: string;
+}
+export interface FeishuDirectoryPeer {
+    kind: 'user';
+    id: string;
+    name?: string;
+}
+export interface FeishuDirectoryGroup {
+    kind: 'group';
+    id: string;
+    name?: string;
+}
+export interface MonitorContext {
+    cfg: ClawdbotConfig;
+    lark: LarkClient;
+    accountId: string;
+    chatHistories: Map<string, HistoryEntry[]>;
+    messageDedup: MessageDedup;
+    runtime?: RuntimeEnv;
+    log: (...args: unknown[]) => void;
+    error: (...args: unknown[]) => void;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/channel/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACpF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAG/D,YAAY,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAMvD,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,OAAO,CAAC,EAAE,UAAU,CAAC;IACrB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAMD,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,OAAO,CAAC;IACd,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAMD,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,cAAc,CAAC;IACpB,IAAI,EAAE,UAAU,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC;IAC3C,YAAY,EAAE,YAAY,CAAC;IAC3B,OAAO,CAAC,EAAE,UAAU,CAAC;IACrB,GAAG,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IAClC,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;CACrC"}

package/src/channel/types.js

@@ -0,0 +1,8 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Channel type definitions for the Feishu/Lark channel plugin.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/src/channel/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/channel/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/src/commands/auth.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * feishu_auth command — 飞书用户权限批量授权命令实现
+ *
+ * 直接复用 onboarding-auth.ts 的 triggerOnboarding() 函数。
+ * 注意：此命令仅限应用 owner 执行（与 onboarding 逻辑一致）
+ */
+import type { OpenClawConfig } from 'openclaw/plugin-sdk';
+/**
+ * 执行飞书用户权限批量授权命令
+ * 直接调用 triggerOnboarding()，包含 owner 检查
+ */
+export declare function runFeishuAuth(config: OpenClawConfig): Promise<string>;
+//# sourceMappingURL=auth.d.ts.map

package/src/commands/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../../src/commands/auth.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAU1D;;;GAGG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAwE3E"}

package/src/commands/auth.js

@@ -0,0 +1,85 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * feishu_auth command — 飞书用户权限批量授权命令实现
+ *
+ * 直接复用 onboarding-auth.ts 的 triggerOnboarding() 函数。
+ * 注意：此命令仅限应用 owner 执行（与 onboarding 逻辑一致）
+ */
+import { triggerOnboarding } from '../tools/onboarding-auth';
+import { getTicket } from '../core/lark-ticket';
+import { getLarkAccount } from '../core/accounts';
+import { LarkClient } from '../core/lark-client';
+import { getAppInfo, getAppGrantedScopes } from '../core/app-scope-checker';
+import { getStoredToken } from '../core/token-store';
+import { filterSensitiveScopes } from '../core/tool-scopes';
+import { assertOwnerAccessStrict, OwnerAccessDeniedError } from '../core/owner-policy';
+/**
+ * 执行飞书用户权限批量授权命令
+ * 直接调用 triggerOnboarding()，包含 owner 检查
+ */
+export async function runFeishuAuth(config) {
+    const ticket = getTicket();
+    const senderOpenId = ticket?.senderOpenId;
+    if (!senderOpenId) {
+        return '❌ 无法获取用户身份，请在飞书对话中使用此命令';
+    }
+    // 提前检查 owner 身份，给出明确提示
+    const acct = getLarkAccount(config, ticket.accountId);
+    if (!acct.configured) {
+        return `❌ 账号 ${ticket.accountId} 配置不完整`;
+    }
+    const sdk = LarkClient.fromAccount(acct).sdk;
+    const { appId } = acct;
+    try {
+        await getAppInfo(sdk, appId);
+    }
+    catch {
+        const link = `https://open.feishu.cn/app/${appId}/auth?q=application:application:self_manage&op_from=feishu-openclaw&token_type=tenant`;
+        return `❌ 应用缺少核心权限 application:application:self_manage，无法查询可授权 scope 列表。\n\n请管理员在飞书开放平台开通此权限后重试：[申请权限](${link})`;
+    }
+    // Owner 检查（fail-close: 授权命令安全优先）
+    try {
+        await assertOwnerAccessStrict(acct, sdk, senderOpenId);
+    }
+    catch (err) {
+        if (err instanceof OwnerAccessDeniedError) {
+            return '❌ 此命令仅限应用 owner 执行\n\n如需授权，请联系应用管理员。';
+        }
+        throw err;
+    }
+    // 预检：是否还有未授权的 scope
+    let appScopes;
+    try {
+        appScopes = await getAppGrantedScopes(sdk, appId, 'user');
+    }
+    catch {
+        const link = `https://open.feishu.cn/app/${appId}/auth?q=application:application:self_manage&op_from=feishu-openclaw&token_type=tenant`;
+        return `❌ 应用缺少核心权限 application:application:self_manage，无法查询可授权 scope 列表。\n\n请管理员在飞书开放平台开通此权限后重试：[申请权限](${link})`;
+    }
+    // offline_access 预检 — OAuth 必须的前提权限
+    const allScopes = await getAppGrantedScopes(sdk, appId);
+    if (allScopes.length > 0 && !allScopes.includes('offline_access')) {
+        const link = `https://open.feishu.cn/app/${appId}/auth?q=offline_access&op_from=feishu-openclaw&token_type=user`;
+        return `❌ 应用缺少核心权限 offline_access，无法查询可授权 scope 列表。\n\n请管理员在飞书开放平台开通此权限后重试：[申请权限](${link})`;
+    }
+    appScopes = filterSensitiveScopes(appScopes);
+    if (appScopes.length === 0) {
+        return '当前应用未开通任何用户级权限，无需授权。';
+    }
+    const existing = await getStoredToken(appId, senderOpenId);
+    const grantedScopes = new Set(existing?.scope?.split(/\s+/).filter(Boolean) ?? []);
+    const missingScopes = appScopes.filter((s) => !grantedScopes.has(s));
+    if (missingScopes.length === 0) {
+        return `✅ 您已授权所有可用权限（共 ${appScopes.length} 个），无需重复授权。`;
+    }
+    // 调用 triggerOnboarding 执行批量授权
+    await triggerOnboarding({
+        cfg: config,
+        userOpenId: senderOpenId,
+        accountId: ticket.accountId,
+    });
+    return `✅ 已发送授权请求`;
+}
+//# sourceMappingURL=auth.js.map

package/src/commands/auth.js.map

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

package/src/commands/diagnose.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Diagnostic module for the Feishu/Lark plugin.
+ *
+ * Collects environment info, account configuration, API connectivity,
+ * app permissions, tool registration state, and recent error logs into
+ * a structured report that users can share with developers for
+ * remote troubleshooting.
+ */
+import type { OpenClawConfig } from 'openclaw/plugin-sdk';
+interface DiagLogger {
+    info: (message: string) => void;
+    warn: (message: string) => void;
+    error: (message: string) => void;
+}
+type CheckStatus = 'pass' | 'warn' | 'fail' | 'skip';
+interface DiagCheckResult {
+    name: string;
+    status: CheckStatus;
+    message: string;
+    details?: string;
+}
+interface AccountDiagResult {
+    accountId: string;
+    name?: string;
+    enabled: boolean;
+    configured: boolean;
+    appId?: string;
+    brand: string;
+    checks: DiagCheckResult[];
+}
+interface DiagReport {
+    timestamp: string;
+    environment: {
+        nodeVersion: string;
+        platform: string;
+        arch: string;
+        pluginVersion: string;
+    };
+    accounts: AccountDiagResult[];
+    toolsRegistered: string[];
+    recentErrors: string[];
+    overallStatus: 'healthy' | 'degraded' | 'unhealthy';
+    checks: DiagCheckResult[];
+}
+export declare function runDiagnosis(params: {
+    config: OpenClawConfig;
+    logger?: DiagLogger;
+}): Promise<DiagReport>;
+export declare function formatDiagReportText(report: DiagReport): string;
+/**
+ * Extract all log lines tagged with a specific message_id from gateway.log.
+ *
+ * Scans the last 1MB of the log file for lines containing `[msg:{messageId}]`.
+ * Returns matching lines in chronological order.
+ */
+export declare function traceByMessageId(messageId: string): Promise<string[]>;
+/**
+ * Format trace output for CLI display.
+ */
+export declare function formatTraceOutput(lines: string[], messageId: string): string;
+/**
+ * Analyze trace log lines and produce a structured CLI report.
+ */
+export declare function analyzeTrace(lines: string[], _messageId: string): string;
+export declare function formatDiagReportCli(report: DiagReport): string;
+export {};
+//# sourceMappingURL=diagnose.d.ts.map

package/src/commands/diagnose.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnose.d.ts","sourceRoot":"","sources":["../../../src/commands/diagnose.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,UAAU,UAAU;IAClB,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAClC;AAsBD,KAAK,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAErD,UAAU,eAAe;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,UAAU,iBAAiB;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,OAAO,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B;AAED,UAAU,UAAU;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE;QACX,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,aAAa,EAAE,SAAS,GAAG,UAAU,GAAG,WAAW,CAAC;IACpD,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B;AAkMD,wBAAsB,YAAY,CAAC,MAAM,EAAE;IAAE,MAAM,EAAE,cAAc,CAAC;IAAC,MAAM,CAAC,EAAE,UAAU,CAAA;CAAE,GAAG,OAAO,CAAC,UAAU,CAAC,CA6E/G;AAqBD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAmE/D;AAkCD;;;;;GAKG;AACH,wBAAsB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAyB3E;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAuB5E;AA2GD;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CA6OxE;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAmE9D"}