openclaw-lark Skills 技能体系深度解读9 个飞书技能如何让 AI 正确调用每个 API【免费下载链接】openclaw-lark飞书官方出品的 OpenClaw 飞书/Lark Channel 插件项目地址: https://gitcode.com/gh_mirrors/op/openclaw-larkopenclaw-lark是飞书官方出品的 OpenClaw 飞书/Lark Channel 插件让你的 AI 助手直接读取消息、创建云文档、操作多维表格、管理日历和任务。但真正让它聪明的是隐藏在skills/目录下的Skills 技能体系——9 份精心编写的 SKILL.md 指南把飞书 API 的坑、字段格式、错误码全部教给了 AI让模型不再瞎猜参数。本文带你拆解这套机制的设计思路 什么是 Skill给 AI 的上岗手册大模型调用 API 时最常见的失败原因不是能力不足而是缺少暗知识飞书 API 的 Schema 只告诉你参数叫什么却不告诉你人员字段必须传对象数组、日期必须用毫秒时间戳这类规则。openclaw-lark 的解法是为每个高频场景写一份 Markdown 格式的技能说明书AI 在执行任务前会先阅读它再动手调用工具。一个 Skill 就是一个文件夹 一份 SKILL.md全部注册在插件清单中技能目录声明openclaw.plugin.json工具契约声明39 个飞书工具openclaw.plugin.json全景图9 个飞书技能各管一摊技能职责核心工具 / 对应源码️ feishu-bitable多维表格建表、增删改查记录src/tools/oapi/bitable/ feishu-calendar日程创建、参会人、忙闲查询src/tools/oapi/calendar/ feishu-channel-rules飞书会话输出风格常驻生效纯提示词无源码依赖✍️ feishu-create-doc用 Markdown 创建云文档src/tools/mcp/doc/create.ts feishu-fetch-doc读取云文档、解析知识库类型src/tools/mcp/doc/fetch.ts feishu-im-read读历史消息、话题、搜索、下载资源src/tools/oapi/im/✅ feishu-task任务/清单/子任务/附件管理src/tools/oapi/task/ feishu-troubleshootFAQ /feishu doctor深度诊断src/commands/doctor.ts feishu-update-doc7 种模式更新文档src/tools/mcp/doc/update.ts 注意一个设计细节feishu-channel-rules在 frontmatter 中声明了alwaysActive: true它不依赖用户说了什么而是在每次飞书会话中常驻注入约束 AI 的输出风格简短、口语化、低仪式感并提醒 AI 参照 markdown-syntax.md 处理飞书与标准 Markdown 的差异。SKILL.md 的五段式结构为什么有效通读 9 份技能文件会发现它们遵循同一套模板这正是本体系最值得学习的地方1️⃣ YAML 头部触发路由description 即何时用我每个 SKILL.md 开头的description都写明了触发条件例如 feishu-im-read 列出了 6 种命中场景用户提到聊天记录、消息、群里说了什么、话题回复……AI 根据用户话语中的关键词匹配技能选错技能的概率被大幅压低。2️⃣ 执行前必读把坑变成规则以多维表格为例执行前必读 直接列出了 8 条硬约束默认表自带空行写入前建议先清理人员字段传[{id:ou_xxx}]不能传字符串日期字段是毫秒时间戳不是秒批量上限 500 条同表不支持并发写3️⃣ 快速索引表意图 → 工具 → 必填参数这是整套体系的核心翻译层。feishu-bitable 的索引表 把用户想要什么直接映射到调哪个工具、传什么参数AI 不用再从 39 个工具里大海捞针。日历技能中同理快速索引 还额外标注了强烈建议列——比如创建会议时建议传user_open_id否则发起人不会出现在参会人列表里。4️⃣ 核心约束Schema 未透露的知识这是信息密度最高的章节。API 文档不会告诉你为什么参数 A 和 B 互斥SKILL.md 会feishu-calendar 解释user_open_id的作用把发起人加为参会人才能收到通知、回复 RSVPfeishu-task 讲解auth_type双身份用户身份只能操作自己参与的任务且工具会自动把创建者加为关注人防止建完任务自己改不了的经典翻车5️⃣ 常见错误排查表让 AI 具备自愈能力feishu-bitable 的错误码速查表 把1254064日期格式错、1254015字段类型不匹配等错误码与根因、解法一一对应。AI 调用失败后读到错误码就能自行定位并修正参数重试而不是把错误原样甩给用户。三个典型案例看技能如何救场案例 1写多维表格前先读表SKILL.md 强制规定三步流程参考先调字段list拿类型 → 按类型构造值 → 遇125406X错误码回查 record-values.md。此外复杂场景关联字段、附件上传等 8 个完整示例拆到了 examples.md主文件保持精简——渐进式披露需要时才展开。案例 2读消息时自动展开话题feishu-im-read 的核心约束 3 告诉 AI发现thread_id时主动拉取话题最新 10 条回复补全上下文用户要完整对话时再全量翻页。没有这条规则AI 只会返回一屏孤零零的群消息。案例 3改文档别手滑清空全文feishu-update-doc 支持 7 种更新模式追加、覆盖、定位替换、前/后插入、删除等并明确警告优先局部更新慎用overwrite——它会清空重写文档可能丢失图片和评论。还支持标题定位## 章节标题自动匹配整章等高级玩法。出问题时怎么办/feishu doctor 一键体检feishu-troubleshoot技能是体系中的安全网。常规权限问题会自动触发授权流程只有疑难杂症才需要手动诊断在飞书会话中直接发送/feishu doctor它会检查凭证完整性、API 连通性、应用/用户双侧权限并生成诊断报告与一键申请链接完整流程见 诊断命令说明。新手阅读路线图 想深入理解这套体系建议按以下顺序阅读入口openclaw.plugin.json —— 看技能与工具如何注册结构标杆feishu-bitable/SKILL.md —— 五段式最完整含 references 子目录常驻规则feishu-channel-rules/SKILL.md —— 了解 alwaysActive 机制实战源码src/tools/oapi/ 与 src/tools/mcp/ —— 看技能背后的工具实现总结openclaw-lark 的 Skills 体系证明了让 AI 正确调用 API 的关键不是更大的模型而是更准的上下文。一份好的 SKILL.md 至少包含——清晰的触发条件、意图到工具的映射表、Schema 之外的暗知识、错误码自愈表。如果你想给自己的 OpenClaw 插件加技能这 9 份文件就是最好的模板 【免费下载链接】openclaw-lark飞书官方出品的 OpenClaw 飞书/Lark Channel 插件项目地址: https://gitcode.com/gh_mirrors/op/openclaw-lark创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考