@m1heng-clawd/feishu 0.1.16 → 0.1.18

package/README.md

@@ -16,6 +16,22 @@ Feishu/Lark (飞书) channel plugin for [OpenClaw](https://github.com/openclaw/o
 
 ---
 
+## Sponsor
+
+![YouYun Zhisuan](./assets/sponsor-youyunzhisuan.png)
+
+Thanks to our sponsors for supporting the project.
+
+If you need an API key platform whose models can be used as an OpenClaw provider and work with Kimi, MiniMax, Claude Code, Codex, or direct API usage, YouYun Zhisuan is worth considering:
+
+> UCloud's YouYun Zhisuan is an AI cloud platform that provides stable and comprehensive domestic and international model APIs through a single API key. Its high-value Coding Plan offers both monthly and pay-as-you-go options, typically at 20% to 50% of official pricing. It supports Claude Code, Codex, and direct API integrations, as well as enterprise-grade high concurrency, 24/7 technical support, and self-service invoicing. Register through [this link](https://passport.compshare.cn/register?referral_code=5oWQU772rtSCeExpcLFxwy&ytag=GPU_YY_YX_git_clawdbot-feishu) to receive a free RMB 5 platform trial credit.
+
+感谢赞助方对本项目的支持。
+
+如果你需要一个可作为 OpenClaw 模型 provider，并适用于 Kimi、MiniMax、Claude Code、Codex 或直接 API 调用的稳定 API Key 平台，可以了解一下优云智算：
+
+> 优云智算是UCloud旗下AI云平台，提供稳定、全面的国内外模型API，仅一个key即可调用。主打包月、按量的高性价比 Coding Plan 套餐，基于官方2~5折优惠。支持接入 Claude Code、Codex 及 API 调用。支持企业高并发、7*24技术支持、自助开票。通过[此链接](https://passport.compshare.cn/register?referral_code=5oWQU772rtSCeExpcLFxwy&ytag=GPU_YY_YX_git_clawdbot-feishu)注册的用户，可得免费5元平台体验金！
+
 ## English
 
 ### Installation
@@ -113,6 +129,9 @@ openclaw plugins list | rg -i feishu
 | `task:attachment:read` | `feishu_task_attachment_list`, `feishu_task_attachment_get` | List/get task attachments |
 | `im:chat.announcement:read` | `feishu_chat` | Read group announcement |
 | `im:chat:readonly` | `feishu_chat` | Get chat info, check bot membership |
+| `im:message` or `im:message:readonly` | `feishu_message` | Read single/DM messages |
+| `im:message.group_at_msg:readonly` | `feishu_message` | Read all messages in group chats |
+| `im:message.reactions:read` | `feishu_reaction` | List reactions on messages |
 
 **Read-write** (optional, for create/edit/delete operations):
 
@@ -131,6 +150,7 @@ openclaw plugins list | rg -i feishu
 | `im:chat.announcement` | `feishu_chat` | Write/update group announcement |
 | `im:chat` | `feishu_chat` | Create and delete group chats |
 | `im:chat.members` | `feishu_chat` | Add members to group chats |
+| `im:message.reactions:write_only` | `feishu_reaction` | Add and remove reactions |
 
 > Task scope names may vary slightly in Feishu console UI. If needed, search for Task / Tasklist / Comment / Attachment-related permissions and grant read/write accordingly.
 
@@ -479,6 +499,8 @@ session:
 - **Task tools**: Create, get details, update, and delete tasks via Feishu Task v2 API
 - **Chat tools**: Read and write group announcements, create group chats, add members, check bot membership, delete chats (`feishu_chat`)
 - **Urgent notification tools**: Send buzz/urgent notifications (app, SMS, voice call) via `feishu_urgent`
+- **Message tools**: Read single messages or list recent chat history with time range and pagination (`feishu_message`)
+- **Reaction tools**: Add, remove, and list emoji reactions on messages (`feishu_reaction`)
 - **@mention forwarding**: When you @mention someone in your message, the bot's reply will automatically @mention them too
 - **Permission error notification**: When the bot encounters a Feishu API permission error, it automatically notifies the user with the permission grant URL
 - **Dynamic agent creation**: Each DM user can have their own isolated agent instance with dedicated workspace (optional)
@@ -629,6 +651,9 @@ openclaw plugins list | rg -i feishu
 | `task:attachment:read` | `feishu_task_attachment_list`, `feishu_task_attachment_get` | 列出/获取任务附件 |
 | `im:chat.announcement:read` | `feishu_chat` | 读取群公告 |
 | `im:chat:readonly` | `feishu_chat` | 获取群信息、检查机器人是否在群内 |
+| `im:message` 或 `im:message:readonly` | `feishu_message` | 读取单条/私聊消息 |
+| `im:message.group_at_msg:readonly` | `feishu_message` | 读取群聊中所有消息 |
+| `im:message.reactions:read` | `feishu_reaction` | 查看消息表情回复 |
 
 **读写权限**（可选，用于创建/编辑/删除操作）：
 
@@ -647,6 +672,7 @@ openclaw plugins list | rg -i feishu
 | `im:chat.announcement` | `feishu_chat` | 写入/更新群公告 |
 | `im:chat` | `feishu_chat` | 创建和删除群聊 |
 | `im:chat.members` | `feishu_chat` | 向群聊添加成员 |
+| `im:message.reactions:write_only` | `feishu_reaction` | 发送、删除消息表情回复 |
 
 > 飞书控制台中任务权限的显示名称可能略有差异，必要时可按关键字 `task` / `tasklist` / `comment` / `attachment` 搜索并授予对应读写权限。
 
@@ -994,6 +1020,8 @@ session:
 - **任务工具**：基于 Task v2 API 支持任务创建、获取详情、更新和删除
 - **群聊工具**：读写群公告、创建群聊、添加成员、检查机器人是否在群内、删除群聊（`feishu_chat`）
 - **加急通知工具**：发送应用内加急（buzz）、短信、语音电话加急通知（`feishu_urgent`）
+- **消息工具**：读取单条消息或列出聊天历史记录，支持时间范围和分页（`feishu_message`）
+- **表情工具**：添加、删除、列出消息上的表情回复（`feishu_reaction`）
 - **@ 转发功能**：在消息中 @ 某人，机器人的回复会自动 @ 该用户
 - **权限错误提示**：当机器人遇到飞书 API 权限错误时，会自动通知用户并提供权限授权链接
 - **动态 Agent 创建**：每个私聊用户可拥有独立的 agent 实例和专属 workspace（可选）

package/index.ts

@@ -9,6 +9,8 @@ import { registerFeishuPermTools } from "./src/perm-tools/index.js";
 import { registerFeishuTaskTools } from "./src/task-tools/index.js";
 import { registerFeishuChatTools } from "./src/chat-tools/index.js";
 import { registerFeishuUrgentTools } from "./src/urgent-tools/index.js";
+import { registerFeishuMessageTools } from "./src/message-tools/index.js";
+import { registerFeishuReactionTools } from "./src/reaction-tools/index.js";
 import { registerFeishuWikiTools } from "./src/wiki-tools/index.js";
 
 export { monitorFeishuProvider } from "./src/monitor.js";
@@ -64,6 +66,8 @@ const plugin = {
     registerFeishuTaskTools(api);
     registerFeishuChatTools(api);
     registerFeishuUrgentTools(api);
+    registerFeishuMessageTools(api);
+    registerFeishuReactionTools(api);
   },
 };
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@m1heng-clawd/feishu",
-  "version": "0.1.16",
+  "version": "0.1.18",
   "type": "module",
   "description": "OpenClaw Feishu/Lark channel plugin",
   "scripts": {
@@ -57,6 +57,7 @@
     "@larksuiteoapi/node-sdk": "^1.59.0",
     "@sinclair/typebox": "0.34.48",
     "https-proxy-agent": "^7.0.6",
+    "music-metadata": "^11.12.1",
     "zod": "^4.3.6"
   },
   "devDependencies": {

package/skills/feishu-message/SKILL.md

@@ -0,0 +1,111 @@
+---
+name: feishu-message
+description: |
+  Feishu message reading. Activate when user mentions reading messages, chat history, message lookup, or finding previous messages.
+---
+
+# Feishu Message Tool
+
+Single tool `feishu_message` for reading Feishu messages — get a single message by ID or list recent messages in a chat.
+
+## Actions
+
+### Get Single Message
+
+```json
+{
+  "action": "get",
+  "message_id": "om_xxx"
+}
+```
+
+Returns:
+
+```json
+{
+  "ok": true,
+  "action": "get",
+  "found": true,
+  "message_id": "om_xxx",
+  "msg_type": "text",
+  "content": "Hello world",
+  "sender_id": "ou_xxx",
+  "sender_type": "user",
+  "chat_id": "oc_xxx",
+  "create_time": "1710000000000",
+  "update_time": "1710000000000",
+  "mentions": []
+}
+```
+
+### List Recent Messages
+
+List recent messages in a chat (DM or group), newest first by default.
+Omit `chat_id` to use the current conversation's chat:
+
+```json
+{
+  "action": "list"
+}
+```
+
+With custom page size, sort order, and time range:
+
+```json
+{
+  "action": "list",
+  "chat_id": "oc_xxx",
+  "page_size": 20,
+  "sort_type": "ByCreateTimeAsc",
+  "start_time": "1710000000",
+  "end_time": "1710086400"
+}
+```
+
+Returns:
+
+```json
+{
+  "ok": true,
+  "action": "list",
+  "chat_id": "oc_xxx",
+  "total": 10,
+  "messages": [
+    {
+      "message_id": "om_xxx",
+      "msg_type": "text",
+      "content_preview": "Hello world",
+      "sender_id": "ou_xxx",
+      "sender_type": "user",
+      "create_time": "1710000000000",
+      "chat_id": "oc_xxx"
+    }
+  ]
+}
+```
+
+## Parameters
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `action` | Yes | `get` or `list` |
+| `message_id` | get: Yes | Feishu message ID (e.g., `om_xxx`) |
+| `chat_id` | list: Optional | Chat ID (e.g., `oc_xxx`). Omit to use current chat. |
+| `page_size` | list: Optional | Number of messages (default: 10, max: 50) |
+| `sort_type` | list: Optional | `ByCreateTimeDesc` (default) or `ByCreateTimeAsc` |
+| `start_time` | list: Optional | Unix timestamp in seconds (e.g., `"1710000000"`). No lower bound if omitted. |
+| `end_time` | list: Optional | Unix timestamp in seconds (e.g., `"1710086400"`). No upper bound if omitted. |
+
+## Configuration
+
+```yaml
+channels:
+  feishu:
+    tools:
+      message: true  # default: true
+```
+
+## Permissions
+
+- `im:message` or `im:message:readonly` — read single/DM messages
+- `im:message.group_at_msg:readonly` — read all messages in group chats (not just @bot messages)

package/skills/feishu-reaction/SKILL.md

@@ -0,0 +1,120 @@
+---
+name: feishu-reaction
+description: |
+  Feishu message emoji reactions. Activate when user mentions emoji, reaction, thumbsup, like, or responding to messages with emoji.
+---
+
+# Feishu Reaction Tool
+
+Single tool `feishu_reaction` for adding, removing, and listing emoji reactions on Feishu messages.
+
+## Workflow: Reacting to Previous Messages
+
+To react to a message other than the current one, first use `feishu_message` with `action: "list"` to fetch recent messages and find the target `message_id`, then use `feishu_reaction` with that `message_id`.
+
+## Actions
+
+### Add Reaction
+
+```json
+{
+  "action": "add",
+  "message_id": "om_xxx",
+  "emoji_type": "THUMBSUP"
+}
+```
+
+Returns:
+
+```json
+{
+  "ok": true,
+  "action": "add",
+  "message_id": "om_xxx",
+  "emoji_type": "THUMBSUP",
+  "reaction_id": "ZCaCIjUBVVWSrm5L-3ZTw"
+}
+```
+
+### Remove Reaction
+
+```json
+{
+  "action": "remove",
+  "message_id": "om_xxx",
+  "reaction_id": "ZCaCIjUBVVWSrm5L-3ZTw"
+}
+```
+
+### List Reactions
+
+List all reactions on a message:
+
+```json
+{
+  "action": "list",
+  "message_id": "om_xxx"
+}
+```
+
+Filter by emoji type:
+
+```json
+{
+  "action": "list",
+  "message_id": "om_xxx",
+  "emoji_type": "THUMBSUP"
+}
+```
+
+Returns:
+
+```json
+{
+  "ok": true,
+  "action": "list",
+  "message_id": "om_xxx",
+  "emoji_type_filter": "THUMBSUP",
+  "total": 2,
+  "reactions": [
+    {
+      "reaction_id": "ZCaCIjUBVVWSrm5L-3ZTw",
+      "emoji_type": "THUMBSUP",
+      "operator_type": "user",
+      "operator_id": "ou_xxx"
+    }
+  ]
+}
+```
+
+## Parameters
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `action` | Yes | `add`, `remove`, or `list` |
+| `message_id` | Yes | Feishu message ID (e.g., `om_xxx`) |
+| `emoji_type` | add: Yes, list: Optional | Emoji type (e.g., `THUMBSUP`, `HEART`, `SMILE`) |
+| `reaction_id` | remove: Yes | Reaction ID from add or list results |
+
+## Common Emoji Types
+
+| Emoji | Type |
+|-------|------|
+| THUMBSUP | THUMBSDOWN | HEART | SMILE | GRINNING |
+| FIRE | CLAP | OK | CHECK | CROSS |
+| PARTY | PRAY | CRY | ANGRY | THINKING |
+| SURPRISED | LAUGHING | FIST | QUESTION | EXCLAMATION |
+
+## Configuration
+
+```yaml
+channels:
+  feishu:
+    tools:
+      reaction: true  # default: true
+```
+
+## Permissions
+
+- `im:message.reactions:write_only` — add and remove reactions
+- `im:message.reactions:read` — list reactions on messages

package/src/accounts.ts

@@ -10,7 +10,11 @@ function listConfiguredAccountIds(cfg: ClawdbotConfig): string[] {
   if (!accounts || typeof accounts !== "object") {
     return [];
   }
-  return Object.keys(accounts).filter(Boolean);
+  return [...new Set(
+    Object.keys(accounts)
+      .filter((accountId) => accountId.trim())
+      .map((accountId) => normalizeAccountId(accountId)),
+  )];
 }
 
 /**
@@ -38,17 +42,35 @@ export function resolveDefaultFeishuAccountId(cfg: ClawdbotConfig): string {
 }
 
 /**
- * Get the raw account-specific config.
+ * Resolve the configured account key for a normalized account id.
+ * Preserves the original config key casing so write paths can avoid shadow entries.
  */
-function resolveAccountConfig(
+export function resolveConfiguredFeishuAccountKey(
   cfg: ClawdbotConfig,
   accountId: string,
-): FeishuAccountConfig | undefined {
+): string | undefined {
   const accounts = (cfg.channels?.feishu as FeishuConfig)?.accounts;
   if (!accounts || typeof accounts !== "object") {
     return undefined;
   }
-  return accounts[accountId];
+  if (Object.prototype.hasOwnProperty.call(accounts, accountId)) {
+    return accountId;
+  }
+  const normalizedId = normalizeAccountId(accountId);
+  return Object.keys(accounts).find((key) => normalizeAccountId(key) === normalizedId);
+}
+
+/**
+ * Get the raw account-specific config.
+ * Preserves mixed-case config keys by resolving through the normalized account id.
+ */
+function resolveAccountConfig(
+  cfg: ClawdbotConfig,
+  accountId: string,
+): FeishuAccountConfig | undefined {
+  const accounts = (cfg.channels?.feishu as FeishuConfig)?.accounts;
+  const matchedKey = resolveConfiguredFeishuAccountKey(cfg, accountId);
+  return matchedKey && accounts ? accounts[matchedKey] : undefined;
 }
 
 /**

package/src/bot.ts

@@ -94,6 +94,7 @@ const senderNameCache = new Map<string, { name: string; expireAt: number }>();
 // Key: appId or "default", Value: timestamp of last notification
 const permissionErrorNotifiedAt = new Map<string, number>();
 const PERMISSION_ERROR_COOLDOWN_MS = 5 * 60 * 1000; // 5 minutes
+const DEFAULT_MAX_MESSAGE_AGE_MS = 300_000; // 5 minutes
 
 type SenderNameResult = {
   name?: string;
@@ -918,13 +919,20 @@ export async function handleFeishuMessage(params: {
     return;
   }
 
-  let ctx = parseFeishuMessageEvent(event, botOpenId);
-
   // Parse message create_time (Feishu uses millisecond epoch string).
   const messageCreateTimeMs = event.message.create_time
     ? parseInt(event.message.create_time, 10)
     : undefined;
 
+  // Discard stale messages (e.g. replayed after gateway restart).
+  const maxAgeMs = feishuCfg.maxMessageAgeMs ?? DEFAULT_MAX_MESSAGE_AGE_MS;
+  if (messageCreateTimeMs && Date.now() - messageCreateTimeMs > maxAgeMs) {
+    log(`feishu[${account.accountId}]: discarding stale message ${messageId} (age: ${Math.round((Date.now() - messageCreateTimeMs) / 1000)}s, max: ${maxAgeMs / 1000}s)`);
+    return;
+  }
+
+  let ctx = parseFeishuMessageEvent(event, botOpenId);
+
   const messageType = event.message.message_type;
   const isForwardedInbound = isForwardedMessageType(messageType);
   const forwardedDispatchKey = getForwardedKey({
@@ -1304,9 +1312,12 @@ export async function handleFeishuMessage(params: {
       }
     }
 
-    // In group chats, the session is scoped to the group, but the *speaker* is the sender.
-    // Using a group-scoped From causes the agent to treat different users as the same person.
-    const feishuFrom = `feishu:${ctx.senderOpenId}`;
+    // In group chats, From must be group-scoped so the core's resolveGroupSessionKey can
+    // detect group context and route replies back to the group — not to a user's DM session.
+    // We include senderOpenId to preserve per-speaker identity within the group.
+    const feishuFrom = isGroup
+      ? `feishu:${ctx.chatId}:${ctx.senderOpenId}`
+      : `feishu:${ctx.senderOpenId}`;
     const feishuTo = isGroup ? `chat:${ctx.chatId}` : `user:${ctx.senderOpenId}`;
 
     // Resolve peer ID for session routing
@@ -1489,6 +1500,7 @@ export async function handleFeishuMessage(params: {
           accountId: account.accountId,
           sessionKey: route.sessionKey,
           senderOpenId: ctx.senderOpenId,
+          chatId: ctx.chatId,
         },
         // Keep account context available while the agent executes plugin tools.
         () =>
@@ -1576,6 +1588,7 @@ export async function handleFeishuMessage(params: {
         accountId: account.accountId,
         sessionKey: route.sessionKey,
         senderOpenId: ctx.senderOpenId,
+        chatId: ctx.chatId,
       },
       // Tool calls produced by this turn should resolve to the same inbound account.
       () =>

package/src/channel.ts

@@ -2,11 +2,13 @@ import type { ChannelPlugin, ClawdbotConfig } from "openclaw/plugin-sdk";
 import { DEFAULT_ACCOUNT_ID, normalizeAccountId, PAIRING_APPROVED_MESSAGE } from "openclaw/plugin-sdk";
 import type { ResolvedFeishuAccount, FeishuConfig } from "./types.js";
 import {
+  resolveConfiguredFeishuAccountKey,
   resolveFeishuAccount,
   resolveFeishuCredentials,
   listFeishuAccountIds,
   resolveDefaultFeishuAccountId,
 } from "./accounts.js";
+import { monitorFeishuProvider } from "./monitor.js";
 import { feishuOutbound } from "./outbound.js";
 import { probeFeishu } from "./probe.js";
 import { resolveFeishuGroupToolPolicy } from "./policy.js";
@@ -60,6 +62,8 @@ export const feishuPlugin: ChannelPlugin<ResolvedFeishuAccount> = {
     messageToolHints: () => [
       "- Feishu targeting: omit `target` to reply to the current conversation (auto-inferred). Explicit targets: `user:open_id` or `chat:chat_id`.",
       "- Feishu supports interactive cards for rich messages.",
+      "- To send a file from the OpenClaw agent's local filesystem workspace (or another allowed local path) as a Feishu attachment, reply with a standalone `MEDIA:<absolute-path-or-url>` line.",
+      "- `feishu_drive` is for Feishu cloud Drive content, not for the OpenClaw agent's local filesystem workspace.",
     ],
   },
   groups: {
@@ -127,7 +131,6 @@ export const feishuPlugin: ChannelPlugin<ResolvedFeishuAccount> = {
     resolveAccount: (cfg, accountId) => resolveFeishuAccount({ cfg, accountId }),
     defaultAccountId: (cfg) => resolveDefaultFeishuAccountId(cfg),
     setAccountEnabled: ({ cfg, accountId, enabled }) => {
-      const account = resolveFeishuAccount({ cfg, accountId });
       const isDefault = accountId === DEFAULT_ACCOUNT_ID;
       
       if (isDefault) {
@@ -146,6 +149,7 @@ export const feishuPlugin: ChannelPlugin<ResolvedFeishuAccount> = {
       
       // For named accounts, set enabled in accounts[accountId]
       const feishuCfg = cfg.channels?.feishu as FeishuConfig | undefined;
+      const accountKey = resolveConfiguredFeishuAccountKey(cfg, accountId) ?? accountId;
       return {
         ...cfg,
         channels: {
@@ -154,8 +158,8 @@ export const feishuPlugin: ChannelPlugin<ResolvedFeishuAccount> = {
             ...feishuCfg,
             accounts: {
               ...feishuCfg?.accounts,
-              [accountId]: {
-                ...feishuCfg?.accounts?.[accountId],
+              [accountKey]: {
+                ...feishuCfg?.accounts?.[accountKey],
                 enabled,
               },
             },
@@ -182,7 +186,8 @@ export const feishuPlugin: ChannelPlugin<ResolvedFeishuAccount> = {
       // Delete specific account from accounts
       const feishuCfg = cfg.channels?.feishu as FeishuConfig | undefined;
       const accounts = { ...feishuCfg?.accounts };
-      delete accounts[accountId];
+      const accountKey = resolveConfiguredFeishuAccountKey(cfg, accountId) ?? accountId;
+      delete accounts[accountKey];
       
       return {
         ...cfg,
@@ -245,6 +250,7 @@ export const feishuPlugin: ChannelPlugin<ResolvedFeishuAccount> = {
       }
       
       const feishuCfg = cfg.channels?.feishu as FeishuConfig | undefined;
+      const accountKey = resolveConfiguredFeishuAccountKey(cfg, accountId) ?? accountId;
       return {
         ...cfg,
         channels: {
@@ -253,8 +259,8 @@ export const feishuPlugin: ChannelPlugin<ResolvedFeishuAccount> = {
             ...feishuCfg,
             accounts: {
               ...feishuCfg?.accounts,
-              [accountId]: {
-                ...feishuCfg?.accounts?.[accountId],
+              [accountKey]: {
+                ...feishuCfg?.accounts?.[accountKey],
                 enabled: true,
               },
             },
@@ -322,7 +328,6 @@ export const feishuPlugin: ChannelPlugin<ResolvedFeishuAccount> = {
   },
   gateway: {
     startAccount: async (ctx) => {
-      const { monitorFeishuProvider } = await import("./monitor.js");
       const account = resolveFeishuAccount({ cfg: ctx.cfg, accountId: ctx.accountId });
       const port = account.config?.webhookPort ?? null;
       ctx.setStatus({ accountId: ctx.accountId, port });

package/src/config-schema.ts

@@ -1,3 +1,4 @@
+import { normalizeAccountId } from "openclaw/plugin-sdk";
 import { z } from "zod";
 export { z };
 
@@ -91,6 +92,8 @@ const FeishuToolsConfigSchema = z
     task: z.boolean().optional(), // Task operations (default: true)
     chat: z.boolean().optional(), // Chat management operations (default: true)
     urgent: z.boolean().optional(), // Buzz/urgent notifications (default: true)
+    message: z.boolean().optional(), // Message reading (default: true)
+    reaction: z.boolean().optional(), // Emoji reactions (default: true)
   })
   .strict()
   .optional();
@@ -155,6 +158,7 @@ export const FeishuAccountConfigSchema = z
     mediaMaxMb: z.number().positive().optional(),
     mediaLocalRoots: z.array(z.string()).optional(),
     heartbeat: ChannelHeartbeatVisibilitySchema,
+    maxMessageAgeMs: z.number().positive().optional(),
     renderMode: RenderModeSchema,
     streaming: StreamingModeSchema,
     tools: FeishuToolsConfigSchema,
@@ -194,6 +198,7 @@ export const FeishuConfigSchema = z
     mediaMaxMb: z.number().positive().optional(),
     mediaLocalRoots: z.array(z.string()).optional(),
     heartbeat: ChannelHeartbeatVisibilitySchema,
+    maxMessageAgeMs: z.number().positive().optional(),
     renderMode: RenderModeSchema, // raw = plain text (default), card = interactive card with markdown
     streaming: StreamingModeSchema,
     tools: FeishuToolsConfigSchema,
@@ -204,6 +209,23 @@ export const FeishuConfigSchema = z
   })
   .strict()
   .superRefine((value, ctx) => {
+    const normalizedAccountIds = new Map<string, string>();
+    for (const accountId of Object.keys(value.accounts ?? {})) {
+      const normalizedAccountId = normalizeAccountId(accountId);
+      const previousAccountId = normalizedAccountIds.get(normalizedAccountId);
+      if (previousAccountId && previousAccountId !== accountId) {
+        ctx.addIssue({
+          code: z.ZodIssueCode.custom,
+          path: ["accounts", accountId],
+          message:
+            `channels.feishu.accounts contains duplicate account ids after normalization: ` +
+            `"${previousAccountId}" and "${accountId}" both normalize to "${normalizedAccountId}"`,
+        });
+        continue;
+      }
+      normalizedAccountIds.set(normalizedAccountId, accountId);
+    }
+
     if (value.dmPolicy === "open") {
       const allowFrom = value.allowFrom ?? [];
       const hasWildcard = allowFrom.some((entry) => String(entry).trim() === "*");

package/src/drive-tools/register.ts

@@ -59,7 +59,7 @@ export function registerFeishuDriveTools(api: OpenClawPluginApi) {
     name: "feishu_drive",
     label: "Feishu Drive",
     description:
-      "Feishu cloud storage operations. Actions: list, info, create_folder, move, delete, import_document. Use 'import_document' to create documents from Markdown with better structure preservation than block-by-block writing.",
+      "Feishu cloud Drive operations. This tool works with Feishu Drive folders/files/documents, not the OpenClaw agent's local filesystem workspace. Actions: list, info, create_folder, move, delete, import_document. Use 'import_document' to create documents from Markdown with better structure preservation than block-by-block writing.",
     parameters: FeishuDriveSchema,
     run: async ({ client, account }, params) => {
       const mediaMaxBytes = (account.config?.mediaMaxMb ?? 30) * 1024 * 1024;