前言

很多人第一次聽到 OpenClaw Skill，會(huì)把它理解成“插件”。

這個(gè)理解只對(duì)了一半。

插件通常給 Agent 增加新的能力，比如新的工具、新的消息渠道、新的模型 Provider。

Skill 更像是給 Agent 一份“操作手冊(cè)”。

它不一定創(chuàng)造新工具，但會(huì)告訴 Agent：

遇到某類任務(wù)時(shí)，應(yīng)該按什么步驟做；
需要先檢查什么；
應(yīng)該調(diào)用哪些工具；
哪些坑不能踩；
結(jié)果應(yīng)該怎么交付。

所以 Skill 的核心不是“多一個(gè)按鈕”，而是“把一套可復(fù)用工作方法交給 Agent”。

這一篇我們講清楚：OpenClaw Skill 是什么、怎么被加載、怎么觸發(fā)、怎么使用，以及新手最容易誤解的地方。

先說結(jié)論：Skill 是方法，不是魔法

OpenClaw 使用兼容 AgentSkills 的 skill 文件夾。

一個(gè) Skill 通常是一個(gè)目錄，里面最核心的文件是：

SKILL.md

SKILL.md 里會(huì)有 YAML frontmatter，寫明技能名稱、描述、要求、環(huán)境條件等信息，正文部分寫具體操作流程。

OpenClaw 不會(huì)把每個(gè) Skill 的全文都塞進(jìn)系統(tǒng)提示詞。

更準(zhǔn)確的流程是：

OpenClaw 掃描可用 Skill
  ↓
把 Skill 的名稱、描述、路徑放進(jìn)系統(tǒng)提示詞
  ↓
模型看到“有哪些 Skill 可用”
  ↓
當(dāng)任務(wù)匹配某個(gè) Skill 時(shí)
  ↓
模型讀取該 Skill 的 SKILL.md
  ↓
按里面的步驟執(zhí)行

這就是 Skill 的真正位置。

它不是每次都完整進(jìn)入上下文。

它是“按需加載”的操作說明。

這樣設(shè)計(jì)有一個(gè)很現(xiàn)實(shí)的好處：不浪費(fèi)上下文窗口。

如果你裝了 30 個(gè) Skill，每個(gè)幾千字，全部塞進(jìn) Prompt，模型還沒開始做任務(wù)，上下文就已經(jīng)被擠爆了。

OpenClaw 只把 Skill 列表放進(jìn)去，讓模型需要時(shí)再讀詳細(xì)說明。

Skill 和工具有什么區(qū)別

新手最容易混淆這兩個(gè)詞。

工具是 Agent 可以調(diào)用的能力。

Skill 是 Agent 使用這些能力的方法。

比如：

• Browser 工具 = 打開網(wǎng)頁、截圖、點(diǎn)擊、讀取頁面
• browser-automation Skill = 遇到網(wǎng)頁自動(dòng)化任務(wù)時(shí)，如何規(guī)劃步驟、如何確認(rèn)頁面狀態(tài)、如何避免誤點(diǎn)

再比如：

• exec 工具 = 運(yùn)行命令
• deploy Skill = 部署前檢查環(huán)境、備份配置、執(zhí)行部署、驗(yàn)證服務(wù)、寫回報(bào)告

工具回答的是：

能做什么？

Skill 回答的是：

應(yīng)該怎么做？

真正穩(wěn)定的 Agent，不能只靠工具。

因?yàn)楣ぞ咴蕉啵Ｐ驮饺菀讈y選。

Skill 的價(jià)值，就是把“某類任務(wù)的正確操作路徑”固定下來。

OpenClaw 從哪里加載 Skill

OpenClaw 會(huì)從多個(gè)位置加載 Skill，而且有優(yōu)先級(jí)。

從高到低大致是：

• <workspace>/skills
• <workspace>/.agents/skills
• ~/.agents/skills
• ~/.openclaw/skills
• 安裝包自帶的 bundled skills
• 配置里的 skills.load.extraDirs

如果同名 Skill 在多個(gè)位置都存在，優(yōu)先級(jí)高的位置會(huì)覆蓋低的位置。

這個(gè)設(shè)計(jì)很重要。

因?yàn)樗试S你做三件事：

