核心用法
本 Skill 为 OpenClaw 与飞书（Feishu/Lark）群组集成提供完整的消息发送与成员管理能力，核心围绕两种消息渲染模式展开：
- Raw 模式（纯文本）：通过
message工具发送，支持@提及但不支持 Markdown 渲染（加粗、代码块、表格等均失效）。适用于纯文本通知、简单 @ 提醒。 - Card 模式（Markdown）：通过直接回复触发，完整支持 Markdown 语法（代码块、表格、字体颜色、链接等），但 @ 语法与 Raw 模式不同。
关键差异：两种模式的 @提及 XML 格式完全不同——Raw 模式使用 <at user_id="ID">nickname</at>，Card 模式使用 <at id=ID></at>，混用将导致 @ 失效。
成员 ID 获取机制
飞书机器人的核心限制是仅能看到 @ 自己的消息。获取用户 open_id（ou_xxx）必须通过用户主动 @ 机器人后发消息，系统日志中会显示 [Feishu oc_xxx:ou_xxx timestamp] nickname: content。机器人 App ID（cli_xxx）需从飞书开发者后台获取。
适用人群
- 使用 OpenClaw 接入飞书群组的开发者/运维人员
- 需要程序化发送格式化消息（代码、表格）的技术团队
- 构建多机器人协作工作流的管理员
显著优点
1. 双模式灵活选择：简单通知用 Raw，复杂排版用 Card，避免过度设计
2. 精准权限隔离：机器人仅响应 @ 提及，天然具备消息过滤能力，减少无效触发
3. 完整 Markdown 支持：Card 模式下代码块、表格、彩色字体等企业协作高频需求全覆盖
潜在局限与风险
- 语法陷阱高发：@ 格式在两种模式下不兼容，极易因复制粘贴导致通知失败
- 机器人可见性受限：无法监听群历史消息或被动监控聊天内容，必须依赖用户主动 @ 交互
- 部分 Markdown 不稳定：块引用、行内代码、分隔线在 Card 模式下支持不佳
- @everyone 需权限：依赖群组管理员配置，非默认能力
安全与可信度说明
- 来源为 OpenClaw 官方扩展源码（
~/.openclaw/extensions/feishu/src/），属第一方实现 - 无外部网络请求或敏感权限申请，消息内容遵循飞书开放平台标准协议
- 主要风险在于消息格式误用导致通知失败，非数据泄露类问题