@openclaw/feishu 2026.5.27 → 2026.5.28-beta.1

package/dist/api.js

@@ -2,9 +2,9 @@ import { a as parseFeishuTargetId, i as parseFeishuDirectConversationId, n as bu
 import { n as getFeishuThreadBindingManager, r as testing, t as createFeishuThreadBindingManager } from "./thread-bindings-D24m3Cjy.js";
 import { n as handleFeishuSubagentEnded, r as handleFeishuSubagentSpawning, t as handleFeishuSubagentDeliveryTarget } from "./subagent-hooks-fuyBHOVu.js";
 import { r as listEnabledFeishuAccounts } from "./accounts-CXnY5H8g.js";
-import { a as setFeishuNamedAccountEnabled, i as feishuSetupAdapter, n as feishuSetupWizard, r as runFeishuLogin, t as feishuPlugin } from "./channel-DS2vP1nr.js";
+import { a as setFeishuNamedAccountEnabled, i as feishuSetupAdapter, n as feishuSetupWizard, r as runFeishuLogin, t as feishuPlugin } from "./channel-DLfxURF2.js";
 import { t as getFeishuRuntime } from "./runtime-C5JxBWZp.js";
-import { a as jsonToolResult, d as registerFeishuChatTools, f as createFeishuToolClient, m as resolveFeishuToolAccount, n as registerFeishuDriveTools, o as toolExecutionErrorResult, p as resolveAnyEnabledFeishuToolsConfig, s as unknownToolActionResult } from "./drive-DwgWWkJi.js";
+import { a as jsonToolResult, d as registerFeishuChatTools, f as createFeishuToolClient, m as resolveFeishuToolAccount, n as registerFeishuDriveTools, o as toolExecutionErrorResult, p as resolveAnyEnabledFeishuToolsConfig, s as unknownToolActionResult } from "./drive-Grnpj510.js";
 import { normalizeLowercaseStringOrEmpty, normalizeOptionalString, readStringValue, uniqueStrings } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { existsSync } from "node:fs";
 import { homedir } from "node:os";

package/dist/{channel-DS2vP1nr.js → channel-DLfxURF2.js}

@@ -1647,7 +1647,7 @@ const feishuSetupWizard = {
 			});
 			let probeResult = null;
 			if (configured && account.configured) try {
-				const { probeFeishu } = await import("./probe-Da81t6a5.js").then((n) => n.n);
+				const { probeFeishu } = await import("./probe-RvCg70BY.js").then((n) => n.n);
 				probeResult = await probeFeishu(account);
 			} catch {}
 			if (!configured) return [formatFeishuStatusLine("needs-credentials")];
@@ -1722,7 +1722,7 @@ const meta = {
 	aliases: ["lark"],
 	order: 70
 };
