Feishu Chat

💬 飞书群聊消息与@提及权威指南

飞书群聊消息发送指南,支持Raw/Card双模式渲染、@成员提及格式与群组管理,适用于OpenClaw集成场景

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

使用说明

核心用法

本技能为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机器人)

Feishu Chat 内容

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