Feishu Chat

💬 飞书群聊消息与@艾特完整指南

OpenClaw飞书群聊消息发送指南,支持Raw/Card双模式渲染、@成员艾特语法差异及机器人消息可见性管理。

收藏
7.2k
安装
1.5k
版本
1.0.2
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心功能

该技能为 OpenClaw 飞书(Lark)集成提供完整的群聊消息发送规范,涵盖两种渲染模式(Raw/Card)、@艾特语法差异、群成员ID管理三大核心模块。

核心用法

双模式消息系统

  • Raw 模式:通过 message() 工具发送纯文本,支持标准 @ 艾特语法 <at user_id="ou_xxx">nickname</at>,但不支持 Markdown 渲染
  • Card 模式:直接会话回复触发,支持完整 Markdown(代码块、表格、粗斜体、链接等),但 @ 语法变为 <at id=ou_xxx></at>

关键触发逻辑:当消息包含代码块、表格、粗体、链接等 Markdown 元素时,系统自动切换至 Card 模式渲染。

显著优点

1. 精确的语法对照表:明确区分 Raw/Card 两种模式下的 @ 语法差异,避免常见配置错误
2. 机器人消息可见性管理:明确指出"机器人仅接收被 @ 的消息"这一关键约束,帮助用户理解为何需要成员主动艾特才能识别身份

3. 决策树流程图:通过可视化决策树简化消息模式选择,降低使用门槛

4. 完整的 ID 格式参考:统一梳理 ou_xxx(用户)、cli_xxx(机器人)、oc_xxx(群组)三种 ID 格式

潜在局限

1. 模式自动切换风险:Card 模式的触发依赖内容特征检测,复杂结构可能导致误判
2. 不完全的 Markdown 支持:Card 模式不支持引用块(blockquote)、行内代码、水平分割线等标准 Markdown 语法

3. 双向语法隔离:Raw 与 Card 的 @ 语法互不兼容,用户需根据发送方式切换格式,增加记忆负担

适合人群

  • 需要通过 OpenClaw 向飞书群聊发送结构化消息的自动化工作流开发者
  • 构建飞书群组机器人交互系统的集成工程师
  • 需要协调多机器人协作、管理群成员艾特权限的群管理员

常规风险提示

  • @ 格式错误导致通知失败:混淆 user_id=id= 属性将导致艾特失效
  • 机器人消息盲区:未艾特机器人的消息对其完全不可见,需提前设计成员引导流程
  • 权限依赖:@所有人功能受群组权限设置制约,非所有群组默认可用

Feishu Chat 内容

手动下载zip · 3.0 kB
SKILL.mdtext/markdown
请选择文件