By name: feishu description: 当用户要在飞书上发消息、创建任务、操作文档、管理日程或群组时使用。 version: 2.1.0 metadata: zhiwei: tags: - feishu - 飞书 - lark - im - notification suggested_tools: - channel.feishu
飞书集成指南
channel.feishu 工具按 action 路由飞书各类操作，必须传 instanceId（用户配置过的飞书渠道实例）。
适用场景
- 飞书消息发送（个人 / 群组 / 富文本卡片）
- 飞书任务创建与管理
- 飞书文档创建 / 分享 / 内容操作
- 飞书日程查询 / 创建
- 飞书群管理（创建 / 加成员 / 设置）
不适用场景
- 邮件发送 →
shell_exec+ curl - 钉钉 / 企业微信 → 对应渠道 Skill
- 纯文档撰写不发飞书 → content-creator
- 知微对话内通知用户 → 直接说就行（或
notify）
工作流
| 用户表达 | 路径 |
|---|---|
| 发消息 / 卡片 / 回复 / 改 / 撤 | send_message / send_card / reply_message / update_message / recall_message |
| 上传 / 下载文件 | upload_file / download_file |
| 任务 / 文档 / 日程 | create_task / create_document / create_calendar_event |
| 建群 / 改群成员 | create_group / manage_members |
各路径要点：
- instanceId 优先：未配置直接提示用户去渠道实例配置页，不要伪造、不要重试
- 收件人类型对齐：
receiveIdType必须和targetId实际类型一致（chat_id / open_id / user_id），错配会直接 4xx - 二次确认：撤回消息、创建群、改群成员、含敏感信息的发送，发起前先把目标 + 内容摘要给用户、等确认
- 失败给原因：限流 / 权限不足 / 收件人不存在分别有不同错误码，参考表里有对照
详细参考
- 完整 action 参数清单与示例：
{skill_dir}/references/actions-reference.md