大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。



作者： OpenClaw 社区
版本： 1.0
更新时间： 2026-03-11
适用版本： OpenClaw 2026.3.2+ | 飞书插件 @openclaw/feishu@2026.3.7+

---

1. 前言
2. 什么是 Skill
3. 飞书 Skill 架构解析
4. Skill 开发环境准备
5. 创建第一个飞书 Skill
6. SKILL.md 编写详解
7. 工具集成开发
8. 进阶技能开发
9. 调试与测试
10. 发布与分享
11. **实践
12. 常见问题

---

在 OpenClaw 中，Skill（技能） 是扩展 AI 助手能力的核心机制。通过开发飞书 Skill，你可以让 AI 助手：

•  自动创建和编辑飞书云文档
•  操作多维表格（Bitable）数据
•  管理飞书云空间文件
•  维护知识库（Wiki）内容
•  管理权限和协作
•  发送定制化消息通知

本教程将带你从零开始，掌握飞书 Skill 的完整开发流程。

学完本教程你将能够：

---

Skill 的定义

Skill 是一个自包含的功能包，它为 AI 助手提供：

1. 领域知识 - 特定业务场景的专业知识
2. 工作流程 - 多步骤任务的执行指南
3. 工具集成 - 与外部系统（如飞书 API）的交互能力
4. 资源包 - 脚本、模板、参考文档等

Skill vs 插件 vs 工具

关系图：

GPT plus 代充 只需 145

Skill 的触发机制

Skill 通过 YAML Frontmatter 中的 字段自动触发：

当用户消息匹配描述中的关键词时，Skill 会被激活并加载到上下文中。

---

现有 Skill 结构

查看已安装的飞书 Skill：

GPT plus 代充 只需 145

输出：

标准目录结构

GPT plus 代充 只需 145

SKILL.md 文件结构

GPT plus 代充 只需 145

2. 检查飞书插件

确保包含：

• ✅ - 插件配置
• ✅ - 入口文件
• ✅ - 技能目录
• ✅ - 源代码

3. 验证工具可用性

GPT plus 代充 只需 145

预期输出：

4. 准备开发目录

GPT plus 代充 只需 145

---

实战案例：会议纪要自动生成器

我们将创建一个名为 的 Skill，功能是：

• 根据会议录音转写文本自动生成结构化纪要
• 创建飞书云文档并格式化内容
• 自动@参会人员并设置提醒

Step 1: 初始化技能

Step 2: 编写 SKILL.md

创建 文件：

GPT plus 代充 只需 145

3. 格式化文档内容

使用标准模板：

4. 写入文档内容

GPT plus 代充 只需 145

5. 设置提醒（可选）

使用 创建跟进任务：

• 飞书文档 API
• 会议纪要模板规范

1. 必须传入 ，否则用户无法访问文档
2. 行动项表格使用 一步创建
3. 长会议内容分批次写入，避免单次请求过大

GPT plus 代充 只需 145

Step 4: 创建辅助脚本（可选）

创建 ：

Step 5: 测试技能

GPT plus 代充 只需 145

---

YAML Frontmatter 规范

好的 description 示例

GPT plus 代充 只需 145

差的 description 示例 ❌

Body 内容组织

推荐结构

GPT plus 代充 只需 145

工具 2

…

1. 步骤一
2. 步骤二
3. 步骤三

• 链接 1
• 链接 2

⚠️ 重要提示…

2. 提供具体示例

   GPT plus 代充 只需 145

3. 说明限制和边界

   GPT plus 代充 只需 145

4. 引用参考文档

❌ 不应该做的

1. 不要重复工具已有的说明
2. 不要包含过时的信息
3. 不要写长篇大论的理论
4. 不要包含测试代码或调试信息

---

理解现有工具

feishu_doc 工具

支持的操作：

完整参数参考：

GPT plus 代充 只需 145

feishu_drive 工具

