核心功能
该技能为 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=属性将导致艾特失效 - 机器人消息盲区:未艾特机器人的消息对其完全不可见,需提前设计成员引导流程
- 权限依赖:@所有人功能受群组权限设置制约,非所有群组默认可用