openclaw - 💡(How to fix) Fix [Bug] 飞书 post 模式下 @ 提及渲染为纯文本（双重根因）

环境

• OpenClaw: 2026.5.22
• 飞书群聊 topic/thread 模式

问题

Agent 通过 OpenClaw 飞书插件发送 post 模式消息时，<at user_id="xxx">name</at> 标签被飞书客户端渲染为纯文本，无法触发 @ 提及。

根因 1：post md 元素不解析 <at> 标签

sendMessageFeishu 将整条消息（含 <at> 标签）塞入单个 {tag:"md",text:"..."} 元素。飞书 post 的 md 元素不解析 <at> 标签。正确做法是将 @ 以独立的 {tag:"at",user_id:"xxx",user_name:"name"} 元素发送。

根因 2：bot cache 用 app_id 作 openId 导致名称查找冲突

CHAT_BOTS_SPEC.parseItem 将 im/v1/chats/{id}/members/bots 返回的 bot_id（cli_xxx 格式的 app_id）直接作为 openId 写入 user-name cache。而 resolveBotName 通过 bot/v3/bots/basic_batch 获取的是正确的 ou_xxx。两处写入了同一个 bot 名称 → lookupByName 命中两条冲突记录 → ambiguous → 不替换 → 原始标签原样输出。

修复建议

渲染层

sendMessageFeishu 的 post content 构建改为将 <at> 标签拆分为独立元素：

// 新增 splitAtElements 辅助函数
function splitAtElements(messageText) {
    const elements = [];
    const atRegex = /<at user_id="([^"]+)">([^<]*)<\/at>/g;
    // ... 拆分逻辑
}
// post 构建改为
content: [splitAtElements(messageText)]

数据层

CHAT_BOTS_SPEC.record 不再将 prefetched bot 写入 user-name cache，bot 名称交给 resolveBotName（bot/v3/bots/basic_batch）按需加载，确保 openId 正确。