支持的操作：

⚠️ 重要限制： 机器人没有根文件夹概念，只能访问已共享的文件夹。

feishu_wiki 工具

Wiki-文档工作流：

工具调用模式

模式 1：单次调用

GPT plus 代充 只需 145

模式 2：链式调用

模式 3：条件调用

GPT plus 代充 只需 145

---

案例 1：项目周报自动生成

需求： 每周五自动收集团队成员的工作汇报，生成结构化周报文档。

Skill 设计：

4. 格式化内容

GPT plus 代充 只需 145

5. 发送通知

使用 消息工具发送到管理群：

GPT plus 代充 只需 145

2. 识别问题

检查项：

3. 生成整理报告

创建临时文档列出问题：

4. 执行整理

根据用户确认执行：

• 移动节点到新位置
• 重命名冲突页面
• 删除重复内容
• 更新索引页

GPT plus 代充 只需 145

2. 应用权限模板

对每个文档执行：

3. 验证结果

抽样检查权限是否正确应用。

GPT plus 代充 只需 145

观察：

• Skill 是否正确触发
• 工具调用参数是否正确
• 返回结果是否符合预期

方法 2：查看日志

方法 3：使用调试模式

GPT plus 代充 只需 145

常见问题排查

问题 1: Skill 不触发

症状： 用户提到相关关键词，但 Skill 未激活

排查步骤：

解决方案：

GPT plus 代充 只需 145

问题 2: 工具调用失败

症状： Skill 触发但工具返回错误

排查步骤：

常见错误：

问题 3: 文档创建后无法访问

症状： 文档创建成功，但用户看不到

原因： 未设置

解决方案：

GPT plus 代充 只需 145

从 inbound metadata 获取用户 ID：

性能优化

1. 减少上下文占用

GPT plus 代充 只需 145

2. 使用参考文档

将详细内容移到 目录：

3. 脚本代替说明

GPT plus 代充 只需 145

---

打包技能

输出：

GPT plus 代充 只需 145

验证打包结果

分享给社区

方式 1: GitHub 发布

1. Fork OpenClaw 仓库
2. 将技能添加到 目录
3. 提交 Pull Request
4. 等待审核合并

方式 2: 直接分享

GPT plus 代充 只需 145

版本管理

在 SKILL.md 中添加版本信息：

---

设计原则

1. 单一职责

每个 Skill 只解决一类问题：

GPT plus 代充 只需 145

2. 渐进式披露

3. 容错设计

GPT plus 代充 只需 145

命名规范

文档结构

GPT plus 代充 只需 145

测试清单

在发布前检查：

---

Q1: Skill 和 Tool 有什么区别？

A:

• Tool 是底层 API 封装，提供具体操作能力
• Skill 是业务场景指导，告诉 AI 何时及如何使用 Tool

例如：

• (Tool) - 提供 , , 等操作
• (Skill) - 指导 AI 在用户需要会议纪要时调用

Q2: 如何调试 Skill 触发问题？

A:

Q3: 技能文件应该放在哪里？

A:
推荐位置：

GPT plus 代充 只需 145

也可以放在：

Q4: 如何引用外部 API 文档？

A:
使用 目录：

GPT plus 代充 只需 145

Q5: Skill 会影响性能吗？

A:

• 未触发时： 只加载 ~100 字的 metadata，几乎无影响
• 触发后： 加载完整 SKILL.md，占用上下文
• 优化方法： 使用 references 分流详细内容

Q6: 可以调用外部 API 吗？

A:
可以，通过 中的脚本：

在 Skill 中说明：

GPT plus 代充 只需 145

---

附录 A: 完整 Skill 示例

查看完整示例：

附录 B: 飞书 API 速查

附录 C: 工具命令

GPT plus 代充 只需 145

附录 D: 参考资源

---

本教程最后更新：2026-03-11
基于 OpenClaw 2026.3.3 编写