@larksuite/openclaw-lark 2026.3.9

package/LICENSE

@@ -0,0 +1,10 @@
+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,283 @@
+# OpenClaw Feishu/Lark 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/@larksuiteoapi/feishu-openclaw-plugin.svg)](https://www.npmjs.com/package/@larksuiteoapi/feishu-openclaw-plugin)
+[![Node.js Version](https://img.shields.io/badge/node-%3E%3D22-blue.svg)](https://nodejs.org/)
+
+[中文版](./README.zh.md) | English
+
+---
+
+The official Feishu/Lark plugin for OpenClaw, developed and maintained by the Lark Open Platform team. It seamlessly connects your OpenClaw Agent to your Feishu/Lark workspace, empowering it to directly read from and write to messages, documents, sheets, calendars, tasks, and more.
+
+## Features
+
+This plugin provides comprehensive Feishu/Lark integration for OpenClaw, including:
+
+| Category | Capabilities |
+|----------|--------------|
+| 💬 Messages | Message reading (group/DM history, topic replies), message sending, message replies, message search, image/file download |
+| 📄 Docs | Create cloud docs, update cloud docs, read cloud doc content |
+| 📊 Bitable | Create/manage bitables, data tables, fields, records (CRUD, batch operations, advanced filtering), views |
+| 📅 Calendar | Calendar management, event management (create/query/update/delete/search), attendee management, free/busy lookup |
+| ✅ Tasks | Task management (create/query/update/complete), tasklist management, subtasks, comments |
+
+Additionally, the plugin supports:
+- **📱 Interactive Cards**: Real-time status updates (thinking/streaming/complete states), confirmation buttons for sensitive operations
+- **🌊 Streaming Replies**: Real-time streaming responses in message cards
+- **🔒 Permission Policies**: Flexible access control policies for DMs and group chats
+- **⚙️ Advanced Group Configuration**: Per-group settings including whitelists, skill bindings, and custom system prompts
+
+For a complete list of features, please see [FEATURES.md](./openclaw/feishu/FEATURES.md).
+
+## Important Security & Risk Warnings (Read Before Use)
+
+**Core Risk:** This plugin connects to your workspace data through Feishu APIs — messages, documents, calendars, contacts. Anything the AI can read has the potential to be exposed. While we've implemented security measures, AI systems are not yet fully mature or stable, so we cannot guarantee absolute security.
+
+**Strong Recommendation:** DO NOT use company/enterprise Feishu accounts at this stage! Please use personal accounts for testing and exploration only.
+
+- This application is intended for personal use only and should NOT be shared with multiple users.
+- Avoid using this plugin in group chats. Since it runs under your personal identity, other members may prompt it into accessing or sending your data, increasing the risk of data leakage.
+
+**Other Operational Risks**
+- AI is not perfect and may experience "hallucinations": It may sometimes misunderstand your intent or generate content that appears reasonable but is inaccurate.
+- Some operations are irreversible: For example, messages sent by the AI on your behalf are sent in your name and become factual once sent.
+- **Mitigation Advice:** For important operations involving sending, modifying, or writing data, please always **"preview first, then confirm"**. Never let the AI operate in a fully autonomous "self-driving" mode without human oversight.
+
+**Disclaimer:** This plugin is provided "as is" without any warranties. Users are solely responsible for any data loss, security breaches, or other damages resulting from the use of this plugin. Please ensure you understand the risks before using this plugin.
+
+## Requirements & Installation
+
+Before you start, please ensure you have the following:
+
+- **Node.js**: `v22` or higher.
+- **OpenClaw**: A working installation of OpenClaw. 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, upgrade with:
+> ```bash
+> npm install -g openclaw
+> ```
+
+### Create Feishu Application
+
+1. Log in to [Feishu Open Platform](https://open.feishu.cn/app), click "Create Enterprise Self-built App".
+2. Configure app name, description, and icon, then click "Create".
+3. Add Bot capability: In the left navigation, go to "App Capabilities > Add App Capability", select "Add by Capability" tab, click "Add" on the "Bot" capability card.
+4. Import required permissions: In the left navigation, go to "Development Config > Permission Management", click "Batch Import/Export Permissions", and import the complete permission list.
+
+> **Note**: Importing the complete permission list is very important for full functionality!
+
+5. Publish and approve the app: Click "Create Version", configure version number and update notes, click "Save", then click "Confirm Publish".
+6. Get app credentials: In the left navigation, go to "Basic Info > Credentials and Basic Info", get App ID and App Secret.
+
+### Install Feishu Plugin
+
+Execute the following commands in your terminal:
+
+```bash
+# Set npm registry
+npm config set registry https://registry.npmjs.org
+
+# Download plugin installer
+curl -o /tmp/feishu-openclaw-plugin-onboard-cli.tgz https://sf3-cn.feishucdn.com/obj/open-platform-opendoc/4d184b1ba733bae2423a89e196a2ef8f_QATOjKH1WN.tgz
+
+# Install plugin
+npm install /tmp/feishu-openclaw-plugin-onboard-cli.tgz -g
+
+# Clean up installer
+rm /tmp/feishu-openclaw-plugin-onboard-cli.tgz
+
+# Run installation wizard
+feishu-plugin-onboard install
+```
+
+During installation:
+- If you previously linked a Feishu app, you can choose to use the existing app or create a new one
+- If no Feishu app is linked, enter the appId and appSecret created in the previous steps
+
+Start the plugin:
+```bash
+openclaw gateway run
+```
+
+Verify success:
+- After running the above command, if you see "started listening to Feishu events" in the logs, the plugin has started successfully
+- Run `openclaw plugins list`, if **feishu-openclaw-plugin** Status is loaded and **feishu** Status is disabled, the plugin is successfully enabled
+
+## Quick Start
+
+1.  **Configure `openclaw.json`**
+
+    After installation, edit your OpenClaw configuration file (`~/.openclaw/openclaw.json`) to enable the `feishu` channel and add your app credentials.
+
+    Here is a minimal configuration example:
+
+    ```json
+    {
+      "channels": {
+        "feishu": {
+          "enabled": true,
+          "appId": "cli_xxxxxxxxxxxxxx",
+          "appSecret": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
+          "domain": "feishu",
+          "connectionMode": "websocket"
+        }
+      },
+      "plugins": {
+        "allow": ["feishu-openclaw-plugin"]
+      }
+    }
+    ```
+    *Make sure to replace `appId` and `appSecret` with your own app credentials.*
+
+2.  **Run the OpenClaw Gateway**
+
+    Save the configuration and start the OpenClaw gateway:
+
+    ```bash
+    openclaw gateway run
+    ```
+
+3.  **Pair the Bot**
+
+    - Send any message to the bot in Feishu, and the system will generate a pairing code (letters + numbers)
+    - The pairing code is valid for 5 minutes; if it expires, trigger again
+    - Run the following command on the server to complete the binding:
+      ```bash
+      openclaw pairing approve feishu <pairing_code> --notify
+      ```
+
+4.  **Complete Authorization**
+
+    Follow the prompts in Feishu to complete authorization, so OpenClaw can perform tasks like reading messages, docs, bitables, and calendars on your behalf.
+
+    > If you don't want to authorize now, you can start the conversation directly and enter `/feishu auth` later to complete batch authorization.
+
+5.  **Start Chatting**
+
+    Your bot is now ready. To verify installation, enter `/feishu start` in the dialog; if it returns version info, the installation is successful.
+
+    To teach the bot new skills, tell it: "Learn about my new Feishu plugin, list what capabilities it has"
+
+## Configuration
+
+The plugin offers several configuration options to tailor its behavior. All settings are located under the `channels.feishu` key in your `openclaw.json`.
+
+- `replyMode` (string | object): Controls how the AI delivers responses.
+    - `"auto"` (default): Uses streaming replies for DMs and static replies for group chats.
+    - `"streaming"`: Always use streaming card replies.
+    - `"static"`: Always send the response after it's fully generated.
+
+- `dmPolicy` (string): Access policy for direct messages.
+    - `"open"` (default): Responds to all DMs.
+    - `"pairing"`: Requires users to pair with a code before they can interact with the bot.
+    - `"allowlist"`: Only responds to whitelisted users.
+
+- `groupPolicy` (string): Access policy for group chats.
+    - `"open"`: Allows interaction in any group chat when the bot is @mentioned.
+    - `"allowlist"` (recommended): Only works in whitelisted group chats.
+    - `"disabled"`: Disables all group chat interactions.
+
+- `requireMention` (boolean): If `true` (default), the bot will only respond in group chats when it is @mentioned.
+
+For more detailed configuration options, see [FEATURES.md](./openclaw/feishu/FEATURES.md).
+
+## Common Commands
+
+```bash
+# View current configuration
+openclaw config get channels.feishu
+
+# Set to require @ mention to reply
+openclaw config set channels.feishu.requireMention true --json
+
+# Set to reply to all messages
+openclaw config set channels.feishu.requireMention open --json
+
+# Set specific group to require @ mention
+openclaw config set channels.feishu.groups.群ID.requireMention true --json
+
+# Enable streaming output
+openclaw config set channels.feishu.streaming true
+
+# Enable elapsed time display in streaming
+openclaw config set channels.feishu.footer.elapsed true
+
+# Enable status display in streaming
+openclaw config set channels.feishu.footer.status true
+
+# View channel status
+openclaw channels status
+
+# Upgrade plugin
+feishu-plugin-onboard update
+
+# Diagnose issues
+feishu-plugin-onboard doctor
+
+# Fix issues
+feishu-plugin-onboard doctor --fix
+
+# View version info
+feishu-plugin-onboard info
+
+# View detailed config info
+feishu-plugin-onboard info --all
+```
+
+### Group Chat Reply Modes
+
+**Mode 1: Only reply when @ mentioned (default)**
+```bash
+openclaw config set channels.feishu.requireMention true --json
+```
+
+**Mode 2: Reply to all messages**
+```bash
+openclaw config set channels.feishu.requireMention false --json
+```
+> Note: This mode can spam in large groups, use with caution!
+
+**Mode 3: Only specific groups require @ mention (advanced)**
+```bash
+# First set default to not require @ for all groups
+openclaw config set channels.feishu.requireMention open --json
+# Then set specific group to require @
+openclaw config set channels.feishu.groups.oc_xxxxxxxx.requireMention true --json
+```
+
+## FAQ
+
+1.  **Why isn't Windows supported?**
+    *   This is a known issue in the OpenClaw core. You can track its progress at [openclaw/openclaw#7631](https://github.com/openclaw/openclaw/issues/7631).
+
+2.  **I see a `Cannot find module 'xxx'` error on startup.**
+    *   This usually means the plugin's dependencies were not installed correctly. Navigate to the plugin directory at `~/.openclaw/extensions/feishu-openclaw-plugin` and run `npm install --production` to manually install them.
+
+3.  **The bot reports "insufficient permissions" when trying to read a doc or send a message.**
+    *   Log in to the Feishu/Lark Developer Console and ensure your application has been granted the necessary API permissions. For example, reading a document requires the `docx:document:readonly` scope, and sending messages requires `im:message:send_as_bot` permission.
+
+4.  **How to quickly complete user authorization?**
+    *   Tell the AI: "I want to grant all user permissions" to complete batch authorization.
+    *   Or enter `/feishu auth` to complete batch user authorization.
+
+5.  **How to verify installation success?**
+    *   Enter `/feishu start` in the dialog; if it returns version info, installation is successful.
+    *   Enter `/feishu doctor` to check if configuration is normal.
+
+6.  **How to update the plugin?**
+    *   Run the following command:
+      ```bash
+      feishu-plugin-onboard update
+      ```
+    *   If you cannot find this command, you need to install the installer first (see installation steps).
+
+## Contributing
+
+Contributions from the community are welcome! If you find a bug or have a feature request, please open an [Issue](https://github.com/larksuite/openclaw-larksuite/issues) or submit a [Pull Request](https://github.com/larksuite/openclaw-larksuite/pulls).
+
+For major changes, please open an issue first to discuss what you would like to change.
+
+## License
+
+This project is licensed under the **MIT License**. See the [LICENSE](./openclaw/feishu/LICENSE) file for details.

package/index.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * OpenClaw Feishu/Lark 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: import("openclaw/plugin-sdk").OpenClawPluginConfigSchema;
+    register(api: OpenClawPluginApi): void;
+};
+export default plugin;
+//# sourceMappingURL=index.d.ts.map

package/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAyB7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AACvH,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,EACL,eAAe,EACf,cAAc,EACd,aAAa,EACb,YAAY,EACZ,aAAa,EACb,sBAAsB,GACvB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,GACzB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAC3E,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,EACnB,WAAW,EACX,wBAAwB,GACzB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AACxE,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AACxE,OAAO,EACL,YAAY,EACZ,cAAc,EACd,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,uBAAuB,EACvB,uBAAuB,EACvB,qBAAqB,EACrB,yBAAyB,EACzB,KAAK,WAAW,GACjB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,YAAY,EACV,cAAc,EACd,UAAU,EACV,SAAS,EACT,oBAAoB,EACpB,0BAA0B,GAC3B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,oBAAoB,EAAE,MAAM,0CAA0C,CAAC;AAChF,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAMjE,QAAA,MAAM,MAAM;;;;;kBAKI,iBAAiB;CAgFhC,CAAC;AAEF,eAAe,MAAM,CAAC"}

package/index.js

@@ -0,0 +1,119 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * OpenClaw Feishu/Lark plugin entry point.
+ *
+ * Registers the Feishu channel and all tool families:
+ * doc, wiki, drive, perm, bitable, task, calendar.
+ */
+import { emptyPluginConfigSchema } from 'openclaw/plugin-sdk';
+import { feishuPlugin } from './src/channel/plugin';
+import { LarkClient } from './src/core/lark-client';
+import { registerOapiTools } from './src/tools/oapi/index';
+import { registerFeishuMcpDocTools } from './src/tools/mcp/doc/index';
+import { registerFeishuOAuthTool } from './src/tools/oauth';
+import { registerFeishuOAuthBatchAuthTool } from './src/tools/oauth-batch-auth';
+import { runDiagnosis, formatDiagReportCli, traceByMessageId, formatTraceOutput, analyzeTrace, } from './src/commands/diagnose';
+import { registerCommands } from './src/commands/index';
+import { larkLogger } from './src/core/lark-logger';
+import { emitSecurityWarnings } from './src/core/security-check';
+const log = larkLogger('plugin');
+// ---------------------------------------------------------------------------
+// Re-exports for external consumers
+// ---------------------------------------------------------------------------
+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, } from './src/messaging/outbound/deliver';
+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, } from './src/messaging/inbound/mention';
+export { feishuPlugin } from './src/channel/plugin';
+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';
+// ---------------------------------------------------------------------------
+// Plugin definition
+// ---------------------------------------------------------------------------
+const plugin = {
+    id: 'feishu-openclaw-plugin',
+    name: 'Feishu',
+    description: 'Feishu/Lark channel plugin with im/doc/wiki/drive/task/calendar tools',
+    configSchema: emptyPluginConfigSchema(),
+    register(api) {
+        LarkClient.setRuntime(api.runtime);
+        api.registerChannel({ plugin: feishuPlugin });
+        // ========================================
+        // Register OAPI tools (calendar, task - using Feishu Open API directly)
+        registerOapiTools(api);
+        // Register MCP doc tools (using Model Context Protocol)
+        registerFeishuMcpDocTools(api);
+        // Register OAuth tool (UAT device flow authorization)
+        registerFeishuOAuthTool(api);
+        // Register OAuth batch auth tool (batch authorization for all app scopes)
+        registerFeishuOAuthBatchAuthTool(api);
+        // ---- Tool call hooks (auto-trace AI tool invocations) ----
+        api.on('before_tool_call', (event) => {
+            log.info(`tool call: ${event.toolName} params=${JSON.stringify(event.params)}`);
+        });
+        api.on('after_tool_call', (event) => {
+            if (event.error) {
+                log.error(`tool fail: ${event.toolName} ${event.error} (${event.durationMs ?? 0}ms)`);
+            }
+            else {
+                log.info(`tool done: ${event.toolName} 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 traceByMessageId(opts.trace);
+                        // eslint-disable-next-line no-console -- CLI 命令直接输出到终端
+                        console.log(formatTraceOutput(lines, opts.trace));
+                        if (opts.analyze && lines.length > 0) {
+                            // eslint-disable-next-line no-console -- CLI 命令直接输出到终端
+                            console.log(analyzeTrace(lines, opts.trace));
+                        }
+                    }
+                    else {
+                        const report = await runDiagnosis({
+                            config: ctx.config,
+                            logger: ctx.logger,
+                        });
+                        // eslint-disable-next-line no-console -- CLI 命令直接输出到终端
+                        console.log(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
+        registerCommands(api);
+        // ---- Multi-account security checks ----
+        if (api.config) {
+            emitSecurityWarnings(api.config, api.logger);
+        }
+    },
+};
+export default plugin;
+//# sourceMappingURL=index.js.map

package/index.js.map

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

package/openclaw.plugin.json

@@ -0,0 +1,10 @@
+{
+  "id": "feishu-openclaw-plugin",
+  "channels": ["feishu"],
+  "skills": ["./skills"],
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {}
+  }
+}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@larksuite/openclaw-lark",
+  "version": "2026.3.9",
+  "description": "OpenClaw Feishu/Lark channel plugin (official by Feishu team)",
+  "type": "module",
+  "files": [
+    "**/*"
+  ],
+  "dependencies": {
+    "@larksuiteoapi/node-sdk": "^1.59.0",
+    "@sinclair/typebox": "0.34.48",
+    "image-size": "^2.0.2",
+    "zod": "^4.3.6"
+  },
+  "openclaw": {
+    "extensions": [
+      "./index.js"
+    ],
+    "channel": {
+      "id": "feishu-openclaw-plugin",
+      "label": "Feishu",
+      "selectionLabel": "Feishu/Lark (飞书)",
+      "docsPath": "/channels/feishu",
+      "docsLabel": "feishu",
+      "blurb": "飞书/Lark enterprise messaging with doc/wiki/drive/task/calendar tools.",
+      "aliases": [
+        "lark"
+      ],
+      "order": 35,
+      "quickstartAllowFrom": true
+    },
+    "install": {
+      "npmSpec": "@larksuiteoapi/feishu-openclaw-plugin",
+      "localPath": "extensions/feishu",
+      "defaultChoice": "npm"
+    }
+  },
+  "main": "index.js",
+  "types": "index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "import": "./index.js",
+      "default": "./index.js"
+    }
+  }
+}