核心用法
本技能为OpenClaw提供飞书(Lark)群聊消息发送的完整操作规范,主要包含三大功能模块:
1. 双模式消息发送系统
- Raw模式(message工具):纯文本发送,支持@提及但不支持Markdown渲染,适用于简单通知
- Card模式(直接回复):Markdown富文本渲染,支持代码块、表格、加粗、斜体、链接、彩色文字等,触发条件为内容包含任何Markdown元素
2. @提及格式规范(关键差异)
| 模式 | 正确格式 | 错误示例 |
|------|---------|---------|
| Raw | `<at user_id="ou_xxx">昵称</at>` | `<at id="ou_xxx">` |
| Card | `<at id=ou_xxx></at>` | `<at user_id="ou_xxx">` ❌ |
支持目标:人类(ou_xxx)、机器人(cli_xxx)、全体(all)
3. 成员ID获取与管理
- 核心限制:机器人只能接收@提及自己的消息,未@的消息不可见
- 获取人类open_id:需对方@机器人后发消息,从消息头
[Feishu oc_xxx:ou_xxx timestamp]提取 - 获取机器人App ID:需用户从开发者控制台(https://open.feishu.cn/app)复制cli_xxx
显著优点
- 覆盖飞书消息场景完整(纯文本/Markdown双轨并行)
- @格式差异明确标注,避免常见配置错误
- 机器人可见性限制说明清晰,减少调试困惑
- 提供决策树快速参考,降低使用门槛
潜在缺点与局限
- Card模式限制:不支持引用块(>)、行内代码(`)不稳定、分割线(---)不稳定
- 机器人间通信阻断:机器人只能接收人类消息,无法接收其他机器人消息(即使@提及)
- Auto模式不可靠:文档明确建议避免使用,需手动选择模式
- 权限依赖:@全体需要群组管理权限配置
适合人群
- OpenClaw管理员配置飞书集成
- 需要自动化飞书群通知的开发者
- 在飞书群组中部署AI助手机器人的技术团队
常规风险
- 格式混用导致@提及失效(最常见错误)
- 误判消息可见性(认为机器人能"看到"所有群消息)
- Card模式使用不支持样式导致渲染异常
- 机器人间协作场景设计失败(试图让A机器人@通知B机器人)