-const loadFeishuChannelRuntime = createLazyRuntimeNamedExport(() => import("./channel.runtime-CxRDzbEQ.js"), "feishuChannelRuntime");
+const loadFeishuChannelRuntime = createLazyRuntimeNamedExport(() => import("./channel.runtime-i-X8-ZXc.js"), "feishuChannelRuntime");
 function toFeishuMessageSendResult(result, kind) {
 	const receipt = result.receipt ?? createFeishuSendReceipt({
 		messageId: result.messageId,
@@ -1754,7 +1754,7 @@ const feishuMessageAdapter = defineChannelMessageAdapter({
 	}
 });
 async function createFeishuActionClient(account) {
-	const { createFeishuClient } = await import("./client-BnH2fRL2.js").then((n) => n.t);
+	const { createFeishuClient } = await import("./client-DcSzLkSX.js").then((n) => n.t);
 	return createFeishuClient(account);
 }
 const collectFeishuSecurityWarnings = createAllowlistProviderGroupPolicyWarningCollector({
@@ -1960,13 +1960,17 @@ function readFirstString(params, keys, fallback) {
 	}
 	if (typeof fallback === "string" && fallback.trim()) return fallback.trim();
 }
-function readOptionalNumber(params, keys) {
+function isPositiveSafeInteger(value) {
+	return Number.isSafeInteger(value) && value > 0;
+}
+function readOptionalPositiveInteger(params, keys) {
 	for (const key of keys) {
 		const value = params[key];
-		if (typeof value === "number" && Number.isFinite(value)) return value;
+		if (typeof value === "number" && isPositiveSafeInteger(value)) return value;
 		if (typeof value === "string" && value.trim()) {
-			const parsed = Number(value);
-			if (Number.isFinite(parsed)) return parsed;
+			const trimmed = value.trim();
+			const parsed = /^\d+$/.test(trimmed) ? Number(trimmed) : NaN;
+			if (isPositiveSafeInteger(parsed)) return parsed;
 		}
 	}
 }
@@ -2262,7 +2266,7 @@ const feishuPlugin = createChatChannelPlugin({
 							chatId,
 							startTime: readFirstString(ctx.params, ["startTime", "start_time"]),
 							endTime: readFirstString(ctx.params, ["endTime", "end_time"]),
-							pageSize: readOptionalNumber(ctx.params, ["pageSize", "page_size"]),
+							pageSize: readOptionalPositiveInteger(ctx.params, ["pageSize", "page_size"]),
 							pageToken: readFirstString(ctx.params, ["pageToken", "page_token"]),
 							accountId: ctx.accountId ?? void 0
 						})
@@ -2285,7 +2289,7 @@ const feishuPlugin = createChatChannelPlugin({
 						provider: "feishu",
 						action: "channel-info",
 						channel,
-						members: await runtime.getChatMembers(client, chatId, readOptionalNumber(ctx.params, ["pageSize", "page_size"]), readFirstString(ctx.params, ["pageToken", "page_token"]), resolveFeishuMemberIdType(ctx.params))
+						members: await runtime.getChatMembers(client, chatId, readOptionalPositiveInteger(ctx.params, ["pageSize", "page_size"]), readFirstString(ctx.params, ["pageToken", "page_token"]), resolveFeishuMemberIdType(ctx.params))
 					});
 				}
 				if (ctx.action === "member-info") {
@@ -2304,13 +2308,13 @@ const feishuPlugin = createChatChannelPlugin({
 						ok: true,
 						channel: "feishu",
 						action: "member-info",
-						...await runtime.getChatMembers(client, chatId, readOptionalNumber(ctx.params, ["pageSize", "page_size"]), readFirstString(ctx.params, ["pageToken", "page_token"]), resolveFeishuMemberIdType(ctx.params))
+						...await runtime.getChatMembers(client, chatId, readOptionalPositiveInteger(ctx.params, ["pageSize", "page_size"]), readFirstString(ctx.params, ["pageToken", "page_token"]), resolveFeishuMemberIdType(ctx.params))
 					});
 				}
 				if (ctx.action === "channel-list") {
 					const runtime = await loadFeishuChannelRuntime();
 					const query = readFirstString(ctx.params, ["query"]);
-					const limit = readOptionalNumber(ctx.params, ["limit"]);
+					const limit = readOptionalPositiveInteger(ctx.params, ["limit"]);
 					const scope = readFirstString(ctx.params, ["scope", "kind"]) ?? "all";
 					if (scope === "groups" || scope === "group" || scope === "channels" || scope === "channel") return jsonActionResult({
 						ok: true,
@@ -2542,7 +2546,7 @@ const feishuPlugin = createChatChannelPlugin({
 			})
 		}),
 		gateway: { startAccount: async (ctx) => {
-			const { monitorFeishuProvider } = await import("./monitor-DNYcF9wy.js");
+			const { monitorFeishuProvider } = await import("./monitor-w8w3-7EH.js");
 			const account = resolveFeishuRuntimeAccount({
 				cfg: ctx.cfg,
 				accountId: ctx.accountId

package/dist/channel-plugin-api.js

@@ -1,2 +1,2 @@
-import { t as feishuPlugin } from "./channel-DS2vP1nr.js";
+import { t as feishuPlugin } from "./channel-DLfxURF2.js";
 export { feishuPlugin };

package/dist/{channel.runtime-CxRDzbEQ.js → channel.runtime-i-X8-ZXc.js}

@@ -1,10 +1,10 @@
 import { o as resolveFeishuAccount, s as resolveFeishuRuntimeAccount, y as parseFeishuCommentTarget } from "./accounts-CXnY5H8g.js";
-import { h as listFeishuDirectoryPeers, m as listFeishuDirectoryGroups, o as buildFeishuPresentationCardElements } from "./channel-DS2vP1nr.js";
-import { r as createFeishuClient } from "./client-BnH2fRL2.js";
-import { c as getChatInfo, l as getChatMembers, r as cleanupAmbientCommentTypingReaction, t as deliverCommentThreadText, u as getFeishuMemberInfo } from "./drive-DwgWWkJi.js";
+import { h as listFeishuDirectoryPeers, m as listFeishuDirectoryGroups, o as buildFeishuPresentationCardElements } from "./channel-DLfxURF2.js";
+import { r as createFeishuClient } from "./client-DcSzLkSX.js";
+import { c as getChatInfo, l as getChatMembers, r as cleanupAmbientCommentTypingReaction, t as deliverCommentThreadText, u as getFeishuMemberInfo } from "./drive-Grnpj510.js";
 import { chunkTextForOutbound } from "./runtime-api.js";
-import { a as sendCardFeishu, c as sendStructuredCardFeishu, g as shouldSuppressFeishuTextForVoiceMedia, h as sendMediaFeishu, i as resolveFeishuCardTemplate, n as getMessageFeishu, o as sendMarkdownCardFeishu, s as sendMessageFeishu, t as editMessageFeishu } from "./send-jDh7bucI.js";
-import { t as probeFeishu } from "./probe-Da81t6a5.js";
+import { a as sendCardFeishu, c as sendStructuredCardFeishu, g as shouldSuppressFeishuTextForVoiceMedia, h as sendMediaFeishu, i as resolveFeishuCardTemplate, n as getMessageFeishu, o as sendMarkdownCardFeishu, s as sendMessageFeishu, t as editMessageFeishu } from "./send-CKZz15KQ.js";
+import { t as probeFeishu } from "./probe-RvCg70BY.js";
 import { isRecord, normalizeLowercaseStringOrEmpty, normalizeStringEntries } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { interactiveReplyToPresentation, normalizeInteractiveReply, normalizeMessagePresentation, renderMessagePresentationFallbackText, resolveInteractiveTextFallback } from "openclaw/plugin-sdk/interactive-runtime";
 import path from "node:path";

package/dist/{client-BnH2fRL2.js → client-DcSzLkSX.js}

@@ -2,6 +2,7 @@ import { t as __exportAll } from "./rolldown-runtime-8H4AJuhK.js";
 import { createRequire } from "node:module";
 import * as Lark from "@larksuiteoapi/node-sdk";
 import { readPluginPackageVersion, resolveAmbientNodeProxyAgent } from "openclaw/plugin-sdk/extension-shared";
+import { parseStrictPositiveInteger } from "openclaw/plugin-sdk/number-runtime";
 //#region extensions/feishu/src/client-timeout.ts
 /** Default HTTP timeout for Feishu API requests (30 seconds). */
 const FEISHU_HTTP_TIMEOUT_MS = 3e4;
@@ -15,8 +16,8 @@ function resolveConfiguredHttpTimeoutMs(creds) {
 	if (typeof fromDirectField === "number" && Number.isFinite(fromDirectField) && fromDirectField > 0) return clampTimeout(fromDirectField);
 	const envRaw = process.env[FEISHU_HTTP_TIMEOUT_ENV_VAR];
 	if (envRaw) {
-		const envValue = Number(envRaw);
-		if (Number.isFinite(envValue) && envValue > 0) return clampTimeout(envValue);
+		const envValue = parseStrictPositiveInteger(envRaw);
+		if (envValue !== void 0) return clampTimeout(envValue);
 	}
 	const timeout = creds.config?.httpTimeoutMs;
 	if (typeof timeout !== "number" || !Number.isFinite(timeout) || timeout <= 0) return FEISHU_HTTP_TIMEOUT_MS;

package/dist/{drive-DwgWWkJi.js → drive-Grnpj510.js}

@@ -1,5 +1,5 @@
 import { d as formatFeishuApiError, f as isRecord$1, h as readString, i as listFeishuAccountIds, l as encodeQuery, o as resolveFeishuAccount, r as listEnabledFeishuAccounts, s as resolveFeishuRuntimeAccount, u as extractReplyText, y as parseFeishuCommentTarget } from "./accounts-CXnY5H8g.js";
-import { r as createFeishuClient } from "./client-BnH2fRL2.js";
+import { r as createFeishuClient } from "./client-DcSzLkSX.js";
 import { normalizeOptionalString } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
 import { Type } from "typebox";

package/dist/{monitor-DNYcF9wy.js → monitor-w8w3-7EH.js}

@@ -1,9 +1,9 @@
 import { r as listEnabledFeishuAccounts, s as resolveFeishuRuntimeAccount } from "./accounts-CXnY5H8g.js";
-import { l as fetchBotIdentityForMonitor } from "./monitor.state-CxrHFQX2.js";
+import { l as fetchBotIdentityForMonitor } from "./monitor.state-B6SoAUys.js";
 //#region extensions/feishu/src/monitor.ts
 let monitorAccountRuntimePromise;
 async function loadMonitorAccountRuntime() {
-	monitorAccountRuntimePromise ??= import("./monitor.account-vUWzYlT_.js");
+	monitorAccountRuntimePromise ??= import("./monitor.account-tuA8NuVQ.js");
 	return await monitorAccountRuntimePromise;
 }
 async function monitorFeishuProvider(opts = {}) {

package/dist/{monitor.account-vUWzYlT_.js → monitor.account-tuA8NuVQ.js}

@@ -2,15 +2,15 @@ import { t as buildFeishuConversationId } from "./conversation-id-DuL575sn.js";
 import { i as resolveReceiveIdType } from "./targets-BUjQ1TcA.js";
 import { t as createFeishuThreadBindingManager } from "./thread-bindings-D24m3Cjy.js";
 import { _ as buildFeishuCommentTarget, f as isRecord$1, h as readString, l as encodeQuery, m as parseCommentContentElements, p as normalizeString, s as resolveFeishuRuntimeAccount, u as extractReplyText, v as normalizeCommentFileType } from "./accounts-CXnY5H8g.js";
-import { c as normalizeFeishuAllowEntry, d as resolveFeishuGroupConversationIngressAccess, f as resolveFeishuGroupSenderActivationIngressAccess, l as resolveFeishuDmIngressAccess, p as resolveFeishuReplyPolicy, s as hasExplicitFeishuGroupConfig, u as resolveFeishuGroupConfig } from "./channel-DS2vP1nr.js";
+import { c as normalizeFeishuAllowEntry, d as resolveFeishuGroupConversationIngressAccess, f as resolveFeishuGroupSenderActivationIngressAccess, l as resolveFeishuDmIngressAccess, p as resolveFeishuReplyPolicy, s as hasExplicitFeishuGroupConfig, u as resolveFeishuGroupConfig } from "./channel-DLfxURF2.js";
 import { c as decodeFeishuCardAction, o as buildFeishuCardActionTextFallback, s as createFeishuCardInteractionEnvelope } from "./send-result-DSTSkRDM.js";
 import { t as getFeishuRuntime } from "./runtime-C5JxBWZp.js";
-import { a as getFeishuUserAgent, i as createFeishuWSClient, n as createEventDispatcher, r as createFeishuClient } from "./client-BnH2fRL2.js";
-import { c as getChatInfo, i as createCommentTypingReactionLifecycle, t as deliverCommentThreadText } from "./drive-DwgWWkJi.js";
+import { a as getFeishuUserAgent, i as createFeishuWSClient, n as createEventDispatcher, r as createFeishuClient } from "./client-DcSzLkSX.js";
+import { c as getChatInfo, i as createCommentTypingReactionLifecycle, t as deliverCommentThreadText } from "./drive-Grnpj510.js";
 import { createReplyPrefixContext, evaluateSupplementalContextVisibility, loadSessionStore, normalizeAgentId as normalizeAgentId$2, resolveChannelContextVisibilityMode, resolveSessionStoreEntry } from "./runtime-api.js";
-import { _ as normalizeFeishuExternalKey, a as sendCardFeishu, c as sendStructuredCardFeishu, d as isFeishuBroadcastMention, f as isMentionForwardRequest, g as shouldSuppressFeishuTextForVoiceMedia, h as sendMediaFeishu, i as resolveFeishuCardTemplate, l as parsePostContent, m as saveMessageResourceFeishu, n as getMessageFeishu, p as isFeishuGroupChatType, r as listFeishuThreadMessages, s as sendMessageFeishu, u as extractMentionTargets } from "./send-jDh7bucI.js";
-import { i as waitForAbortableDelay, r as raceWithTimeoutAndAbort } from "./probe-Da81t6a5.js";
-import { a as feishuWebhookRateLimiter, c as wsClients, i as botOpenIds, l as fetchBotIdentityForMonitor, n as FEISHU_WEBHOOK_MAX_BODY_BYTES, o as httpServers, r as botNames, s as recordWebhookStatus, t as FEISHU_WEBHOOK_BODY_TIMEOUT_MS } from "./monitor.state-CxrHFQX2.js";
+import { _ as normalizeFeishuExternalKey, a as sendCardFeishu, c as sendStructuredCardFeishu, d as isFeishuBroadcastMention, f as isMentionForwardRequest, g as shouldSuppressFeishuTextForVoiceMedia, h as sendMediaFeishu, i as resolveFeishuCardTemplate, l as parsePostContent, m as saveMessageResourceFeishu, n as getMessageFeishu, p as isFeishuGroupChatType, r as listFeishuThreadMessages, s as sendMessageFeishu, u as extractMentionTargets } from "./send-CKZz15KQ.js";
+import { i as waitForAbortableDelay, r as raceWithTimeoutAndAbort } from "./probe-RvCg70BY.js";
+import { a as feishuWebhookRateLimiter, c as wsClients, i as botOpenIds, l as fetchBotIdentityForMonitor, n as FEISHU_WEBHOOK_MAX_BODY_BYTES, o as httpServers, r as botNames, s as recordWebhookStatus, t as FEISHU_WEBHOOK_BODY_TIMEOUT_MS } from "./monitor.state-B6SoAUys.js";
 import { asBoolean, asNullableRecord, isRecord, normalizeLowercaseStringOrEmpty, normalizeOptionalLowercaseString, normalizeOptionalString, readStringValue, uniqueStrings } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { ensureConfiguredBindingRouteReady, resolveConfiguredBindingRoute, resolveRuntimeConversationBindingRoute } from "openclaw/plugin-sdk/conversation-runtime";
 import { resolveInboundLastRouteSessionKey } from "openclaw/plugin-sdk/routing";
@@ -22,6 +22,7 @@ import os from "node:os";
 import path from "node:path";
 import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
 import * as Lark from "@larksuiteoapi/node-sdk";
+import { parseStrictNonNegativeInteger } from "openclaw/plugin-sdk/number-runtime";
 import { createPersistentDedupe } from "openclaw/plugin-sdk/persistent-dedupe";
 import { applyBasicWebhookRequestGuards, resolveRequestClientIp } from "openclaw/plugin-sdk/webhook-ingress";
 import { fetchWithSsrFGuard } from "openclaw/plugin-sdk/ssrf-runtime";
@@ -4074,8 +4075,7 @@ function buildCommentSessionKey(params) {
 	});
 }
 function parseTimestampMs(value) {
-	const parsed = value ? Number.parseInt(value, 10) : NaN;
-	return Number.isFinite(parsed) ? parsed : Date.now();
+	return parseStrictNonNegativeInteger(value) ?? Date.now();
 }
 async function handleFeishuCommentEvent(params) {
 	const account = resolveFeishuRuntimeAccount({

package/dist/{monitor.state-CxrHFQX2.js → monitor.state-B6SoAUys.js}

@@ -1,14 +1,15 @@
-import { t as probeFeishu } from "./probe-Da81t6a5.js";
+import { t as probeFeishu } from "./probe-RvCg70BY.js";
 import { normalizeLowercaseStringOrEmpty } from "openclaw/plugin-sdk/string-coerce-runtime";
+import { parseStrictPositiveInteger } from "openclaw/plugin-sdk/number-runtime";
 import { WEBHOOK_ANOMALY_COUNTER_DEFAULTS, WEBHOOK_RATE_LIMIT_DEFAULTS, createFixedWindowRateLimiter, createWebhookAnomalyTracker } from "openclaw/plugin-sdk/webhook-ingress";
 //#region extensions/feishu/src/monitor.startup.ts
 const FEISHU_STARTUP_BOT_INFO_TIMEOUT_DEFAULT_MS = 3e4;
 const FEISHU_STARTUP_BOT_INFO_TIMEOUT_ENV = "OPENCLAW_FEISHU_STARTUP_PROBE_TIMEOUT_MS";
-function resolveStartupProbeTimeoutMs() {
-	const raw = process.env[FEISHU_STARTUP_BOT_INFO_TIMEOUT_ENV];
+function resolveStartupProbeTimeoutMs(env = process.env) {
+	const raw = env[FEISHU_STARTUP_BOT_INFO_TIMEOUT_ENV];
 	if (raw) {
-		const parsed = Number(raw);
-		if (Number.isFinite(parsed) && parsed > 0) return Math.floor(parsed);
+		const parsed = parseStrictPositiveInteger(raw);
+		if (parsed !== void 0) return parsed;
 		console.warn(`[feishu] ${FEISHU_STARTUP_BOT_INFO_TIMEOUT_ENV}="${raw}" is invalid; using default ${FEISHU_STARTUP_BOT_INFO_TIMEOUT_DEFAULT_MS}ms`);
 	}
 	return FEISHU_STARTUP_BOT_INFO_TIMEOUT_DEFAULT_MS;

package/dist/{probe-Da81t6a5.js → probe-RvCg70BY.js}

@@ -1,5 +1,5 @@
 import { t as __exportAll } from "./rolldown-runtime-8H4AJuhK.js";
-import { r as createFeishuClient } from "./client-BnH2fRL2.js";
+import { r as createFeishuClient } from "./client-DcSzLkSX.js";
 import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
 //#region extensions/feishu/src/async.ts
 const RACE_TIMEOUT = Symbol("race-timeout");

package/dist/{send-jDh7bucI.js → send-CKZz15KQ.js}

@@ -2,7 +2,7 @@ import { i as resolveReceiveIdType, r as normalizeFeishuTarget } from "./targets
 import { c as createFeishuApiError, f as isRecord$1, g as requestFeishuApi, s as resolveFeishuRuntimeAccount } from "./accounts-CXnY5H8g.js";
 import { i as toFeishuSendResult, r as resolveFeishuReceiptKind, t as assertFeishuMessageApiSuccess } from "./send-result-DSTSkRDM.js";
 import { t as getFeishuRuntime } from "./runtime-C5JxBWZp.js";
-import { r as createFeishuClient } from "./client-BnH2fRL2.js";
+import { r as createFeishuClient } from "./client-DcSzLkSX.js";
 import { isRecord, normalizeLowercaseStringOrEmpty, normalizeOptionalLowercaseString } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { convertMarkdownTables } from "openclaw/plugin-sdk/text-chunking";
 import fs from "node:fs";

package/dist/setup-api.js

@@ -1,2 +1,2 @@
-import { i as feishuSetupAdapter, n as feishuSetupWizard, t as feishuPlugin } from "./channel-DS2vP1nr.js";
+import { i as feishuSetupAdapter, n as feishuSetupWizard, t as feishuPlugin } from "./channel-DLfxURF2.js";
 export { feishuPlugin, feishuSetupAdapter, feishuSetupWizard };

package/node_modules/@larksuiteoapi/node-sdk/README.md

@@ -691,6 +691,10 @@ try {
 | signal | `AbortSignal` to cancel the polling | AbortSignal | No | - |
 | onQRCodeReady | Callback when the verification URL is ready. Receives `{ url, expireIn }`. You can render the URL as a QR code for users to scan, or display it as a link | function | Yes | - |
 | onStatusChange | Callback on polling status changes. Receives `{ status, interval? }`. Status values: `polling`, `slow_down`, `domain_switched` | function | No | - |
+| appPreset | Pre-fill values for the app-creation page. All fields are optional; users can still edit them on the page | AppPreset | No | - |
+| appPreset.avatar | App avatar URL(s). 1-6 URLs supported; the first one is selected by default. Allowed formats: png / jpg / jpeg / webp / gif (gif is sampled to a single frame, not animated) | string \| string[] | No | - |
+| appPreset.name | App name. Supports the `{user}` placeholder (replaced with the scanning user's name) | string | No | - |
+| appPreset.desc | App description. Supports the `{user}` placeholder | string | No | - |
 
 #### Return value
 

package/node_modules/@larksuiteoapi/node-sdk/README.zh.md

@@ -753,6 +753,10 @@ try {
 | signal         | 用于取消轮询的 `AbortSignal`                                                                    | AbortSignal | 否  | -                        |
 | onQRCodeReady  | 验证链接就绪时的回调，参数为 `{ url, expireIn }`。可将 URL 渲染为二维码供用户扫码，或直接作为链接展示                          | function    | 是  | -                        |
 | onStatusChange | 轮询状态变化时的回调，参数为 `{ status, interval? }`。status 取值：`polling`、`slow_down`、`domain_switched` | function    | 否  | -                        |
+| appPreset      | 预设应用信息（头像、名称、描述）。所有字段都是可选的，用户扫码后仍可在页面手动修改                                                  | AppPreset   | 否  | -                        |
+| appPreset.avatar | 应用头像 URL，支持 1-6 个；传多个时默认选中第一个。支持 png / jpg / jpeg / webp / gif（gif 自动取一帧，不保留动图）           | string \| string[] | 否  | -                |
+| appPreset.name | 应用名称，支持 `{user}` 占位符（替换为扫码用户名称）                                                              | string      | 否  | -                        |
+| appPreset.desc | 应用描述，支持 `{user}` 占位符                                                                          | string      | 否  | -                        |
 
 #### 返回值
 

package/node_modules/@larksuiteoapi/node-sdk/es/index.js

@@ -89750,6 +89750,35 @@ const SDK_NAME = 'node-sdk';
 const DEFAULT_FEISHU_DOMAIN = 'accounts.feishu.cn';
 const DEFAULT_LARK_DOMAIN = 'accounts.larksuite.com';
 const ENDPOINT = '/oauth/v1/app/registration';
+const AVATAR_MAX_COUNT = 6;
+/**
+ * Append `avatar` / `name` / `desc` query params to the QR code URL.
+ * `URLSearchParams` handles URL encoding automatically.
+ */
+function applyAppPreset(qrCodeUrl, preset) {
+    const { avatar, name, desc } = preset;
+    if (avatar !== undefined) {
+        const avatars = Array.isArray(avatar) ? avatar : [avatar];
+        if (avatars.length === 0) {
+            throw new Error('appPreset.avatar must contain at least 1 URL');
+        }
+        if (avatars.length > AVATAR_MAX_COUNT) {
+            throw new Error(`appPreset.avatar supports at most ${AVATAR_MAX_COUNT} URLs, got ${avatars.length}`);
+        }
+        avatars.forEach((url, idx) => {
+            if (typeof url !== 'string' || url === '') {
+                throw new Error(`appPreset.avatar[${idx}] must be a non-empty string`);
+            }
+            qrCodeUrl.searchParams.append('avatar', url);
+        });
+    }
+    if (name !== undefined) {
+        qrCodeUrl.searchParams.set('name', name);
+    }
+    if (desc !== undefined) {
+        qrCodeUrl.searchParams.set('desc', desc);
+    }
+}
 function requestRegistration(baseUrl, params) {
     var _a;
     return __awaiter(this, void 0, void 0, function* () {
@@ -89867,13 +89896,16 @@ function startPolling(ctx) {
 function registerApp(options) {
     var _a, _b, _c, _d;
     return __awaiter(this, void 0, void 0, function* () {
-        const { domain, source, signal, onQRCodeReady, onStatusChange } = options;
+        const { domain, source, signal, onQRCodeReady, onStatusChange, appPreset } = options;
         const baseUrl = `https://${domain !== null && domain !== void 0 ? domain : DEFAULT_FEISHU_DOMAIN}`;
         const beginRes = yield begin(baseUrl);
         const qrCodeUrl = new URL(beginRes.verification_uri_complete);
         qrCodeUrl.searchParams.set('from', 'sdk');
         qrCodeUrl.searchParams.set('source', source ? `${SDK_NAME}/${source}` : SDK_NAME);
         qrCodeUrl.searchParams.set('tp', 'sdk');
+        if (appPreset) {
+            applyAppPreset(qrCodeUrl, appPreset);
+        }
         onQRCodeReady({
             url: qrCodeUrl.toString(),
             expireIn: (_a = beginRes.expires_in) !== null && _a !== void 0 ? _a : 600,

package/node_modules/@larksuiteoapi/node-sdk/lib/index.js

@@ -89768,6 +89768,35 @@ const SDK_NAME = 'node-sdk';
 const DEFAULT_FEISHU_DOMAIN = 'accounts.feishu.cn';
 const DEFAULT_LARK_DOMAIN = 'accounts.larksuite.com';
 const ENDPOINT = '/oauth/v1/app/registration';
+const AVATAR_MAX_COUNT = 6;
+/**
+ * Append `avatar` / `name` / `desc` query params to the QR code URL.
+ * `URLSearchParams` handles URL encoding automatically.
+ */
+function applyAppPreset(qrCodeUrl, preset) {
+    const { avatar, name, desc } = preset;
+    if (avatar !== undefined) {
+        const avatars = Array.isArray(avatar) ? avatar : [avatar];
+        if (avatars.length === 0) {
+            throw new Error('appPreset.avatar must contain at least 1 URL');
+        }
+        if (avatars.length > AVATAR_MAX_COUNT) {
+            throw new Error(`appPreset.avatar supports at most ${AVATAR_MAX_COUNT} URLs, got ${avatars.length}`);
+        }
+        avatars.forEach((url, idx) => {
+            if (typeof url !== 'string' || url === '') {
+                throw new Error(`appPreset.avatar[${idx}] must be a non-empty string`);
+            }
+            qrCodeUrl.searchParams.append('avatar', url);
+        });
+    }
+    if (name !== undefined) {
+        qrCodeUrl.searchParams.set('name', name);
+    }
+    if (desc !== undefined) {
+        qrCodeUrl.searchParams.set('desc', desc);
+    }
+}
 function requestRegistration(baseUrl, params) {
     var _a;
     return __awaiter(this, void 0, void 0, function* () {
@@ -89885,13 +89914,16 @@ function startPolling(ctx) {
 function registerApp(options) {
     var _a, _b, _c, _d;
     return __awaiter(this, void 0, void 0, function* () {
-        const { domain, source, signal, onQRCodeReady, onStatusChange } = options;
+        const { domain, source, signal, onQRCodeReady, onStatusChange, appPreset } = options;
         const baseUrl = `https://${domain !== null && domain !== void 0 ? domain : DEFAULT_FEISHU_DOMAIN}`;
         const beginRes = yield begin(baseUrl);
         const qrCodeUrl = new URL(beginRes.verification_uri_complete);
         qrCodeUrl.searchParams.set('from', 'sdk');
         qrCodeUrl.searchParams.set('source', source ? `${SDK_NAME}/${source}` : SDK_NAME);
         qrCodeUrl.searchParams.set('tp', 'sdk');
+        if (appPreset) {
+            applyAppPreset(qrCodeUrl, appPreset);
+        }
         onQRCodeReady({
             url: qrCodeUrl.toString(),
             expireIn: (_a = beginRes.expires_in) !== null && _a !== void 0 ? _a : 600,

package/node_modules/@larksuiteoapi/node-sdk/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@larksuiteoapi/node-sdk",
-  "version": "1.65.0",
+  "version": "1.66.0",
   "description": "larksuite open sdk for nodejs",
   "keywords": [
     "feishu",

package/node_modules/@larksuiteoapi/node-sdk/types/index.d.ts

@@ -300741,6 +300741,23 @@ interface StatusChangeInfo {
     status: 'polling' | 'slow_down' | 'domain_switched';
     interval?: number;
 }
+/**
+ * Pre-fill values shown on the app-creation page after the user scans the QR
+ * code. All fields are optional and the user can still edit them on the page;
+ * the final values are whatever the user submits.
+ */
+interface AppPreset {
+    /**
+     * App avatar URL(s). Pass a single URL or 1-6 URLs. The first one is the
+     * default selection. Each URL must point to a publicly reachable image
+     * (png / jpg / jpeg / webp / gif).
+     */
+    avatar?: string | string[];
+    /** App name. Supports `{user}` placeholder, replaced with the scanning user's name. */
+    name?: string;
+    /** App description. Supports `{user}` placeholder. */
+    desc?: string;
+}
 interface RegisterAppOptions {
     domain?: string;
     larkDomain?: string;
@@ -300748,6 +300765,8 @@ interface RegisterAppOptions {
     signal?: AbortSignal;
     onQRCodeReady: (info: QRCodeInfo) => void;
     onStatusChange?: (info: StatusChangeInfo) => void;
+    /** Pre-fill values for the app-creation page. See {@link AppPreset}. */
+    appPreset?: AppPreset;
 }
 interface UserInfo {
     open_id?: string;

package/npm-shrinkwrap.json

@@ -1,19 +1,19 @@
 {
   "name": "@openclaw/feishu",
-  "version": "2026.5.27",
+  "version": "2026.5.28-beta.1",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@openclaw/feishu",
-      "version": "2026.5.27",
+      "version": "2026.5.28-beta.1",
       "dependencies": {
-        "@larksuiteoapi/node-sdk": "1.65.0",
+        "@larksuiteoapi/node-sdk": "1.66.0",
         "typebox": "1.1.38",
         "zod": "4.4.3"
       },
       "peerDependencies": {
-        "openclaw": ">=2026.5.27"
+        "openclaw": ">=2026.5.28-beta.1"
       },
       "peerDependenciesMeta": {
         "openclaw": {
@@ -22,9 +22,9 @@
       }
     },
     "node_modules/@larksuiteoapi/node-sdk": {
-      "version": "1.65.0",
-      "resolved": "https://registry.npmjs.org/@larksuiteoapi/node-sdk/-/node-sdk-1.65.0.tgz",
-      "integrity": "sha512-SkMeiFvi4mMVGrmBBh50vWPOgAvfbcpdcAW+iryheFFHUmji49aDch/YtxsKGFtzFlL/rseQXFzNFL8+LdQQ5Q==",
+      "version": "1.66.0",
+      "resolved": "https://registry.npmjs.org/@larksuiteoapi/node-sdk/-/node-sdk-1.66.0.tgz",
+      "integrity": "sha512-ueKbbdvmVGVie3KvKbvHZqvDC/gg3M0rRDeyQanQWK+i2bQgiiTpIfpqVWvxuTgprV31yqV7HPMjN6KegWSCfA==",
       "license": "MIT",
       "dependencies": {
         "axios": "~1.13.3",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openclaw/feishu",
-  "version": "2026.5.27",
+  "version": "2026.5.28-beta.1",
   "description": "OpenClaw Feishu/Lark channel plugin for chats and workplace tools (community maintained by @m1heng).",
   "repository": {
     "type": "git",
@@ -8,12 +8,12 @@
   },
   "type": "module",
   "dependencies": {
-    "@larksuiteoapi/node-sdk": "1.65.0",
+    "@larksuiteoapi/node-sdk": "1.66.0",
     "typebox": "1.1.38",
     "zod": "4.4.3"
   },
   "peerDependencies": {
-    "openclaw": ">=2026.5.27"
+    "openclaw": ">=2026.5.28-beta.1"
   },
   "peerDependenciesMeta": {
     "openclaw": {
@@ -44,10 +44,10 @@
       "minHostVersion": ">=2026.4.25"
     },
     "compat": {
-      "pluginApi": ">=2026.5.27"
+      "pluginApi": ">=2026.5.28-beta.1"
     },
     "build": {
-      "openclawVersion": "2026.5.27"
+      "openclawVersion": "2026.5.28-beta.1"
     },
     "release": {
       "publishToClawHub": true,