@larksuite/openclaw-lark 2026.5.13 → 2026.5.20

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@larksuite/openclaw-lark",
-  "version": "2026.5.13",
+  "version": "2026.5.20",
   "description": "OpenClaw Lark/Feishu channel plugin",
   "exports": {
     ".": {
@@ -23,8 +23,8 @@
     "node": ">=22"
   },
   "dependencies": {
-    "@larksuiteoapi/node-sdk": "^1.60.0",
-    "@sinclair/typebox": "0.34.48",
+    "@larksuiteoapi/node-sdk": "^1.64.0",
+    "@sinclair/typebox": "0.34.49",
     "image-size": "^2.0.2",
     "undici-types": "^8.1.0",
     "zod": "^4.3.6"

package/src/card/reply-dispatcher.js

@@ -196,12 +196,13 @@ function createFeishuReplyDispatcher(params) {
             }
             // 提取文本和媒体 URL
             const text = getVisiblePayloadText(payload);
+            const reasoningText = payload.isReasoning === true ? (payload.text ?? '') : '';
             const payloadMediaUrls = payload.mediaUrls?.length
                 ? payload.mediaUrls
                 : payload.mediaUrl
                     ? [payload.mediaUrl]
                     : [];
-            if (!text.trim() && payloadMediaUrls.length === 0) {
+            if (!text.trim() && !reasoningText.trim() && payloadMediaUrls.length === 0) {
                 log.debug('deliver: empty text and no media, skipping');
                 return;
             }
@@ -211,12 +212,17 @@ function createFeishuReplyDispatcher(params) {
                     await controller.onToolPayload(payload);
                     return;
                 }
-                if (text.trim()) {
+                const controllerText = reasoningText.trim() ? reasoningText : text;
+                if (controllerText.trim()) {
                     await controller.ensureCardCreated();
                     if (controller.isTerminated)
                         return;
                     if (controller.cardMessageId) {
-                        await controller.onDeliver({ ...payload, text });
+                        if (payload.isReasoning === true) {
+                            await controller.onReasoningStream({ ...payload, text: controllerText });
+                            return;
+                        }
+                        await controller.onDeliver({ ...payload, text: controllerText });
                         return;
                     }
                     // Card creation failed — fall through to static delivery

package/src/channel/interactive-dispatch.js

@@ -16,6 +16,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.dispatchFeishuPluginInteractiveHandler = dispatchFeishuPluginInteractiveHandler;
 // NOTE: This is the SDK-standard interactive pipeline.
 const plugin_runtime_1 = require("openclaw/plugin-sdk/plugin-runtime");
+const card_action_operator_1 = require("../core/card-action-operator.js");
 const lark_logger_1 = require("../core/lark-logger.js");
 const send_1 = require("../messaging/outbound/send.js");
 const log = (0, lark_logger_1.larkLogger)('channel/interactive-dispatch');
@@ -29,7 +30,7 @@ function extractBasics(data) {
         const openMessageId = ev.open_message_id ?? ev.context?.open_message_id;
         return {
             action: action.trim(),
-            senderOpenId: ev.operator?.open_id,
+            senderOpenId: (0, card_action_operator_1.resolveCardCallbackOperatorId)(ev.operator),
             openChatId,
             openMessageId,
         };

package/src/core/card-action-operator.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Card callback operator identity extraction.
+ *
+ * Feishu Schema 2 card callbacks may carry the operator identity under
+ * either `operator.open_id` (Schema 1 / default) or `operator.user_id`
+ * (Schema 2 when the user has no open_id in the app's tenant).
+ *
+ * This helper provides a single, consistent extraction point so that
+ * every card callback handler resolves the operator identity the same
+ * way.  See openclaw/openclaw#71670 for the upstream Schema 2 change.
+ */
+/**
+ * Minimal shape of the `operator` object in a Feishu card callback event.
+ * Both fields are optional because Schema 2 may omit `open_id` entirely.
+ */
+export interface CardCallbackOperator {
+    open_id?: string;
+    user_id?: string;
+}
+/**
+ * Extract the operator's identity from a Feishu card callback event.
+ *
+ * Prefers `open_id` (the stable per-app user identifier) and falls back
+ * to `user_id` when `open_id` is absent or empty — this is the Schema 2 path.
+ *
+ * @param operator - The `operator` field from the card callback payload.
+ * @returns The resolved operator identifier, or `undefined` when neither
+ *   field is present.
+ */
+export declare function resolveCardCallbackOperatorId(operator: CardCallbackOperator | undefined): string | undefined;

package/src/core/card-action-operator.js

@@ -0,0 +1,30 @@
+"use strict";
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Card callback operator identity extraction.
+ *
+ * Feishu Schema 2 card callbacks may carry the operator identity under
+ * either `operator.open_id` (Schema 1 / default) or `operator.user_id`
+ * (Schema 2 when the user has no open_id in the app's tenant).
+ *
+ * This helper provides a single, consistent extraction point so that
+ * every card callback handler resolves the operator identity the same
+ * way.  See openclaw/openclaw#71670 for the upstream Schema 2 change.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveCardCallbackOperatorId = resolveCardCallbackOperatorId;
+/**
+ * Extract the operator's identity from a Feishu card callback event.
+ *
+ * Prefers `open_id` (the stable per-app user identifier) and falls back
+ * to `user_id` when `open_id` is absent or empty — this is the Schema 2 path.
+ *
+ * @param operator - The `operator` field from the card callback payload.
+ * @returns The resolved operator identifier, or `undefined` when neither
+ *   field is present.
+ */
+function resolveCardCallbackOperatorId(operator) {
+    return operator?.open_id || operator?.user_id;
+}

package/src/core/lark-client.js

@@ -59,16 +59,19 @@ const runtime_store_1 = require("./runtime-store.js");
 const version_1 = require("./version.js");
 const log = (0, lark_logger_1.larkLogger)('core/lark-client');
 // ---------------------------------------------------------------------------
-// 注入 User-Agent 到所有飞书 SDK 请求
+// Inject User-Agent into all Feishu SDK requests
 // ---------------------------------------------------------------------------
 const GLOBAL_LARK_USER_AGENT_KEY = 'LARK_USER_AGENT';
 function installGlobalUserAgent() {
-    // node-sdk 内置拦截器最终会读取 global.LARK_USER_AGENT 并覆盖 User-Agent
+    // node-sdk's built-in interceptor reads global.LARK_USER_AGENT to override User-Agent
     globalThis[GLOBAL_LARK_USER_AGENT_KEY] = (0, version_1.getUserAgent)();
 }
 installGlobalUserAgent();
+// Disable axios auto-proxy to prevent HTTP_PROXY env vars from corrupting request URLs.
+// Proxy routing is managed centrally by OpenClaw core's global-agent.
+Lark.defaultHttpInstance.defaults.proxy = false;
 Lark.defaultHttpInstance.interceptors.request.handlers = [];
-// 使用 interceptors 在所有 HTTP 请求中注入 User-Agent header
+// Inject User-Agent header into all HTTP requests via interceptor
 Lark.defaultHttpInstance.interceptors.request.use((req) => {
     if (req.headers) {
         req.headers['User-Agent'] = (0, version_1.getUserAgent)();

package/src/messaging/converters/video-chat.js

@@ -11,12 +11,16 @@ const utils_1 = require("./utils.js");
 const convertVideoChat = (raw) => {
     const parsed = (0, utils_1.safeParse)(raw);
     const topic = parsed?.topic ?? '';
+    const meetingNo = parsed?.meet_number?.trim() ?? '';
     const parts = [];
     if (topic) {
-        parts.push(`📹 ${topic}`);
+        parts.push(`Topic: ${topic}`);
     }
     if (parsed?.start_time) {
-        parts.push(`🕙 ${(0, utils_1.millisToDatetime)(parsed.start_time)}`);
+        parts.push(`Start time: ${(0, utils_1.millisToDatetime)(parsed.start_time)}`);
+    }
+    if (meetingNo) {
+        parts.push(`Meeting number: ${meetingNo}`);
     }
     const inner = parts.join('\n') || '[video chat]';
     return {

package/src/messaging/outbound/actions.js

@@ -17,6 +17,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.feishuMessageActions = void 0;
 const tool_send_1 = require("openclaw/plugin-sdk/tool-send");
 const param_readers_1 = require("openclaw/plugin-sdk/param-readers");
+const typebox_1 = require("@sinclair/typebox");
 const sdk_compat_1 = require("../../core/sdk-compat.js");
 const lark_client_1 = require("../../core/lark-client.js");
 const accounts_1 = require("../../core/accounts.js");
@@ -25,6 +26,14 @@ const reactions_1 = require("./reactions.js");
 const deliver_1 = require("./deliver.js");
 const media_1 = require("./media.js");
 const log = (0, lark_logger_1.larkLogger)('outbound/actions');
+const FEISHU_SEND_TEXT_DESCRIPTION = 'Text to send as a separate Feishu message. During a normal Feishu streaming-card reply, do not call send just to repeat or finalize the same answer; return the final answer normally so the active card can be completed by the reply dispatcher. Use send only when the user explicitly needs an additional separate message.';
+const FEISHU_MESSAGE_TOOL_SCHEMA = {
+    properties: {
+        message: typebox_1.Type.Optional(typebox_1.Type.String({ description: FEISHU_SEND_TEXT_DESCRIPTION })),
+        text: typebox_1.Type.Optional(typebox_1.Type.String({ description: FEISHU_SEND_TEXT_DESCRIPTION })),
+    },
+    visibility: 'current-channel',
+};
 // ---------------------------------------------------------------------------
 // Helpers
 // ---------------------------------------------------------------------------
@@ -131,7 +140,7 @@ exports.feishuMessageActions = {
         return {
             actions: Array.from(SUPPORTED_ACTIONS),
             capabilities: ['cards'],
-            schema: null,
+            schema: FEISHU_MESSAGE_TOOL_SCHEMA,
         };
     },
     supportsAction: ({ action }) => SUPPORTED_ACTIONS.has(action),

package/src/tools/ask-user-question.js

@@ -26,6 +26,7 @@ exports.registerAskUserQuestionTool = registerAskUserQuestionTool;
 const node_crypto_1 = require("node:crypto");
 const typebox_1 = require("@sinclair/typebox");
 const lark_ticket_1 = require("../core/lark-ticket.js");
+const card_action_operator_1 = require("../core/card-action-operator.js");
 const lark_logger_1 = require("../core/lark-logger.js");
 const cardkit_1 = require("../card/cardkit.js");
 const chat_queue_1 = require("../channel/chat-queue.js");
@@ -164,7 +165,7 @@ function handleAskUserAction(data, _cfg, accountId) {
     let openChatId;
     try {
         const event = data;
-        senderOpenId = event.operator?.open_id;
+        senderOpenId = (0, card_action_operator_1.resolveCardCallbackOperatorId)(event.operator);
         // open_chat_id may be at top level or inside context (form submit callbacks use context)
         openChatId = event.open_chat_id ?? event.context?.open_chat_id;
         const actionTag = event.action?.tag;

package/src/tools/auto-auth.js

@@ -33,6 +33,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.handleCardAction = handleCardAction;
 exports.handleInvokeErrorWithAutoAuth = handleInvokeErrorWithAutoAuth;
 const lark_ticket_1 = require("../core/lark-ticket.js");
+const card_action_operator_1 = require("../core/card-action-operator.js");
 const lark_logger_1 = require("../core/lark-logger.js");
 const log = (0, lark_logger_1.larkLogger)('tools/auto-auth');
 const api_error_1 = require("../core/api-error.js");
@@ -591,7 +592,7 @@ async function handleCardAction(data, cfg, accountId) {
         const event = data;
         action = event.action?.value?.action;
         operationId = event.action?.value?.operation_id;
-        senderOpenId = event.operator?.open_id;
+        senderOpenId = (0, card_action_operator_1.resolveCardCallbackOperatorId)(event.operator);
     }
     catch {
         return;