@larksuite/openclaw-lark 2026.3.29 → 2026.3.30-beta.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@larksuite/openclaw-lark",
-  "version": "2026.3.29",
+  "version": "2026.3.30-beta.1",
   "description": "OpenClaw Lark/Feishu channel plugin",
   "exports": {
     ".": {
@@ -31,6 +31,11 @@
   "peerDependencies": {
     "openclaw": ">=2026.3.22"
   },
+  "peerDependenciesMeta": {
+    "openclaw": {
+      "optional": true
+    }
+  },
   "openclaw": {
     "extensions": [
       "./index.js"

package/src/card/builder.d.ts

@@ -95,8 +95,10 @@ export declare function formatFooterRuntimeSegments(params: {
     isError?: boolean;
     isAborted?: boolean;
 }): {
-    zh: string[];
-    en: string[];
+    primaryZh: string[];
+    primaryEn: string[];
+    detailZh: string[];
+    detailEn: string[];
 };
 /**
  * Build a full Feishu Interactive Message Card JSON object for the

package/src/card/builder.js

@@ -161,35 +161,46 @@ function compactNumber(value) {
 }
 function formatFooterRuntimeSegments(params) {
     const { footer, metrics, elapsedMs, isError, isAborted } = params;
-    const zhParts = [];
-    const enParts = [];
+    const primaryZh = [];
+    const primaryEn = [];
+    const detailZh = [];
+    const detailEn = [];
+    // --- Primary line: status, elapsed, model ---
     if (footer?.status) {
         if (isError) {
-            zhParts.push('出错');
-            enParts.push('Error');
+            primaryZh.push('出错');
+            primaryEn.push('Error');
         }
         else if (isAborted) {
-            zhParts.push('已停止');
-            enParts.push('Stopped');
+            primaryZh.push('已停止');
+            primaryEn.push('Stopped');
         }
         else {
-            zhParts.push('已完成');
-            enParts.push('Completed');
+            primaryZh.push('已完成');
+            primaryEn.push('Completed');
         }
     }
     if (footer?.elapsed && elapsedMs != null) {
         const d = formatElapsed(elapsedMs);
-        zhParts.push(`耗时 ${d}`);
-        enParts.push(`Elapsed ${d}`);
+        primaryZh.push(`耗时 ${d}`);
+        primaryEn.push(`Elapsed ${d}`);
     }
+    if (footer?.model && metrics?.model) {
+        const model = metrics.model.trim();
+        if (model) {
+            primaryZh.push(model);
+            primaryEn.push(model);
+        }
+    }
+    // --- Detail line: tokens, cache, context ---
     if (footer?.tokens && metrics) {
         const inTokens = typeof metrics.inputTokens === 'number' ? Math.max(0, metrics.inputTokens) : undefined;
         const outTokens = typeof metrics.outputTokens === 'number' ? Math.max(0, metrics.outputTokens) : undefined;
         if (inTokens != null && outTokens != null) {
             const inLabel = compactNumber(inTokens);
             const outLabel = compactNumber(outTokens);
-            zhParts.push(`↑ ${inLabel} ↓ ${outLabel}`);
-            enParts.push(`↑ ${inLabel} ↓ ${outLabel}`);
+            detailZh.push(`↑ ${inLabel} ↓ ${outLabel}`);
+            detailEn.push(`↑ ${inLabel} ↓ ${outLabel}`);
         }
     }
     if (footer?.cache && metrics) {
@@ -201,8 +212,8 @@ function formatFooterRuntimeSegments(params) {
             const hit = total > 0 ? Math.round((read / total) * 100) : 0;
             const left = compactNumber(read);
             const right = compactNumber(write);
-            zhParts.push(`缓存 ${left}/${right} (${hit}%)`);
-            enParts.push(`Cache ${left}/${right} (${hit}%)`);
+            detailZh.push(`缓存 ${left}/${right} (${hit}%)`);
+            detailEn.push(`Cache ${left}/${right} (${hit}%)`);
         }
     }
     if (footer?.context && metrics) {
@@ -214,18 +225,11 @@ function formatFooterRuntimeSegments(params) {
             const ctxLabel = compactNumber(ctx);
             const pct = ctx > 0 ? Math.round((total / ctx) * 100) : 0;
             const pctLabel = `${pct}%`;
-            zhParts.push(`上下文 ${totalLabel}/${ctxLabel} (${pctLabel})`);
-            enParts.push(`Context ${totalLabel}/${ctxLabel} (${pctLabel})`);
-        }
-    }
-    if (footer?.model && metrics?.model) {
-        const model = metrics.model.trim();
-        if (model) {
-            zhParts.push(model);
-            enParts.push(model);
+            detailZh.push(`上下文 ${totalLabel}/${ctxLabel} (${pctLabel})`);
+            detailEn.push(`Context ${totalLabel}/${ctxLabel} (${pctLabel})`);
         }
     }
-    return { zh: zhParts, en: enParts };
+    return { primaryZh, primaryEn, detailZh, detailEn };
 }
 // ---------------------------------------------------------------------------
 // buildCardContent
@@ -369,17 +373,28 @@ function buildCompleteCard(params) {
             text_size: 'notation',
         });
     }
-    // Footer meta-info: each metadata item is independently controlled via
-    // the `footer` config.
-    const footerParts = formatFooterRuntimeSegments({
+    // Footer meta-info: split into two lines for readability.
+    // Line 1 (primary): status · elapsed · model
+    // Line 2 (detail):  tokens · cache · context
+    const fp = formatFooterRuntimeSegments({
         footer,
         metrics: footerMetrics,
         elapsedMs,
         isError,
         isAborted,
     });
-    if (footerParts.zh.length > 0) {
-        elements.push(...buildFooter(footerParts.zh.join(' · '), footerParts.en.join(' · '), isError));
+    const footerZhLines = [];
+    const footerEnLines = [];
+    if (fp.primaryZh.length > 0) {
+        footerZhLines.push(fp.primaryZh.join(' · '));
+        footerEnLines.push(fp.primaryEn.join(' · '));
+    }
+    if (fp.detailZh.length > 0) {
+        footerZhLines.push(fp.detailZh.join(' · '));
+        footerEnLines.push(fp.detailEn.join(' · '));
+    }
+    if (footerZhLines.length > 0) {
+        elements.push(...buildFooter(footerZhLines.join('\n'), footerEnLines.join('\n'), isError));
     }
     // Use the answer text (not reasoning) as the feed preview summary.
     // Strip markdown syntax so the preview reads as plain text.

package/src/card/streaming-card-controller.js

@@ -16,6 +16,7 @@ exports.StreamingCardController = void 0;
 exports.prepareTerminalCardContent = prepareTerminalCardContent;
 const promises_1 = require("node:fs/promises");
 const reply_runtime_1 = require("openclaw/plugin-sdk/reply-runtime");
+const agent_runtime_1 = require("openclaw/plugin-sdk/agent-runtime");
 const api_error_1 = require("../core/api-error.js");
 const lark_logger_1 = require("../core/lark-logger.js");
 const lark_client_1 = require("../core/lark-client.js");
@@ -120,15 +121,37 @@ class StreamingCardController {
             const cfgWithSession = this.deps.cfg;
             const sessionStorePath = cfgWithSession.sessions?.store ?? cfgWithSession.session?.store;
             const key = this.deps.sessionKey.trim().toLowerCase();
+            // WORKAROUND: SDK session key round-trip bug.
+            // The SDK's toAgentRequestSessionKey() strips the agent scope from keys
+            // like "agent:hr:main" → "main", then toAgentStoreSessionKey() rebuilds
+            // using the default agent ID → "agent:main:main".  This means metrics
+            // written by the SDK always land under "agent:<defaultAgentId>:…"
+            // regardless of the account-scoped agent ID the plugin routing generated.
+            // Fallback: when the primary key misses, try replacing the agent-id
+            // segment with the resolved default agent ID.
+            // TODO: remove once the SDK preserves the original agent ID during the
+            // request→store key round-trip.
+            const defaultAgentId = (0, agent_runtime_1.resolveDefaultAgentId)(this.deps.cfg);
+            const fallbackKey = key.replace(/^(agent):[^:]+:/, `$1:${defaultAgentId}:`);
+            const candidateKeys = fallbackKey !== key ? [key, fallbackKey] : [key];
             const sessionApi = runtime.agent?.session;
             if (sessionApi?.resolveStorePath && sessionApi?.loadSessionStore) {
                 const storePath = sessionApi.resolveStorePath(sessionStorePath);
                 const store = sessionApi.loadSessionStore(storePath);
-                const entry = store[key];
-                if (!entry || typeof entry !== 'object') {
+                let entry;
+                let matchedKey;
+                for (const candidate of candidateKeys) {
+                    const val = store[candidate];
+                    if (val && typeof val === 'object') {
+                        entry = val;
+                        matchedKey = candidate;
+                        break;
+                    }
+                }
+                if (!entry) {
                     log.debug('footer metrics lookup: session entry missing', {
                         sessionKey: this.deps.sessionKey,
-                        normalizedSessionKey: key,
+                        candidateKeys,
                         storePath,
                         source: 'runtime.agent.session',
                     });
@@ -146,16 +169,9 @@ class StreamingCardController {
                 };
                 log.debug('footer metrics lookup: session entry found', {
                     sessionKey: this.deps.sessionKey,
-                    normalizedSessionKey: key,
+                    matchedKey,
                     storePath,
                     source: 'runtime.agent.session',
-                    hasMetrics: !!(metrics.inputTokens != null ||
-                        metrics.outputTokens != null ||
-                        metrics.cacheRead != null ||
-                        metrics.cacheWrite != null ||
-                        metrics.totalTokens != null ||
-                        metrics.contextTokens != null ||
-                        metrics.model),
                 });
                 return metrics;
             }
@@ -169,11 +185,20 @@ class StreamingCardController {
             const store = parsed && typeof parsed === 'object' && !Array.isArray(parsed)
                 ? parsed
                 : {};
-            const entry = store[key];
-            if (!entry || typeof entry !== 'object') {
+            let entry;
+            let matchedKey;
+            for (const candidate of candidateKeys) {
+                const val = store[candidate];
+                if (val && typeof val === 'object') {
+                    entry = val;
+                    matchedKey = candidate;
+                    break;
+                }
+            }
+            if (!entry) {
                 log.debug('footer metrics lookup: session entry missing', {
                     sessionKey: this.deps.sessionKey,
-                    normalizedSessionKey: key,
+                    candidateKeys,
                     storePath,
                     source: 'channel.session.file',
                 });
@@ -191,16 +216,9 @@ class StreamingCardController {
             };
             log.debug('footer metrics lookup: session entry found', {
                 sessionKey: this.deps.sessionKey,
-                normalizedSessionKey: key,
+                matchedKey,
                 storePath,
                 source: 'channel.session.file',
-                hasMetrics: !!(metrics.inputTokens != null ||
-                    metrics.outputTokens != null ||
-                    metrics.cacheRead != null ||
-                    metrics.cacheWrite != null ||
-                    metrics.totalTokens != null ||
-                    metrics.contextTokens != null ||
-                    metrics.model),
             });
             return metrics;
         }

package/src/core/accounts.js

@@ -37,9 +37,30 @@ function baseConfig(section) {
     const { accounts: _ignored, ...rest } = section;
     return rest;
 }
-/** Merge base config with account override (account fields take precedence). */
+/** Merge base config with account override (account fields take precedence).
+ *  Performs a one-level deep merge for plain-object fields so that partial
+ *  account overrides (e.g. `footer: { model: false }`) are merged with
+ *  the base instead of replacing the entire object. */
 function mergeAccountConfig(base, override) {
-    return { ...base, ...override };
+    const result = { ...base };
+    for (const [key, value] of Object.entries(override)) {
+        if (value === undefined)
+            continue;
+        const baseVal = base[key];
+        // Deep-merge plain objects one level (footer, tools, heartbeat, etc.)
+        if (value &&
+            typeof value === 'object' &&
+            !Array.isArray(value) &&
+            baseVal &&
+            typeof baseVal === 'object' &&
+            !Array.isArray(baseVal)) {
+            result[key] = { ...baseVal, ...value };
+        }
+        else {
+            result[key] = value;
+        }
+    }
+    return result;
 }
 /** Coerce a domain string to `LarkBrand`, defaulting to `"feishu"`. */
 function toBrand(domain) {

package/src/core/lark-client.d.ts

@@ -106,15 +106,19 @@ export declare class LarkClient {
     private waitForAbort;
 }
 /**
- * Returns the freshest available config for account resolution.
+ * Returns the best available config for account resolution.
+ *
+ * Priority: live config (has `channels.feishu`) > fallback (has
+ * `channels.feishu`) > live config (last resort).
  *
  * The `config` object captured in tool-registration closures may be stale
- * after a hot-reload: openclaw re-initialises the runtime but the plugin
- * closure still holds the old snapshot.  Calling
- * `LarkClient.runtime.config.loadConfig()` always returns the current live
- * config, so account lookups pick up any changes made since plugin load.
+ * after a hot-reload, so we prefer the live config from
+ * `LarkClient.runtime.config.loadConfig()`.  However, `loadConfig()` may
+ * return `{}` when the runtime config snapshot has been cleared (e.g. in
+ * isolated cron sessions), so we fall back to the closure-captured config
+ * when the live result lacks Feishu credentials.
  *
  * @param fallback - Config to use when the runtime is not yet initialised
- *   (e.g. during early startup before the first `LarkClient.runtime` attach).
+ *   or when `loadConfig()` returns an incomplete config.
  */
 export declare function getResolvedConfig(fallback: ClawdbotConfig): ClawdbotConfig;

package/src/core/lark-client.js

@@ -427,20 +427,35 @@ exports.LarkClient = LarkClient;
 // Config resolution helper
 // ---------------------------------------------------------------------------
 /**
- * Returns the freshest available config for account resolution.
+ * Returns the best available config for account resolution.
+ *
+ * Priority: live config (has `channels.feishu`) > fallback (has
+ * `channels.feishu`) > live config (last resort).
  *
  * The `config` object captured in tool-registration closures may be stale
- * after a hot-reload: openclaw re-initialises the runtime but the plugin
- * closure still holds the old snapshot.  Calling
- * `LarkClient.runtime.config.loadConfig()` always returns the current live
- * config, so account lookups pick up any changes made since plugin load.
+ * after a hot-reload, so we prefer the live config from
+ * `LarkClient.runtime.config.loadConfig()`.  However, `loadConfig()` may
+ * return `{}` when the runtime config snapshot has been cleared (e.g. in
+ * isolated cron sessions), so we fall back to the closure-captured config
+ * when the live result lacks Feishu credentials.
  *
  * @param fallback - Config to use when the runtime is not yet initialised
- *   (e.g. during early startup before the first `LarkClient.runtime` attach).
+ *   or when `loadConfig()` returns an incomplete config.
  */
 function getResolvedConfig(fallback) {
     try {
-        return LarkClient.runtime.config.loadConfig();
+        const live = LarkClient.runtime.config.loadConfig();
+        // loadConfig() may return {} (empty config) when runtimeConfigSnapshot
+        // has been cleared (e.g. after writeConfigFile, secrets teardown, or
+        // concurrent cron race conditions in isolated sessions).  In that case
+        // the closure-captured fallback still holds a valid resolved config.
+        if (live?.channels?.feishu)
+            return live;
+        if (fallback?.channels?.feishu) {
+            log.debug(`loadConfig() returned config without channels.feishu, using fallback`);
+            return fallback;
+        }
+        return live;
     }
     catch {
         // runtime not yet initialised — fall back to passed config

package/src/core/version.d.ts

@@ -12,14 +12,20 @@
  * @returns 版本号字符串，如 "2026.2.28.5"；读取失败返回 "unknown"
  */
 export declare function getPluginVersion(): string;
+/**
+ * 获取当前运行平台名称
+ *
+ * @returns `mac` | `linux` | `windows`
+ */
+export declare function getPlatform(): string;
 /**
  * 生成 User-Agent 字符串
  *
- * @returns User-Agent 字符串，格式：`openclaw-lark/{version}`
+ * @returns User-Agent 字符串，格式：`openclaw-lark/{version}/{platform}`
  *
  * @example
  * ```typescript
- * getUserAgent() // => "openclaw-lark/2026.2.28.5"
+ * getUserAgent() // => "openclaw-lark/2026.2.28.5/mac"
  * ```
  */
 export declare function getUserAgent(): string;

package/src/core/version.js

@@ -9,6 +9,7 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getPluginVersion = getPluginVersion;
+exports.getPlatform = getPlatform;
 exports.getUserAgent = getUserAgent;
 const node_url_1 = require("node:url");
 const node_path_1 = require("node:path");
@@ -38,16 +39,31 @@ function getPluginVersion() {
         return cachedVersion;
     }
 }
+/**
+ * 获取当前运行平台名称
+ *
+ * @returns `mac` | `linux` | `windows`
+ */
+function getPlatform() {
+    switch (process.platform) {
+        case 'darwin':
+            return 'mac';
+        case 'win32':
+            return 'windows';
+        default:
+            return 'linux';
+    }
+}
 /**
  * 生成 User-Agent 字符串
  *
- * @returns User-Agent 字符串，格式：`openclaw-lark/{version}`
+ * @returns User-Agent 字符串，格式：`openclaw-lark/{version}/{platform}`
  *
  * @example
  * ```typescript
- * getUserAgent() // => "openclaw-lark/2026.2.28.5"
+ * getUserAgent() // => "openclaw-lark/2026.2.28.5/mac"
  * ```
  */
 function getUserAgent() {
-    return `openclaw-lark/${getPluginVersion()}`;
+    return `openclaw-lark/${getPluginVersion()}/${getPlatform()}`;
 }

package/src/messaging/outbound/actions.js

@@ -55,9 +55,12 @@ const SUPPORTED_ACTIONS = new Set([
 function parseCardParam(raw) {
     if (raw == null)
         return undefined;
-    // Already a non-array object — use directly.
+    // Already a non-array object — use directly (empty {} is never a valid card).
     if (typeof raw === 'object' && !Array.isArray(raw)) {
-        return raw;
+        const obj = raw;
+        if (Object.keys(obj).length === 0)
+            return undefined;
+        return obj;
     }
     // String — attempt JSON.parse.
     if (typeof raw === 'string') {