項(xiàng)目級(jí)定制：某個(gè) workspace 有自己的專用 Skill
個(gè)人級(jí)復(fù)用：你自己的機(jī)器上有一套通用 Skill
系統(tǒng)級(jí)兜底：OpenClaw 自帶一些默認(rèn)能力說明

比如你做一個(gè)“SEO 工廠”項(xiàng)目，可以在當(dāng)前 workspace 的 skills/ 里放一個(gè) seo-content-pipeline。

這樣這個(gè)項(xiàng)目的 Agent 會(huì)優(yōu)先使用項(xiàng)目里的 SEO 工作流，而不會(huì)誤用別處同名 Skill。

如何查看當(dāng)前有哪些 Skill

最常用的是 CLI：

openclaw skills list
openclaw skills list --eligible
openclaw skills list --verbose
openclaw skills info <name>
openclaw skills check

你可以這樣理解：

• list       = 當(dāng)前能掃描到哪些 Skill
• eligible   = 當(dāng)前 Agent 真正符合條件、能出現(xiàn)在提示詞里的 Skill
• info       = 看某個(gè) Skill 的詳細(xì)信息
• check      = 檢查 Skill 是否可見、格式是否正常
• verbose    = 看更多路徑、來源和過濾原因

這里有一個(gè)細(xì)節(jié)：

“文件存在”不等于“Agent 能用”。

一個(gè) Skill 可能因?yàn)榄h(huán)境變量缺失、二進(jìn)制不存在、插件未啟用、allowlist 限制、當(dāng)前 agent 不匹配而不可用。

所以排查 Skill 時(shí)，不要只看文件夾。

要看 eligible。

如何安裝 Skill

OpenClaw 支持幾種安裝方式：

openclaw skills search "calendar"
openclaw skills install <slug>
openclaw skills install <slug> --version <version>
openclaw skills install git:owner/repo
openclaw skills install git:owner/repo@main
openclaw skills install ./path/to/skill --as custom-name
openclaw skills install <slug> --global
openclaw skills update <slug>
openclaw skills update --all

默認(rèn)情況下，install 和 update 會(huì)面向當(dāng)前 Agent 的 workspace skills/ 目錄。

如果加 --global，則安裝到共享 managed skills 目錄。

如果加 --agent <id>，則安裝到指定 Agent 的 workspace。

最安全的新手路徑是：

先 search
再 info
再 install 到當(dāng)前 workspace
最后 check

不要一上來就全局安裝一堆 Skill。

Skill 是會(huì)影響 Agent 行為的。

裝得越多，不代表越聰明；有時(shí)反而會(huì)讓模型更難判斷該按哪套方法做。

Skill 是怎么被觸發(fā)的

Skill 不是傳統(tǒng)軟件里的“手動(dòng)點(diǎn)擊執(zhí)行”。

OpenClaw 會(huì)在系統(tǒng)提示詞里列出可用 Skill 的名稱、描述和路徑。

模型根據(jù)用戶任務(wù)判斷：

這個(gè)任務(wù)是否匹配某個(gè) Skill？
如果匹配，需要讀取哪個(gè) SKILL.md？
讀完之后要按哪些步驟調(diào)用工具？

比如你說：

幫我把這個(gè)網(wǎng)頁后臺(tái)的商品價(jià)格檢查一遍，截圖并輸出報(bào)告。

如果當(dāng)前環(huán)境有 browser automation 相關(guān) Skill，模型可能會(huì)先讀取該 Skill，再開始規(guī)劃：

1. 打開目標(biāo)頁面
2. 獲取頁面快照
3. 識(shí)別表格或商品卡片
4. 執(zhí)行點(diǎn)擊或分頁
5. 截圖保存
6. 生成報(bào)告

你也可以顯式點(diǎn)名：

使用 browser-automation skill 完成這個(gè)任務(wù)。

但更好的 Skill 應(yīng)該是：即使你不點(diǎn)名，模型也能從描述中判斷什么時(shí)候該用。

一個(gè)最小 Skill 長(zhǎng)什么樣

一個(gè)很小的 Skill 可以像這樣：

