本系列第十六篇：从“用户”到“创作者”——你写的每一段说明，都是 AI 的执行蓝图
欢迎回到 OpenClaw 系列教程。前面十五篇，你学会了安装、配置、装 Skills。现在的 OpenClaw 已经能完成很多任务了。
但如果你问一个深度用户，最能让你愿意持续投入时间学这个项目的功能是什么？大部分人的回答会出奇一致——不是某个现成的 Skill 多好用，而是我终于可以自己写 Skill 了。
在 OpenClaw 的 Skill 系统中，每一个技能只是一个 Markdown 文件。会打字就能开发，10 分钟就能做出第一个可运行、可复用、可分享的技能包。开发 Skill 的本质，不是写复杂代码，而是给 AI 一份清晰的“执行说明书”，教会它“什么时候用什么工具、按什么顺序干活”。
本篇将系统讲解自定义 Skill 的完整开发流程，从文件夹结构、SKILL.md 核心文件的编写，到进阶带脚本的技能开发，再到调试测试与发布分享。无论你是零代码用户还是资深开发者，都能找到适合自己的开发路径。
一、核心认知：Skill 到底是什么？
在动手之前，先建立三个关键认知，能帮你省掉后面 80% 的弯路。
认知一：Skill 是一份“说明书”，不是一段程序。 Skill 不是后台插件，它不需要复杂的代码逻辑，核心就是一个带 YAML 元数据的 Markdown 文件。AI 读取后就知道“遇到什么情况时，按什么步骤做”。整个 Skill 就是一个文件夹，里面放一个 SKILL.md 文件，OpenClaw 通过这个文件理解技能的功能、触发条件和执行流程。
认知二：Skill 专注于“怎么做”，不参与“理解什么”。 用户说的话由 OpenClaw 内核转成结构化指令，Skill 只负责接收标准化输入、执行具体操作、返回标准化结果。它不参与意图解析，不管理权限，专注于做好一件事。
认知三：Skill 遵循三大设计理念。 OpenClaw Skill 的设计遵循三个核心理念：渐进式披露——YAML 元数据每次都加载（简洁高效），Markdown 正文仅在匹配时加载，链接文件按需加载，既节省 Token 又保证深度；可组合性——技能之间互不干扰，可同时启用；可移植性——按规范开发的技能可在多个平台通用。
二、两种开发路径：你属于哪一类？
OpenClaw 支持两种 Skill 开发路径，你可以根据自己的技术水平选择合适的起点：
路径一：自然语言 Skill（零代码，推荐新手）
- 只需要编写 Markdown 文件，通过说明性指令定义工作流
- 适合纯流程指引类任务，如文档处理建议、工作流指导
- 学习成本最低，10 分钟可完成第一个技能
路径二：TypeScript/脚本 Skill（需编程基础）
- 用 TypeScript 编写核心逻辑，可访问 API、执行复杂计算
- 适合需要调用外部服务、处理数据的复杂任务
- 遵循“3 文件核心结构”：plugin.json（元信息）+ index.ts（执行逻辑）+ package.json（依赖）
本文将从零代码的自然语言 Skill 开始，再讲解带脚本的进阶技能开发。选择哪条路径，取决于你的任务复杂度和编程基础。
三、你的第一个 Skill：Hello World
我们先从最基础的“打招呼”技能开始，掌握完整的开发与测试流程。
3.1 创建 Skill 目录
Skills 可以放在两个位置，根据需求选择：
bash
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容，请联系我们，一经查实，本站将立刻删除。
如需转载请保留出处：https://51itzy.com/kjqy/264928.html