核心用法
本技能提供飞书(Lark)群聊的完整消息发送与管理指南,适用于OpenClaw集成环境。核心功能分为两大模式:
1. Raw模式(纯文本)
- 通过
message工具发送,适用于纯文本消息和@提及 - @格式:
<at user_id="ID">nickname</at> - 支持人类(ou_xxx)、机器人(cli_xxx)和全员(all)三种目标类型
- ❌ 不支持Markdown渲染、表格、链接等富文本格式
2. Card模式(Markdown)
- 通过会话直接回复发送,支持完整Markdown渲染
- @格式:
<at id=ID></at>(与Raw模式语法不同) - ✅ 支持加粗、斜体、删除线、颜色标签、链接、标题、列表、代码块、表格
- ❌ 不支持引用块、行内代码、水平分割线
群成员管理要点
- 关键限制:机器人只能接收被@提及的消息,无法看到未被@的普通群消息
- 获取open_id:需要人类成员@机器人发送消息,系统会显示
[Feishu oc_xxx:ou_xxx timestamp] nickname: content - 获取Bot App ID:需用户从飞书开发者控制台(https://open.feishu.cn/app)手动提供
- 建议维护群成员清单存储于memory file
重要约束
- 禁止混用:同一内容不可同时使用message工具和直接回复,会导致重复发送
- Bot-to-Bot通信不可能:机器人只能接收人类消息,无法接收其他机器人消息(即使@了也不会通知)
- @everyone需要群权限设置
显著优点
- 提供清晰的决策树,帮助用户快速选择Raw/Card模式
- @提及语法对照表直观明了,避免常见格式错误
- 详细标注各模式的Capability矩阵,降低试错成本
- 针对飞书特有的机器人权限限制给出明确说明
潜在缺点与局限性
- 两种模式@语法不统一,容易混淆导致@失败
- 需要人工维护群成员ID映射表,无自动同步机制
- Card模式对部分标准Markdown元素支持不稳定(行内代码、水平分割线)
- Bot间通信限制可能打断自动化工作流设计
适合人群
- 使用OpenClaw+飞书集成的开发者和运营人员
- 需要在飞书群内实现自动化消息推送、通知告警的团队
- 需要格式化报告、代码片段、表格展示的机器人开发者
常规风险
- 格式错误导致@通知失败,重要消息未被目标接收
- 混用发送方式造成消息重复,干扰群聊体验
- 依赖人工提供的Bot App ID可能存在输入错误风险
- 机器人权限限制可能导致消息监听盲区,需设计补偿机制
来源与可信度
基于OpenClaw官方扩展源码(bot.ts, reply-dispatcher.ts, mention.ts, send.ts)实测验证,测试日期2026-02-27至2026-02-28。属于官方技术文档的一手资料,可信度较高。