本文，小编将以一个“控制OK1126B-S开发板上的Led灯闪烁节奏”的简单案例做演示，从基础开始逐步拆解Skills的设计与使用方法。

2、什么是Skills?

从本质上来说，Skills就是一本“操作手册”。它并不是直接帮AI完成任务，而是告诉AI在什么情况下应该做什么，以及如何去做。

我们用一个简单的类比来理解：

在射击游戏中，玩家的目标是击败敌人。枪作为工具，它的职责非常单一：

• 输入：扣动扳机
• 输出：发射子弹

至于子弹打到哪里，枪本身并不关心。而这个Skill的作用，则类似于“战术手册”。它会告诉AI：

• 什么时候可以开枪（检测到敌人）
• 什么时候不该开枪（有友军在前）
• 什么时候停止（敌人血量归零）

通过这些规则约束，AI就不再是一个机械执行指令的工具，而是开始具备初步的判断能力与决策逻辑，开始“像人一样思考”。

2.1 Skill的基本构成

在OpenClaw中，一个Skill实际上是一个结构化的目录，通常存放在：

~/.openclaw/workspace/skills/${SKILL_NAME}

一个完整的Skill由四个部分组成：

命名规范：

Skill的目录名称必须符合规范，否则无法被识别：

• 只能使用：小写字母+数字+连字符（-）
• 示例：gpio-led-control

这个规范虽然简单，但在实际开发中非常关键，很多Skill无法加载的问题，往往就出在这里。

2.2 SKILL.md 详细解释

SKILL.md是整个Skill的核心，可以理解为“说明书+行为指南”。它由两部分组成：

① 前置元数据（Metadata）

使用---包裹，主要用于定义Skill的基本信息，这些信息的作用是：

• 帮助OpenClaw识别Skill
• 提供语义匹配（Skill触发关键词）

例如：

--- name: gpio-led-control # 必填项 description: 开发板 GPIO LED 灯控制技能。 # 必填项 （以下列出部分可选项， 仅供参考） user-invocable: true # 可选:是否可被用户直接调用 ---

②正文（操作手册）

正文部分则就是具体的操作指导手册了，可以根据需求灵活组织，以我们已经提前写好的"gpio-led-control"下的SKILL.md 简化版为例进行展示：

# GPIO LED Control - 开发板 LED 灯控制 控制 OK1126B-S 等开发板上的系统 LED 灯（work/net 等）。 ## 快速开始 ### 查看可用 LED ### 控制 LED 亮灭 ## 使用场景示例 ## 权限说明 ## 注意事项

在实际编写时，可以根据需要扩展，例如：增加判断逻辑（何时执行）、增加错误处理、增加参数说明、增加示例输入输出等。除了核心的SKILL.md之外，其余三个目录属于辅助结构，各自承担不同角色。

其中，scripts目录主要用来存放可直接运行的脚本文件，适合那些执行逻辑固定、无需频繁改动的任务场景，例如控制LED灯的亮灭转换等。这类脚本可以被直接调用运行，从而减少重复生成代码的过程，提高整体执行效率与稳定性。

references目录则用于整理各类参考资料，例如：API文档、数据库结构说明或操作手册等。这些内容并不会在一开始全部加载，而是根据实际需要按需引入上下文，既避免了无关信息占用资源，也能在关键时刻为AI提供更深入、专业的知识支持。

而assets目录用于存放各类资源文件，例如模板、图片等。与 references 不同，这里的内容不会参与模型上下文推理，而是服务于最终结果的生成，例如报告模板、输出所需图片等，用于提升Skill输出的表现力和完整度。

2.3 自定义Skill编写流程

理解结构之后，我们就可以开始编写自己的Skill了。编写Skill的整个流程可以总结为：

需求分析→资源规划→初始化→编写→打包→测试

第一步：需求分析

在动手之前，必须明确：

• Skill要解决什么问题？
• 使用场景是什么？
• 用户会怎么触发它？
• 输入输出是什么？

触发条件一定要清晰，否则会出现Skill无法被调用或被错误调用的情况

第二步：资源规划

根据需求判断是否需要：

• scripts（是否需要执行代码）
• references（是否需要文档支持）
• assets（是否需要输出资源）

提前规划可以避免后期结构混乱以及反复修改导致的冗余

第三步：编写与调试

我们可以借助OpenClaw，在指定目录中自动生成一份符合规范的Skill初始模板，并在此基础上进行二次完善。不过需要注意的是，这类自动生成的Skill只是一个“起点”，通常无法直接满足实际需求。要想真正落地使用，仍然需要结合具体场景，对其内容进行逐步调整与反复测试，最终打磨出符合预期的功能效果。

3、Skill实战展示

为了更直观地理解，我们编写了一个简单的Skill并放在了对应的目录下，该Skill用于控制OK1126B-S开发板上两颗 LED灯的闪烁。

在OpenClaw这么火，用它做个飞书助手怎么样？一文中，我们已经将安装在开发板上的OpenClaw接入了飞书，因此，我们此时可以直接用飞书对OpenClaw下达命令。

接入不同的Skill后，OpenClaw会：识别用户意图→匹配对应Skill→根据SKILL.md的规则执行→调用scripts中的脚本→返回执行结果。

整个过程无需人工干预，实现真正的“自然语言控制硬件”。

4、总结

我们通过拆解Skills的核心概念、结构，并结合LED控制简易实操案例，清晰展现了Skills的落地应用逻辑。即便只是基础的硬件控制场景，这个案例也直指Skills的核心价值：把复杂业务流程封装成可复用的标准化能力单元。

Skills的设计初衷，就是实现指令化调用、规范化执行：完成Skills搭建后，仅需一句指令即可驱动AI按预设规则完成任务，既彻底规避重复开发、重复调试的冗余劳动，又能保障全场景任务执行的稳定性与一致性，在嵌入式开发、自动化运维、智能设备管控等领域具备极强的实用价值。

嵌入式领域是OpenClaw生态落地的核心突破口，既是实现硬件实时交互、落地边缘智能的关键入口，也是整个生态中增长潜力最大、优质能力供给最紧缺的赛道。只有持续打造丰富、易用、高可靠的嵌入式Skills能力池，OpenClaw才能突破桌面工具的定位局限，真正成长为覆盖“云-边-端”全链路的完整智能执行框架。