在OpenClaw這么火，用它做個(gè)飛書助手怎么樣？（進(jìn)入飛凌嵌入式賬號(hào)主頁，上一篇文章就是）一文中，講解了將OpenClaw部署在OK1126B-S開發(fā)板，并通過飛書調(diào)用部署在服務(wù)器上的本地模型，從而實(shí)現(xiàn)一個(gè)屬于我們自己的本地AI助手的方法。本篇文章，我們將進(jìn)一步深入挖掘OpenClaw的核心能力之一 —— Skills。

1、OpenClaw Skills 生態(tài)

如果說模型本身是“大腦”，那么Skills更像是“經(jīng)驗(yàn)+行動(dòng)指南”。通過編寫Skills，我們可以讓OpenClaw不再只是被動(dòng)回答問題，而是能夠按照既定規(guī)則，主動(dòng)完成復(fù)雜任務(wù)。

截至發(fā)稿前，ClawHub社區(qū)中發(fā)布的Skills數(shù)量已達(dá)到了2.6w+，但這些Skills中超過99%都是面向Windows/x86 Linux/Mac且聚焦于辦公、網(wǎng)頁自動(dòng)化等方面，面向嵌入式Linux的Skills數(shù)量極少且成熟度較低，缺乏對(duì)嵌入式外設(shè)（GPIO、UART、SPI、I2C、傳感器、電機(jī)、攝像頭）的標(biāo)準(zhǔn)化封裝與驅(qū)動(dòng)適配，并且沒有針對(duì)邊緣計(jì)算、低功耗、實(shí)時(shí)性場(chǎng)景（如工業(yè)控制、機(jī)器人、智能家居、車載等）的專用技能集。

難道嵌入式領(lǐng)域就不配吃"龍蝦"嗎？！

本文，小編將以一個(gè)“控制OK1126B-S開發(fā)板上的Led燈閃爍節(jié)奏”的簡(jiǎn)單案例做演示，從基礎(chǔ)開始逐步拆解Skills的設(shè)計(jì)與使用方法。

2、什么是Skills?

從本質(zhì)上來說，Skills就是一本“操作手冊(cè)”。它并不是直接幫AI完成任務(wù)，而是告訴AI在什么情況下應(yīng)該做什么，以及如何去做。

我們用一個(gè)簡(jiǎn)單的類比來理解：

在射擊游戲中，玩家的目標(biāo)是擊敗敵人。槍作為工具，它的職責(zé)非常單一：

• 輸入：扣動(dòng)扳機(jī)
• 輸出：發(fā)射子彈

至于子彈打到哪里，槍本身并不關(guān)心。而這個(gè)Skill的作用，則類似于“戰(zhàn)術(shù)手冊(cè)”。它會(huì)告訴AI：

• 什么時(shí)候可以開槍（檢測(cè)到敵人）
• 什么時(shí)候不該開槍（有友軍在前）
• 什么時(shí)候停止（敵人血量歸零）

通過這些規(guī)則約束，AI就不再是一個(gè)機(jī)械執(zhí)行指令的工具，而是開始具備初步的判斷能力與決策邏輯，開始“像人一樣思考”。

2.1 Skill的基本構(gòu)成

在OpenClaw中，一個(gè)Skill實(shí)際上是一個(gè)結(jié)構(gòu)化的目錄，通常存放在：

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

一個(gè)完整的Skill由四個(gè)部分組成：

命名規(guī)范：

Skill的目錄名稱必須符合規(guī)范，否則無法被識(shí)別：

• 只能使用：小寫字母+數(shù)字+連字符（-）
• 示例：gpio-led-control

這個(gè)規(guī)范雖然簡(jiǎn)單，但在實(shí)際開發(fā)中非常關(guān)鍵，很多Skill無法加載的問題，往往就出在這里。

2.2 SKILL.md 詳細(xì)解釋

SKILL.md是整個(gè)Skill的核心，可以理解為“說明書+行為指南”。它由兩部分組成：

① 前置元數(shù)據(jù)（Metadata）

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

• 幫助OpenClaw識(shí)別Skill
• 提供語義匹配（Skill觸發(fā)關(guān)鍵詞）

例如：

--- name: gpio-led-control # 必填項(xiàng) description: 開發(fā)板 GPIO LED 燈控制技能。 # 必填項(xiàng) （以下列出部分可選項(xiàng)， 僅供參考） user-invocable: true # 可選:是否可被用戶直接調(diào)用 ---

②正文（操作手冊(cè)）

正文部分則就是具體的操作指導(dǎo)手冊(cè)了，可以根據(jù)需求靈活組織，以我們已經(jīng)提前寫好的"gpio-led-control"下的SKILL.md 簡(jiǎn)化版為例進(jìn)行展示：

# GPIO LED Control - 開發(fā)板 LED 燈控制 控制 OK1126B-S 等開發(fā)板上的系統(tǒng) LED 燈（work/net 等）。 ## 快速開始 ### 查看可用 LED ### 控制 LED 亮滅 ## 使用場(chǎng)景示例 ## 權(quán)限說明 ## 注意事項(xiàng)

在實(shí)際編寫時(shí)，可以根據(jù)需要擴(kuò)展，例如：增加判斷邏輯（何時(shí)執(zhí)行）、增加錯(cuò)誤處理、增加參數(shù)說明、增加示例輸入輸出等。除了核心的SKILL.md之外，其余三個(gè)目錄屬于輔助結(jié)構(gòu)，各自承擔(dān)不同角色。

