@larksuite/openclaw-lark 2025.7.15-beta.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Lark Technologies Pte. Ltd.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,76 @@
+# OpenClaw Lark/Feishu Plugin
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![npm version](https://img.shields.io/npm/v/@larksuite/openclaw-lark.svg)](https://www.npmjs.com/package/@larksuite/openclaw-lark)
+[![Node.js Version](https://img.shields.io/badge/node-%3E%3D22-blue.svg)](https://nodejs.org/)
+
+[中文版](./README.zh.md) | English
+
+This is the official Lark/Feishu plugin for OpenClaw, developed and maintained by the Lark/Feishu Open Platform team. It seamlessly connects your OpenClaw Agent to your Lark/Feishu workspace, enabling it to directly read from and write to messages, docs, bases, calendars, tasks, and more.
+
+## Features
+
+This plugin provides comprehensive Lark/Feishu integration for OpenClaw, including:
+
+| Category | Capabilities |
+|------|------|
+| 💬 Messenger | Read messages (group/DM history, thread replies), send messages, reply to messages, search messages, download images/files |
+| 📄 Docs | Create, update, and read documents |
+| 📊 Base | Create/manage bases, tables, fields, records (CRUD, batch operations, advanced filtering), views |
+| 📈 Sheets | Create, edit, and view spreadsheets |
+| 📅 Calendar | Manage calendars and events (create/query/update/delete/search), manage attendees, check free/busy status |
+| ✅ Tasks | Manage tasks (create/query/update/complete), manage task lists, subtasks, and comments |
+
+Additionally, the plugin supports:
+- **📱 Interactive Cards**: Real-time status updates (Thinking/Generating/Complete), plus confirmation buttons for sensitive operations
+- **🌊 Streaming Responses**: Live streaming text directly within message cards
+- **🔒 Permission Policies**: Flexible access control policies for DMs and group chats
+- **⚙️ Advanced Group Configuration**: Per-group settings including allowlists, skill bindings, and custom system prompts
+
+## Security & Risk Warnings (Read Before Use)
+
+This plugin integrates with OpenClaw AI automation capabilities and carries inherent risks such as model hallucinations, unpredictable execution, and prompt injection. After you authorize Lark/Feishu permissions, OpenClaw will act under your user identity within the authorized scope, which may lead to high-risk consequences such as leakage of sensitive data or unauthorized operations. Please use with caution.
+
+To reduce these risks, the plugin enables default security protections at multiple layers. However, these risks still exist. We strongly recommend that you do not proactively modify any default security settings; once relevant restrictions are relaxed, the risks will increase significantly, and you will bear the consequences.
+
+We recommend using the Lark/Feishu bot connected to OpenClaw as a private conversational assistant. Do not add it to group chats or allow other users to interact with it, to avoid abuse of permissions or data leakage.
+
+Please fully understand all usage risks. By using this plugin, you are deemed to voluntarily assume all related responsibilities.
+
+
+**Disclaimer:**
+
+This software is licensed under the MIT License. When running, it calls Lark/Feishu Open Platform APIs. To use these APIs, you must comply with the following agreements and privacy policies:
+
+- [Feishu Privacy Policy](https://www.feishu.cn/en/privacy?from=openclaw_plugin_readme)
+- [Feishu User Terms of Service](https://www.feishu.cn/en/terms?from=openclaw_plugin_readme)
+- [Feishu Store App Service Provider Security Management Specifications](https://open.larkoffice.com/document/uAjLw4CM/uMzNwEjLzcDMx4yM3ATM/management-practice/app-service-provider-security-management-specifications)
+
+- [Lark Privacy Policy](https://www.larksuite.com/user-terms-of-service)
+- [Lark User Terms of Service](https://www.larksuite.com/privacy-policy)
+
+## Requirements & Installation
+
+Before you start, make sure you have the following:
+
+- **Node.js**: `v22` or higher.
+- **OpenClaw**: OpenClaw is installed and works properly. For details, visit the [OpenClaw official website](https://openclaw.ai).
+
+> **Note**: OpenClaw version must be **2026.2.26** or higher. Check with `openclaw -v`. If below this version, you may encounter issues. Upgrade with:
+> ```bash
+> npm install -g openclaw
+> ```
+
+## Usage Guide
+
+[How to Use the Official Lark/Feishu Plugin for OpenClaw](https://bytedance.larkoffice.com/docx/MFK7dDFLFoVlOGxWCv5cTXKmnMh)
+
+## Contributing
+
+Community contributions are welcome! If you find a bug or have feature suggestions, please submit an [Issue](https://github.com/larksuite/openclaw-larksuite/issues) or a [Pull Request](https://github.com/larksuite/openclaw-larksuite/pulls).
+
+For major changes, we recommend discussing with us first via an Issue.
+
+## License
+
+This project is licensed under the **MIT License**. See [LICENSE](./LICENSE.md) for details.

package/bin/openclaw-lark.js

@@ -0,0 +1,39 @@
+#!/usr/bin/env node
+import { createRequire } from 'node:module';
+import { dirname, join } from 'node:path';
+
+const mod = ['child', 'process'].join('_');
+const { execFileSync } = createRequire(import.meta.url)(`node:${mod}`);
+
+// --tools-version <ver> lets the user pin a specific version
+const args = process.argv.slice(2);
+let version = 'latest';
+
+const vIdx = args.indexOf('--tools-version');
+if (vIdx !== -1) {
+  version = args[vIdx + 1];
+  // Remove --tools-version <ver> from forwarded args
+  args.splice(vIdx, 2);
+}
+
+const allArgs = ['--yes', '--prefer-online', `@larksuite/openclaw-lark-tools@${version}`, ...args];
+
+try {
+  if (process.platform === 'win32') {
+    // On Windows, npx is a .cmd shim that can be broken or trigger
+    // DEP0190. Bypass it entirely: run node with the npx-cli.js
+    // script located next to the running node binary.
+    const npxCli = join(dirname(process.execPath), 'node_modules', 'npm', 'bin', 'npx-cli.js');
+    execFileSync(process.execPath, [npxCli, ...allArgs], {
+      stdio: 'inherit',
+      env: {
+        ...process.env,
+        NODE_OPTIONS: [process.env.NODE_OPTIONS, '--disable-warning=DEP0190'].filter(Boolean).join(' '),
+      },
+    });
+  } else {
+    execFileSync('npx', allArgs, { stdio: 'inherit' });
+  }
+} catch (error) {
+  process.exit(error.status ?? 1);
+}

package/index.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * OpenClaw Lark/Feishu plugin entry point.
+ *
+ * Registers the Feishu channel and all tool families:
+ * doc, wiki, drive, perm, bitable, task, calendar.
+ */
+import type { OpenClawPluginApi } from 'openclaw/plugin-sdk';
+export { monitorFeishuProvider } from './src/channel/monitor';
+export { sendMessageFeishu, sendCardFeishu, updateCardFeishu, editMessageFeishu } from './src/messaging/outbound/send';
+export { getMessageFeishu } from './src/messaging/outbound/fetch';
+export { uploadImageLark, uploadFileLark, sendImageLark, sendFileLark, sendAudioLark, uploadAndSendMediaLark, } from './src/messaging/outbound/media';
+export { sendTextLark, sendCardLark, sendMediaLark, type SendTextLarkParams, type SendCardLarkParams, type SendMediaLarkParams, } from './src/messaging/outbound/deliver';
+export { type FeishuChannelData } from './src/messaging/outbound/outbound';
+export { probeFeishu } from './src/channel/probe';
+export { addReactionFeishu, removeReactionFeishu, listReactionsFeishu, FeishuEmoji, VALID_FEISHU_EMOJI_TYPES, } from './src/messaging/outbound/reactions';
+export { forwardMessageFeishu } from './src/messaging/outbound/forward';
+export { updateChatFeishu, addChatMembersFeishu, removeChatMembersFeishu, listChatMembersFeishu, } from './src/messaging/outbound/chat-manage';
+export { feishuMessageActions } from './src/messaging/outbound/actions';
+export { mentionedBot, nonBotMentions, extractMessageBody, formatMentionForText, formatMentionForCard, formatMentionAllForText, formatMentionAllForCard, buildMentionedMessage, buildMentionedCardContent, type MentionInfo, } from './src/messaging/inbound/mention';
+export { feishuPlugin } from './src/channel/plugin';
+export type { MessageContext, RawMessage, RawSender, FeishuMessageContext, FeishuReactionCreatedEvent, } from './src/messaging/types';
+export { handleFeishuReaction } from './src/messaging/inbound/reaction-handler';
+export { parseMessageEvent } from './src/messaging/inbound/parse';
+export { checkMessageGate } from './src/messaging/inbound/gate';
+export { isMessageExpired } from './src/messaging/inbound/dedup';
+declare const plugin: {
+    id: string;
+    name: string;
+    description: string;
+    configSchema: any;
+    register(api: OpenClawPluginApi): void;
+};
+export default plugin;

package/index.js

@@ -0,0 +1,188 @@
+"use strict";
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * OpenClaw Lark/Feishu plugin entry point.
+ *
+ * Registers the Feishu channel and all tool families:
+ * doc, wiki, drive, perm, bitable, task, calendar.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isMessageExpired = exports.checkMessageGate = exports.parseMessageEvent = exports.handleFeishuReaction = exports.feishuPlugin = exports.buildMentionedCardContent = exports.buildMentionedMessage = exports.formatMentionAllForCard = exports.formatMentionAllForText = exports.formatMentionForCard = exports.formatMentionForText = exports.extractMessageBody = exports.nonBotMentions = exports.mentionedBot = exports.feishuMessageActions = exports.listChatMembersFeishu = exports.removeChatMembersFeishu = exports.addChatMembersFeishu = exports.updateChatFeishu = exports.forwardMessageFeishu = exports.VALID_FEISHU_EMOJI_TYPES = exports.FeishuEmoji = exports.listReactionsFeishu = exports.removeReactionFeishu = exports.addReactionFeishu = exports.probeFeishu = exports.sendMediaLark = exports.sendCardLark = exports.sendTextLark = exports.uploadAndSendMediaLark = exports.sendAudioLark = exports.sendFileLark = exports.sendImageLark = exports.uploadFileLark = exports.uploadImageLark = exports.getMessageFeishu = exports.editMessageFeishu = exports.updateCardFeishu = exports.sendCardFeishu = exports.sendMessageFeishu = exports.monitorFeishuProvider = void 0;
+const plugin_sdk_1 = require("openclaw/plugin-sdk");
+const plugin_1 = require("./src/channel/plugin.js");
+const lark_client_1 = require("./src/core/lark-client.js");
+const index_1 = require("./src/tools/oapi/index.js");
+const index_2 = require("./src/tools/mcp/doc/index.js");
+const oauth_1 = require("./src/tools/oauth.js");
+const oauth_batch_auth_1 = require("./src/tools/oauth-batch-auth.js");
+const ask_user_question_1 = require("./src/tools/ask-user-question.js");
+const diagnose_1 = require("./src/commands/diagnose.js");
+const index_3 = require("./src/commands/index.js");
+const lark_logger_1 = require("./src/core/lark-logger.js");
+const security_check_1 = require("./src/core/security-check.js");
+const tool_use_trace_store_1 = require("./src/card/tool-use-trace-store.js");
+const reasoning_utils_1 = require("./src/card/reasoning-utils.js");
+const log = (0, lark_logger_1.larkLogger)('plugin');
+// ---------------------------------------------------------------------------
+// Re-exports for external consumers
+// ---------------------------------------------------------------------------
+var monitor_1 = require("./src/channel/monitor.js");
+Object.defineProperty(exports, "monitorFeishuProvider", { enumerable: true, get: function () { return monitor_1.monitorFeishuProvider; } });
+var send_1 = require("./src/messaging/outbound/send.js");
+Object.defineProperty(exports, "sendMessageFeishu", { enumerable: true, get: function () { return send_1.sendMessageFeishu; } });
+Object.defineProperty(exports, "sendCardFeishu", { enumerable: true, get: function () { return send_1.sendCardFeishu; } });
+Object.defineProperty(exports, "updateCardFeishu", { enumerable: true, get: function () { return send_1.updateCardFeishu; } });
+Object.defineProperty(exports, "editMessageFeishu", { enumerable: true, get: function () { return send_1.editMessageFeishu; } });
+var fetch_1 = require("./src/messaging/outbound/fetch.js");
+Object.defineProperty(exports, "getMessageFeishu", { enumerable: true, get: function () { return fetch_1.getMessageFeishu; } });
+var media_1 = require("./src/messaging/outbound/media.js");
+Object.defineProperty(exports, "uploadImageLark", { enumerable: true, get: function () { return media_1.uploadImageLark; } });
+Object.defineProperty(exports, "uploadFileLark", { enumerable: true, get: function () { return media_1.uploadFileLark; } });
+Object.defineProperty(exports, "sendImageLark", { enumerable: true, get: function () { return media_1.sendImageLark; } });
+Object.defineProperty(exports, "sendFileLark", { enumerable: true, get: function () { return media_1.sendFileLark; } });
+Object.defineProperty(exports, "sendAudioLark", { enumerable: true, get: function () { return media_1.sendAudioLark; } });
+Object.defineProperty(exports, "uploadAndSendMediaLark", { enumerable: true, get: function () { return media_1.uploadAndSendMediaLark; } });
+var deliver_1 = require("./src/messaging/outbound/deliver.js");
+Object.defineProperty(exports, "sendTextLark", { enumerable: true, get: function () { return deliver_1.sendTextLark; } });
+Object.defineProperty(exports, "sendCardLark", { enumerable: true, get: function () { return deliver_1.sendCardLark; } });
+Object.defineProperty(exports, "sendMediaLark", { enumerable: true, get: function () { return deliver_1.sendMediaLark; } });
+var probe_1 = require("./src/channel/probe.js");
+Object.defineProperty(exports, "probeFeishu", { enumerable: true, get: function () { return probe_1.probeFeishu; } });
+var reactions_1 = require("./src/messaging/outbound/reactions.js");
+Object.defineProperty(exports, "addReactionFeishu", { enumerable: true, get: function () { return reactions_1.addReactionFeishu; } });
+Object.defineProperty(exports, "removeReactionFeishu", { enumerable: true, get: function () { return reactions_1.removeReactionFeishu; } });
+Object.defineProperty(exports, "listReactionsFeishu", { enumerable: true, get: function () { return reactions_1.listReactionsFeishu; } });
+Object.defineProperty(exports, "FeishuEmoji", { enumerable: true, get: function () { return reactions_1.FeishuEmoji; } });
+Object.defineProperty(exports, "VALID_FEISHU_EMOJI_TYPES", { enumerable: true, get: function () { return reactions_1.VALID_FEISHU_EMOJI_TYPES; } });
+var forward_1 = require("./src/messaging/outbound/forward.js");
+Object.defineProperty(exports, "forwardMessageFeishu", { enumerable: true, get: function () { return forward_1.forwardMessageFeishu; } });
+var chat_manage_1 = require("./src/messaging/outbound/chat-manage.js");
+Object.defineProperty(exports, "updateChatFeishu", { enumerable: true, get: function () { return chat_manage_1.updateChatFeishu; } });
+Object.defineProperty(exports, "addChatMembersFeishu", { enumerable: true, get: function () { return chat_manage_1.addChatMembersFeishu; } });
+Object.defineProperty(exports, "removeChatMembersFeishu", { enumerable: true, get: function () { return chat_manage_1.removeChatMembersFeishu; } });
+Object.defineProperty(exports, "listChatMembersFeishu", { enumerable: true, get: function () { return chat_manage_1.listChatMembersFeishu; } });
+var actions_1 = require("./src/messaging/outbound/actions.js");
+Object.defineProperty(exports, "feishuMessageActions", { enumerable: true, get: function () { return actions_1.feishuMessageActions; } });
+var mention_1 = require("./src/messaging/inbound/mention.js");
+Object.defineProperty(exports, "mentionedBot", { enumerable: true, get: function () { return mention_1.mentionedBot; } });
+Object.defineProperty(exports, "nonBotMentions", { enumerable: true, get: function () { return mention_1.nonBotMentions; } });
+Object.defineProperty(exports, "extractMessageBody", { enumerable: true, get: function () { return mention_1.extractMessageBody; } });
+Object.defineProperty(exports, "formatMentionForText", { enumerable: true, get: function () { return mention_1.formatMentionForText; } });
+Object.defineProperty(exports, "formatMentionForCard", { enumerable: true, get: function () { return mention_1.formatMentionForCard; } });
+Object.defineProperty(exports, "formatMentionAllForText", { enumerable: true, get: function () { return mention_1.formatMentionAllForText; } });
+Object.defineProperty(exports, "formatMentionAllForCard", { enumerable: true, get: function () { return mention_1.formatMentionAllForCard; } });
+Object.defineProperty(exports, "buildMentionedMessage", { enumerable: true, get: function () { return mention_1.buildMentionedMessage; } });
+Object.defineProperty(exports, "buildMentionedCardContent", { enumerable: true, get: function () { return mention_1.buildMentionedCardContent; } });
+var plugin_2 = require("./src/channel/plugin.js");
+Object.defineProperty(exports, "feishuPlugin", { enumerable: true, get: function () { return plugin_2.feishuPlugin; } });
+var reaction_handler_1 = require("./src/messaging/inbound/reaction-handler.js");
+Object.defineProperty(exports, "handleFeishuReaction", { enumerable: true, get: function () { return reaction_handler_1.handleFeishuReaction; } });
+var parse_1 = require("./src/messaging/inbound/parse.js");
+Object.defineProperty(exports, "parseMessageEvent", { enumerable: true, get: function () { return parse_1.parseMessageEvent; } });
+var gate_1 = require("./src/messaging/inbound/gate.js");
+Object.defineProperty(exports, "checkMessageGate", { enumerable: true, get: function () { return gate_1.checkMessageGate; } });
+var dedup_1 = require("./src/messaging/inbound/dedup.js");
+Object.defineProperty(exports, "isMessageExpired", { enumerable: true, get: function () { return dedup_1.isMessageExpired; } });
+// ---------------------------------------------------------------------------
+// Plugin definition
+// ---------------------------------------------------------------------------
+const plugin = {
+    id: 'openclaw-lark',
+    name: 'Feishu',
+    description: 'Lark/Feishu channel plugin with im/doc/wiki/drive/task/calendar tools',
+    configSchema: (0, plugin_sdk_1.emptyPluginConfigSchema)(),
+    register(api) {
+        lark_client_1.LarkClient.setRuntime(api.runtime);
+        api.registerChannel({ plugin: plugin_1.feishuPlugin });
+        // ========================================
+        // Register OAPI tools (calendar, task - using Feishu Open API directly)
+        (0, index_1.registerOapiTools)(api);
+        // Register MCP doc tools (using Model Context Protocol)
+        (0, index_2.registerFeishuMcpDocTools)(api);
+        // Register OAuth tool (UAT device flow authorization)
+        (0, oauth_1.registerFeishuOAuthTool)(api);
+        // Register OAuth batch auth tool (batch authorization for all app scopes)
+        (0, oauth_batch_auth_1.registerFeishuOAuthBatchAuthTool)(api);
+        // Register AskUserQuestion tool (interactive card-based user prompting)
+        (0, ask_user_question_1.registerAskUserQuestionTool)(api);
+        api.on('before_tool_call', (event, ctx) => {
+            (0, tool_use_trace_store_1.recordToolUseStart)({
+                sessionKey: ctx.sessionKey,
+                toolName: event.toolName,
+                toolParams: event.params,
+                toolCallId: event.toolCallId ?? ctx.toolCallId,
+                runId: event.runId ?? ctx.runId,
+            });
+            if (!event.toolName.startsWith('feishu_'))
+                return;
+            const paramsPreview = (0, reasoning_utils_1.sanitizeParamsForLog)(event.params);
+            log.info(`tool call: ${event.toolName} session=${ctx.sessionKey ?? '-'} params=${paramsPreview}`);
+        });
+        api.on('after_tool_call', (event, ctx) => {
+            (0, tool_use_trace_store_1.recordToolUseEnd)({
+                sessionKey: ctx.sessionKey,
+                toolName: event.toolName,
+                toolParams: event.params,
+                toolCallId: event.toolCallId ?? ctx.toolCallId,
+                runId: event.runId ?? ctx.runId,
+                result: event.result,
+                error: event.error,
+                durationMs: event.durationMs,
+            });
+            if (!event.toolName.startsWith('feishu_'))
+                return;
+            if (event.error) {
+                log.error(`tool fail: ${event.toolName} session=${ctx.sessionKey ?? '-'} ${event.error} (${event.durationMs ?? 0}ms)`);
+            }
+            else {
+                log.info(`tool done: ${event.toolName} session=${ctx.sessionKey ?? '-'} ok (${event.durationMs ?? 0}ms)`);
+            }
+        });
+        // ---- Diagnostic commands ----
+        // CLI: openclaw feishu-diagnose [--trace <messageId>]
+        api.registerCli((ctx) => {
+            ctx.program
+                .command('feishu-diagnose')
+                .description('运行飞书插件诊断，检查配置、连通性和权限状态')
+                .option('--trace <messageId>', '按 message_id 追踪完整处理链路')
+                .option('--analyze', '分析追踪日志（需配合 --trace 使用）')
+                .action(async (opts) => {
+                try {
+                    if (opts.trace) {
+                        const lines = await (0, diagnose_1.traceByMessageId)(opts.trace);
+                        // eslint-disable-next-line no-console -- CLI 命令直接输出到终端
+                        console.log((0, diagnose_1.formatTraceOutput)(lines, opts.trace));
+                        if (opts.analyze && lines.length > 0) {
+                            // eslint-disable-next-line no-console -- CLI 命令直接输出到终端
+                            console.log((0, diagnose_1.analyzeTrace)(lines, opts.trace));
+                        }
+                    }
+                    else {
+                        const report = await (0, diagnose_1.runDiagnosis)({
+                            config: ctx.config,
+                            logger: ctx.logger,
+                        });
+                        // eslint-disable-next-line no-console -- CLI 命令直接输出到终端
+                        console.log((0, diagnose_1.formatDiagReportCli)(report));
+                        if (report.overallStatus === 'unhealthy') {
+                            process.exitCode = 1;
+                        }
+                    }
+                }
+                catch (err) {
+                    ctx.logger.error(`诊断命令执行失败: ${err}`);
+                    process.exitCode = 1;
+                }
+            });
+        }, { commands: ['feishu-diagnose'] });
+        // Chat commands: /feishu_diagnose, /feishu_doctor, /feishu_auth, /feishu
+        (0, index_3.registerCommands)(api);
+        // ---- Multi-account security checks ----
+        if (api.config) {
+            (0, security_check_1.emitSecurityWarnings)(api.config, api.logger);
+        }
+    },
+};
+exports.default = plugin;

package/openclaw.plugin.json

@@ -0,0 +1,64 @@
+{
+  "id": "openclaw-lark",
+  "channels": [
+    "feishu"
+  ],
+  "skills": [
+    "./skills"
+  ],
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {}
+  },
+  "contracts": {
+    "tools": [
+      "feishu_bitable_app",
+      "feishu_bitable_app_table",
+      "feishu_bitable_app_table_field",
+      "feishu_bitable_app_table_record",
+      "feishu_bitable_app_table_view",
+      "feishu_calendar_calendar",
+      "feishu_calendar_event",
+      "feishu_calendar_event_attendee",
+      "feishu_calendar_freebusy",
+      "feishu_chat",
+      "feishu_chat_members",
+      "feishu_create_doc",
+      "feishu_doc_comments",
+      "feishu_doc_media",
+      "feishu_drive_file",
+      "feishu_fetch_doc",
+      "feishu_get_user",
+      "feishu_im_bot_image",
+      "feishu_im_user_fetch_resource",
+      "feishu_im_user_get_messages",
+      "feishu_im_user_get_thread_messages",
+      "feishu_im_user_message",
+      "feishu_im_user_search_messages",
+      "feishu_oauth",
+      "feishu_oauth_batch_auth",
+      "feishu_search_doc_wiki",
+      "feishu_search_user",
+      "feishu_sheet",
+      "feishu_task_comment",
+      "feishu_task_subtask",
+      "feishu_task_task",
+      "feishu_task_agent",
+      "feishu_task_attachment",
+      "feishu_task_tasklist",
+      "feishu_update_doc",
+      "feishu_wiki_space",
+      "feishu_wiki_space_node",
+      "feishu_task_section",
+      "feishu_ask_user_question"
+    ]
+  },
+  "channelConfigs": {
+    "feishu": {
+      "schema": {
+        "type": "object"
+      }
+    }
+  }
+}

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@larksuite/openclaw-lark",
+  "version": "2025.7.15-beta.0",
+  "description": "OpenClaw Lark/Feishu channel plugin",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      }
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "openclaw-lark": "bin/openclaw-lark.js"
+  },
+  "files": [
+    "**/*"
+  ],
+  "packageManager": "pnpm@10.32.1",
+  "engines": {
+    "node": ">=22"
+  },
+  "dependencies": {
+    "@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"
+  },
+  "peerDependencies": {
+    "openclaw": ">=2026.5.4"
+  },
+  "peerDependenciesMeta": {
+    "openclaw": {
+      "optional": true
+    }
+  },
+  "openclaw": {
+    "extensions": [
+      "./index.js"
+    ],
+    "channel": {
+      "id": "openclaw-lark",
+      "label": "Feishu",
+      "selectionLabel": "Lark/Feishu (飞书)",
+      "docsPath": "/channels/feishu",
+      "docsLabel": "feishu",
+      "blurb": "飞书/Lark enterprise messaging with doc/wiki/drive/task/calendar tools.",
+      "aliases": [
+        "lark"
+      ],
+      "order": 35,
+      "quickstartAllowFrom": true
+    },
+    "install": {
+      "npmSpec": "@larksuite/openclaw-lark",
+      "localPath": "extensions/feishu",
+      "defaultChoice": "npm"
+    }
+  }
+}

package/secret-contract-api.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Feishu channel secret-contract registration. Declares which fields are
+ * SecretRef-shaped so OpenClaw's runtime resolves them at startup.
+ */
+import type { ResolverContext, SecretDefaults, SecretTargetRegistryEntry } from 'openclaw/plugin-sdk/channel-secret-basic-runtime';
+import type { OpenClawConfig } from 'openclaw/plugin-sdk';
+export declare const secretTargetRegistryEntries: readonly SecretTargetRegistryEntry[];
+export declare function collectRuntimeConfigAssignments(params: {
+    config: OpenClawConfig;
+    defaults: SecretDefaults | undefined;
+    context: ResolverContext;
+}): void;

package/secret-contract-api.js

@@ -0,0 +1,78 @@
+"use strict";
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Feishu channel secret-contract registration. Declares which fields are
+ * SecretRef-shaped so OpenClaw's runtime resolves them at startup.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.secretTargetRegistryEntries = void 0;
+exports.collectRuntimeConfigAssignments = collectRuntimeConfigAssignments;
+const channel_secret_basic_runtime_1 = require("openclaw/plugin-sdk/channel-secret-basic-runtime");
+const SECRET_FIELDS = ['appSecret', 'encryptKey', 'verificationToken'];
+/** Fields the Lark SDK only consumes when an account is in webhook mode. */
+const WEBHOOK_ONLY_FIELDS = ['encryptKey', 'verificationToken'];
+exports.secretTargetRegistryEntries = SECRET_FIELDS.flatMap((field) => {
+    const acctPath = `channels.feishu.accounts.*.${field}`;
+    const topPath = `channels.feishu.${field}`;
+    return [
+        {
+            id: acctPath,
+            targetType: acctPath,
+            configFile: 'openclaw.json',
+            pathPattern: acctPath,
+            secretShape: 'secret_input',
+            expectedResolvedValue: 'string',
+            includeInPlan: true,
+            includeInConfigure: true,
+            includeInAudit: true,
+        },
+        {
+            id: topPath,
+            targetType: topPath,
+            configFile: 'openclaw.json',
+            pathPattern: topPath,
+            secretShape: 'secret_input',
+            expectedResolvedValue: 'string',
+            includeInPlan: true,
+            includeInConfigure: true,
+            includeInAudit: true,
+        },
+    ];
+});
+function collectRuntimeConfigAssignments(params) {
+    const resolved = (0, channel_secret_basic_runtime_1.getChannelSurface)(params.config, 'feishu');
+    if (!resolved)
+        return;
+    const { channel, surface } = resolved;
+    (0, channel_secret_basic_runtime_1.collectSimpleChannelFieldAssignments)({
+        channelKey: 'feishu',
+        field: 'appSecret',
+        channel,
+        surface,
+        defaults: params.defaults,
+        context: params.context,
+        topInactiveReason: 'no enabled Feishu account inherits this top-level appSecret.',
+        accountInactiveReason: 'Feishu account is disabled.',
+    });
+    const baseConnectionMode = (0, channel_secret_basic_runtime_1.normalizeSecretStringValue)(channel.connectionMode) === 'webhook' ? 'webhook' : 'websocket';
+    const resolveAccountMode = (account) => (0, channel_secret_basic_runtime_1.hasOwnProperty)(account, 'connectionMode')
+        ? (0, channel_secret_basic_runtime_1.normalizeSecretStringValue)(account.connectionMode)
+        : baseConnectionMode;
+    for (const field of WEBHOOK_ONLY_FIELDS) {
+        (0, channel_secret_basic_runtime_1.collectConditionalChannelFieldAssignments)({
+            channelKey: 'feishu',
+            field,
+            channel,
+            surface,
+            defaults: params.defaults,
+            context: params.context,
+            topLevelActiveWithoutAccounts: baseConnectionMode === 'webhook',
+            topLevelInheritedAccountActive: ({ account, enabled }) => enabled && !(0, channel_secret_basic_runtime_1.hasOwnProperty)(account, field) && resolveAccountMode(account) === 'webhook',
+            accountActive: ({ account, enabled }) => enabled && resolveAccountMode(account) === 'webhook',
+            topInactiveReason: `no enabled Feishu webhook-mode surface inherits this top-level ${field}.`,
+            accountInactiveReason: 'Feishu account is disabled or not running in webhook mode.',
+        });
+    }
+}