openclaw-lark-multi-agent 0.1.6 → 0.1.8

package/dist/feishu-bot.d.ts

@@ -73,6 +73,7 @@ export declare class FeishuBot {
     private resolveHumanName;
     private cleanMentions;
     private stripLeadingCommandMentions;
+    private buildMarkdownCard;
     private replyMessage;
     private extractBridgeAttachments;
     private validateBridgeAttachmentPath;

package/dist/feishu-bot.js

@@ -344,7 +344,7 @@ export class FeishuBot {
             // Single slash commands are handled by the bridge. Double slash commands were
             // already unescaped above and should pass through to OpenClaw instead.
             const isBridgeCommand = !commandText.startsWith("//");
-            const isCommand = isBridgeCommand && /^\/(help|status|compact|reset|verbose|free)/.test(cleanText.trim());
+            const isCommand = isBridgeCommand && /^\/(help|status|compact|reset|verbose|free|mute|mode)/.test(cleanText.trim());
             if (isCommand) {
                 // In group chats, bridge commands must be explicitly routed to this bot
                 // or @all. Do not let Free Discussion make a bot execute commands meant
@@ -366,7 +366,9 @@ export class FeishuBot {
                         `🧹 /compact — 压缩当前 bot 的 OpenClaw session`,
                         `🔄 /reset   — 重置当前 bot 的 OpenClaw session`,
                         `🔊 /verbose — 开关当前聊天里的 Tool Call 显示`,
-                        `🔓 /free [on|off|status] — 开关当前 bot 在当前群聊的 Free Discussion`,
+                        `🔓 /free   — 切换当前 bot 的 free 模式（不 @ 也可回复）`,
+                        `🤐 /mute   — 切换当前 bot 的 mute 模式（禁言，不转发 OpenClaw）`,
+                        `🎛️ /mode   — 查看当前 bot 在当前群聊的模式`,
                         `❓ /help    — 显示此帮助信息`,
                         ``,
                         `OpenClaw 原生命令（双斜杠，会转成单斜杠发给 OpenClaw）`,
@@ -425,31 +427,63 @@ export class FeishuBot {
                 }
                 if (cleanText.trim().startsWith("/free")) {
                     if (chatType === "p2p") {
-                        await this.replyMessage(messageId, "❌ Free Discussion 只在群聊中可用");
+                        await this.replyMessage(messageId, "❌ Free 模式只在群聊中可用");
                         markCommandSynced();
                         return;
                     }
-                    const parts = cleanText.trim().split(/\s+/);
-                    const arg = (parts[1] || "").toLowerCase();
-                    const isOn = this.store.getBotFreeDiscussion(this.config.name, chatId);
-                    const next = arg === "on" || arg === "true" || arg === "1"
-                        ? true
-                        : arg === "off" || arg === "false" || arg === "0"
-                            ? false
-                            : arg === "status"
-                                ? isOn
-                                : !isOn;
-                    if (arg !== "status")
-                        this.store.setBotFreeDiscussion(this.config.name, chatId, next);
-                    if (next) {
-                        await this.replyMessage(messageId, `🔓 ${this.config.name} Free Discussion 已开启\n只影响当前 Bot 在当前群聊的自由发言（连续 Bot 回复超过 ${MAX_BOT_STREAK} 轮将暂停，等待人类发言）`);
+                    const current = this.store.getBotMode(this.config.name, chatId);
+                    const next = current === "free" ? "normal" : "free";
+                    this.store.setBotMode(this.config.name, chatId, next);
+                    if (next === "free") {
+                        await this.replyMessage(messageId, `🔓 ${this.config.name} 已切换到 free 模式\n不需要 @ 也可以参与回复（连续 Bot 回复超过 ${MAX_BOT_STREAK} 轮将暂停，等待人类发言）`);
                     }
                     else {
-                        await this.replyMessage(messageId, `🔒 ${this.config.name} Free Discussion 已关闭\n只影响当前 Bot；群聊中需要 @ 指定 Bot 才会回复`);
+                        await this.replyMessage(messageId, `🔒 ${this.config.name} 已切换到 normal 模式\n只有明确 @ 我才会回复`);
                     }
                     markCommandSynced();
                     return;
                 }
+                if (cleanText.trim().startsWith("/mute")) {
+                    if (chatType === "p2p") {
+                        await this.replyMessage(messageId, "❌ Mute 模式只在群聊中可用");
+                        markCommandSynced();
+                        return;
+                    }
+                    const current = this.store.getBotMode(this.config.name, chatId);
+                    const next = current === "mute" ? "normal" : "mute";
+                    this.store.setBotMode(this.config.name, chatId, next);
+                    if (next === "mute") {
+                        await this.replyMessage(messageId, `🤐 ${this.config.name} 已切换到 mute 模式\n普通消息、@所有人 都不会回复；明确 @ 我时只提示禁言中`);
+                    }
+                    else {
+                        await this.replyMessage(messageId, `🔒 ${this.config.name} 已解除 mute，回到 normal 模式\n只有明确 @ 我才会回复`);
+                    }
+                    markCommandSynced();
+                    return;
+                }
+                if (cleanText.trim().startsWith("/mode")) {
+                    if (chatType === "p2p") {
+                        await this.replyMessage(messageId, `🎛️ ${this.config.name} 当前模式：normal（私聊总是响应）`);
+                    }
+                    else {
+                        const mode = this.store.getBotMode(this.config.name, chatId);
+                        const desc = mode === "free" ? "不需要 @ 也可以参与回复" : mode === "mute" ? "禁言中；明确 @ 我时只提示禁言中" : "只有明确 @ 我才会回复";
+                        await this.replyMessage(messageId, `🎛️ ${this.config.name} 当前模式：${mode}\n${desc}`);
+                    }
+                    markCommandSynced();
+                    return;
+                }
+            }
+            // --- Mute mode: do not forward anything to OpenClaw. Only direct mentions get a local notice. ---
+            if (chatType !== "p2p" && !isBot && this.store.getBotMode(this.config.name, chatId) === "mute") {
+                if (this.isMentioned(message.mentions || [])) {
+                    await this.replyMessage(messageId, `🤐 ${this.config.name} 当前处于 mute 模式，发送 /mute 可解除`);
+                    if (insertedId > 0) {
+                        this.store.markSynced(this.config.name, chatId, insertedId);
+                        this.store.clearPendingTriggers(this.config.name, chatId, insertedId);
+                    }
+                }
+                return;
             }
             // --- Should this bot respond? ---
             if (!this.shouldRespond(chatType, message, isBot, chatId, message.content))
@@ -663,9 +697,9 @@ export class FeishuBot {
         const anyBotMentioned = mentions.some((m) => this.mentionedBotName(m) !== null);
         if (anyBotMentioned && !this.isMentioned(mentions))
             return false;
-        // No bot mentioned: check free discussion mode
+        // No bot mentioned: check current per-bot mode
         if (chatId) {
-            if (this.store.getBotFreeDiscussion(this.config.name, chatId))
+            if (this.store.getBotMode(this.config.name, chatId) === "free")
                 return true;
         }
         // Default: don't respond without @
@@ -724,16 +758,23 @@ export class FeishuBot {
         }
         return s;
     }
-    async replyMessage(messageId, text) {
-        // Use interactive card for markdown rendering
-        const card = {
-            elements: [
-                {
-                    tag: "markdown",
-                    content: text,
-                },
-            ],
+    buildMarkdownCard(text) {
+        return {
+            schema: "2.0",
+            config: { wide_screen_mode: true },
+            body: {
+                elements: [
+                    {
+                        tag: "markdown",
+                        content: text,
+                    },
+                ],
+            },
         };
+    }
+    async replyMessage(messageId, text) {
+        // Use Feishu CardKit v2 markdown component for full Markdown rendering.
+        const card = this.buildMarkdownCard(text);
         try {
             await this.client.im.message.reply({
                 path: { message_id: messageId },
@@ -889,14 +930,7 @@ ${doc.url}`);
      * Send a proactive message to a chat (not a reply).
      */
     async sendMessage(chatId, text) {
-        const card = {
-            elements: [
-                {
-                    tag: "markdown",
-                    content: text,
-                },
-            ],
-        };
+        const card = this.buildMarkdownCard(text);
         try {
             await this.client.im.message.create({
                 params: { receive_id_type: "chat_id" },
@@ -1000,7 +1034,7 @@ ${doc.url}`);
         const sessionExists = session ? "✅ 活跃" : "⏳ 未初始化";
         const status = session?.status || "unknown";
         const verboseStatus = this.store.getBotVerbose(this.config.name, chatId) ? "🔊 开启" : "🔇 关闭";
-        const freeStatus = this.store.getBotFreeDiscussion(this.config.name, chatId) ? "🔓 开启" : "🔒 关闭";
+        const mode = chatType === "p2p" ? "normal" : this.store.getBotMode(this.config.name, chatId);
         const statusText = [
             `📊 ${this.config.name} Bot Status`,
             `━━━━━━━━━━━━━━━━━━`,
@@ -1013,7 +1047,7 @@ ${doc.url}`);
             `🧮 上下文: ${fmtK(totalTokens)} / ${fmtK(contextTokens)} (${usedPct}%)${tokenNote}`,
             `📥 输入: ${fmtK(inputTokens)} | 📤 输出: ${fmtK(outputTokens)}`,
             `🔧 Verbose: ${verboseStatus}`,
-            `💬 Free Discussion: ${freeStatus}`,
+            `🎛️ Mode: ${mode}`,
         ].join("\n");
         await this.replyMessage(messageId, statusText);
     }

package/dist/message-store.d.ts

@@ -1,3 +1,4 @@
+export type BotChatMode = "normal" | "free" | "mute";
 export interface ChatInfo {
     chatId: string;
     chatType: "p2p" | "group";
@@ -8,7 +9,7 @@ export interface ChatInfo {
     memberNames: string;
     /** Which bot owns this chat (for p2p isolation) */
     ownerBot: string;
-    /** Free discussion mode (group chat: all bots respond without @) */
+    /** Legacy chat-level free discussion flag; per-bot mode is authoritative. */
     freeDiscussion: boolean;
     verbose: boolean;
     updatedAt: number;
@@ -58,6 +59,8 @@ export declare class MessageStore {
     setVerbose(chatId: string, verbose: boolean): void;
     setBotVerbose(botName: string, chatId: string, verbose: boolean): void;
     getBotVerbose(botName: string, chatId: string): boolean;
+    setBotMode(botName: string, chatId: string, mode: BotChatMode): void;
+    getBotMode(botName: string, chatId: string): BotChatMode;
     setBotFreeDiscussion(botName: string, chatId: string, on: boolean): void;
     getBotFreeDiscussion(botName: string, chatId: string): boolean;
     getChatInfo(chatId: string): ChatInfo | null;

package/dist/message-store.js

@@ -76,6 +76,7 @@ export class MessageStore {
         chat_id TEXT NOT NULL,
         verbose INTEGER NOT NULL DEFAULT 0,
         free_discussion INTEGER NOT NULL DEFAULT 0,
+        mode TEXT NOT NULL DEFAULT 'normal',
         updated_at INTEGER NOT NULL DEFAULT 0,
         PRIMARY KEY (bot_name, chat_id)
       );
@@ -108,6 +109,18 @@ export class MessageStore {
         catch {
             // Column already exists
         }
+        // Migration: replace independent free/mute booleans with one mutually exclusive mode.
+        try {
+            this.db.exec(`ALTER TABLE bot_chat_settings ADD COLUMN mode TEXT NOT NULL DEFAULT 'normal'`);
+        }
+        catch {
+            // Column already exists
+        }
+        this.db.exec(`
+      UPDATE bot_chat_settings
+      SET mode = 'free'
+      WHERE free_discussion = 1 AND (mode IS NULL OR mode = '' OR mode = 'normal')
+    `);
     }
     /**
      * Insert a message. Returns the auto-increment id, or -1 if duplicate.
@@ -278,21 +291,31 @@ export class MessageStore {
     `).get(botName, chatId);
         return !!row?.verbose;
     }
-    setBotFreeDiscussion(botName, chatId, on) {
+    setBotMode(botName, chatId, mode) {
+        const freeDiscussion = mode === "free" ? 1 : 0;
         this.db.prepare(`
-      INSERT INTO bot_chat_settings (bot_name, chat_id, free_discussion, updated_at)
-      VALUES (?, ?, ?, ?)
+      INSERT INTO bot_chat_settings (bot_name, chat_id, mode, free_discussion, updated_at)
+      VALUES (?, ?, ?, ?, ?)
       ON CONFLICT (bot_name, chat_id) DO UPDATE SET
+        mode = excluded.mode,
         free_discussion = excluded.free_discussion,
         updated_at = excluded.updated_at
-    `).run(botName, chatId, on ? 1 : 0, Date.now());
+    `).run(botName, chatId, mode, freeDiscussion, Date.now());
     }
-    getBotFreeDiscussion(botName, chatId) {
+    getBotMode(botName, chatId) {
         const row = this.db.prepare(`
-      SELECT free_discussion FROM bot_chat_settings
+      SELECT mode, free_discussion FROM bot_chat_settings
       WHERE bot_name = ? AND chat_id = ?
     `).get(botName, chatId);
-        return !!row?.free_discussion;
+        if (row?.mode === "free" || row?.mode === "mute" || row?.mode === "normal")
+            return row.mode;
+        return row?.free_discussion ? "free" : "normal";
+    }
+    setBotFreeDiscussion(botName, chatId, on) {
+        this.setBotMode(botName, chatId, on ? "free" : "normal");
+    }
+    getBotFreeDiscussion(botName, chatId) {
+        return this.getBotMode(botName, chatId) === "free";
     }
     getChatInfo(chatId) {
         const row = this.db.prepare(`SELECT * FROM chat_info WHERE chat_id = ?`).get(chatId);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openclaw-lark-multi-agent",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "description": "Multi-bot Lark/Feishu bridge for OpenClaw, with per-bot model routing and isolated sessions",
   "type": "module",
   "scripts": {