其中，scripts目錄主要用來存放可直接運(yùn)行的腳本文件，適合那些執(zhí)行邏輯固定、無需頻繁改動(dòng)的任務(wù)場(chǎng)景，例如控制LED燈的亮滅轉(zhuǎn)換等。這類腳本可以被直接調(diào)用運(yùn)行，從而減少重復(fù)生成代碼的過程，提高整體執(zhí)行效率與穩(wěn)定性。

references目錄則用于整理各類參考資料，例如：API文檔、數(shù)據(jù)庫結(jié)構(gòu)說明或操作手冊(cè)等。這些內(nèi)容并不會(huì)在一開始全部加載，而是根據(jù)實(shí)際需要按需引入上下文，既避免了無關(guān)信息占用資源，也能在關(guān)鍵時(shí)刻為AI提供更深入、專業(yè)的知識(shí)支持。

而assets目錄用于存放各類資源文件，例如模板、圖片等。與 references 不同，這里的內(nèi)容不會(huì)參與模型上下文推理，而是服務(wù)于最終結(jié)果的生成，例如報(bào)告模板、輸出所需圖片等，用于提升Skill輸出的表現(xiàn)力和完整度。

2.3 自定義Skill編寫流程

理解結(jié)構(gòu)之后，我們就可以開始編寫自己的Skill了。編寫Skill的整個(gè)流程可以總結(jié)為：

需求分析→資源規(guī)劃→初始化→編寫→打包→測(cè)試

第一步：需求分析

在動(dòng)手之前，必須明確：

• Skill要解決什么問題？
• 使用場(chǎng)景是什么？
• 用戶會(huì)怎么觸發(fā)它？
• 輸入輸出是什么？

觸發(fā)條件一定要清晰，否則會(huì)出現(xiàn)Skill無法被調(diào)用或被錯(cuò)誤調(diào)用的情況

第二步：資源規(guī)劃

根據(jù)需求判斷是否需要：

• scripts（是否需要執(zhí)行代碼）
• references（是否需要文檔支持）
• assets（是否需要輸出資源）

提前規(guī)劃可以避免后期結(jié)構(gòu)混亂以及反復(fù)修改導(dǎo)致的冗余

第三步：編寫與調(diào)試

我們可以借助OpenClaw，在指定目錄中自動(dòng)生成一份符合規(guī)范的Skill初始模板，并在此基礎(chǔ)上進(jìn)行二次完善。不過需要注意的是，這類自動(dòng)生成的Skill只是一個(gè)“起點(diǎn)”，通常無法直接滿足實(shí)際需求。要想真正落地使用，仍然需要結(jié)合具體場(chǎng)景，對(duì)其內(nèi)容進(jìn)行逐步調(diào)整與反復(fù)測(cè)試，最終打磨出符合預(yù)期的功能效果。

3、Skill實(shí)戰(zhàn)展示

為了更直觀地理解，我們編寫了一個(gè)簡(jiǎn)單的Skill并放在了對(duì)應(yīng)的目錄下，該Skill用于控制OK1126B-S開發(fā)板上兩顆 LED燈的閃爍。

在OpenClaw這么火，用它做個(gè)飛書助手怎么樣？一文中，我們已經(jīng)將安裝在開發(fā)板上的OpenClaw接入了飛書，因此，我們此時(shí)可以直接用飛書對(duì)OpenClaw下達(dá)命令。

接入不同的Skill后，OpenClaw會(huì)：識(shí)別用戶意圖→匹配對(duì)應(yīng)Skill→根據(jù)SKILL.md的規(guī)則執(zhí)行→調(diào)用scripts中的腳本→返回執(zhí)行結(jié)果。

整個(gè)過程無需人工干預(yù)，實(shí)現(xiàn)真正的“自然語言控制硬件”。

4、總結(jié)

我們通過拆解Skills的核心概念、結(jié)構(gòu)，并結(jié)合LED控制簡(jiǎn)易實(shí)操案例，清晰展現(xiàn)了Skills的落地應(yīng)用邏輯。即便只是基礎(chǔ)的硬件控制場(chǎng)景，這個(gè)案例也直指Skills的核心價(jià)值：把復(fù)雜業(yè)務(wù)流程封裝成可復(fù)用的標(biāo)準(zhǔn)化能力單元。

Skills的設(shè)計(jì)初衷，就是實(shí)現(xiàn)指令化調(diào)用、規(guī)范化執(zhí)行：完成Skills搭建后，僅需一句指令即可驅(qū)動(dòng)AI按預(yù)設(shè)規(guī)則完成任務(wù)，既徹底規(guī)避重復(fù)開發(fā)、重復(fù)調(diào)試的冗余勞動(dòng)，又能保障全場(chǎng)景任務(wù)執(zhí)行的穩(wěn)定性與一致性，在嵌入式開發(fā)、自動(dòng)化運(yùn)維、智能設(shè)備管控等領(lǐng)域具備極強(qiáng)的實(shí)用價(jià)值。

嵌入式領(lǐng)域是OpenClaw生態(tài)落地的核心突破口，既是實(shí)現(xiàn)硬件實(shí)時(shí)交互、落地邊緣智能的關(guān)鍵入口，也是整個(gè)生態(tài)中增長(zhǎng)潛力最大、優(yōu)質(zhì)能力供給最緊缺的賽道。只有持續(xù)打造豐富、易用、高可靠的嵌入式Skills能力池，OpenClaw才能突破桌面工具的定位局限，真正成長(zhǎng)為覆蓋“云-邊-端”全鏈路的完整智能執(zhí)行框架。