Feishu Chat

💬 飞书群聊消息发送与@提及指南

飞书(Lark)群聊消息发送指南,支持纯文本(Raw)与卡片(Card)两种模式,提供@成员、Markdown格式化、群成员ID管理等功能。

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

使用说明

核心用法

本技能提供飞书(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。属于官方技术文档的一手资料,可信度较高。

Feishu Chat 内容

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