---
name: seo-report
description: Generate a structured SEO analysis report from a webpage or keyword list.
---
# SEO Report Skill
Use this skill when the user asks for SEO analysis, content gap analysis, keyword planning, or page optimization advice.
## Workflow
1. Confirm the target page or keyword.
2. Fetch or inspect the content.
3. Extract title, headings, links, metadata, and visible content.
4. Identify SEO risks and opportunities.
5. Produce a report with prioritized recommendations.
## Output
Return:
- Summary
- Issues
- Recommendations
- Next actions

它沒有創(chuàng)建任何新工具。

但它讓 Agent 知道：遇到 SEO 報(bào)告任務(wù)時(shí)，不要隨便寫一段建議，而要按固定結(jié)構(gòu)完成。

這就是 Skill 的力量。

使用 Skill 的正確姿勢(shì)

我建議你按下面順序使用：

第一步：先明確任務(wù)類型
第二步：查看是否已有合適 Skill
第三步：安裝到當(dāng)前 workspace
第四步：用 check 確認(rèn)可見
第五步：讓 Agent 執(zhí)行一個(gè)小任務(wù)
第六步：觀察它是否真的讀取 SKILL.md
第七步：根據(jù)失敗點(diǎn)修改 Skill
第八步：再用于更復(fù)雜任務(wù)

不要一開始就寫一個(gè)超級(jí) Skill。

新手最常犯的錯(cuò)是把 Skill 寫成一本百科全書。

Skill 應(yīng)該像“操作規(guī)程”，不是像“產(chǎn)品說明書”。

一個(gè)好 Skill 通常滿足：

• 觸發(fā)條件清晰
• 步驟短而具體
• 工具選擇明確
• 輸出格式固定
• 有常見失敗處理
• 不塞太多無關(guān)背景

常見誤解

誤解一：裝了 Skill，Agent 一定會(huì)用

不一定。

它必須被加載、符合條件、出現(xiàn)在可用 Skill 列表里，并且模型判斷任務(wù)匹配。

所以排查時(shí)要看 openclaw skills list --eligible 和 openclaw skills check。

誤解二：Skill 越多越好

不是。

Skill 列表本身也會(huì)占上下文。

更重要的是，描述太相似的 Skill 會(huì)增加模型選擇成本。

寧愿少而準(zhǔn)，不要多而亂。

誤解三：Skill 可以代替權(quán)限控制

不能。

Skill 是行為指導(dǎo)，不是硬限制。

真正的安全邊界仍然要靠 tool policy、審批、沙箱、allowlist、channel 限制。

誤解四：Skill 必須很復(fù)雜才有價(jià)值

錯(cuò)。

很多高價(jià)值 Skill 只有幾十行。

它把“我希望 Agent 每次都這樣做”的經(jīng)驗(yàn)固化下來，就已經(jīng)很有價(jià)值。

總結(jié)

OpenClaw Skill 是讓 Agent 學(xué)會(huì)“怎么做事”的機(jī)制。

工具提供能力，Skill 提供方法。

OpenClaw 不會(huì)把所有 Skill 全文都塞進(jìn) Prompt，而是把名稱、描述和路徑放進(jìn)去，模型需要時(shí)再讀取 SKILL.md。

使用 Skill 時(shí)，最重要的不是裝得多，而是讓每個(gè) Skill 都有清晰觸發(fā)條件、穩(wěn)定流程和明確輸出。

如果你想把 OpenClaw 從“能調(diào)用工具”推進(jìn)到“穩(wěn)定完成某類任務(wù)”，Skill 是必學(xué)的一層。

本節(jié)作業(yè)

1. 運(yùn)行 openclaw skills list 和 openclaw skills list --eligible，比較兩者差別。
2. 找一個(gè)你常做的任務(wù)，寫出它適合變成 Skill 的 5 個(gè)步驟。
3. 設(shè)計(jì)一個(gè)最小 SKILL.md，只包含 name、description、workflow、output。
4. 思考一個(gè)安全問題：這個(gè) Skill 會(huì)不會(huì)引導(dǎo) Agent 調(diào)用危險(xiǎn)工具？應(yīng)該用什么策略限制？
5. 讓 Agent 執(zhí)行一個(gè)小任務(wù)，觀察它是否會(huì)按 Skill 的流程輸出。

到此這篇關(guān)于一文教你如何輕松使用OpenClaw Skill的文章就介紹到這了,更多相關(guān)OpenClaw Skill使用內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持腳本之家！

最新評(píng)論