Skills
Skill 是教助理「這件事何時做、怎麼做」的 Markdown 說明,不是把模型權重換掉。每個 skill 是一個目錄,裡面至少有 SKILL.md(YAML front matter + 正文)。OpenClaw 會載入內建 skill、你 workspace 裡的覆寫,以及從 ClawHub 裝來的套件。官方說明:Skills。
- 本頁:格式、載入順序、怎麼自己寫一個
- ClawHub:搜尋、安裝、發布與掃描
最小的 SKILL.md
---
name: image-lab
description: Generate or edit images via a provider-backed image workflow
---
When the user asks to generate an image, use the `image_generate` tool...
name 與 description 是最低需求。user-invocable: true 時會變成使用者可叫的 slash 指令(Telegram 特別好用)。正文裡可用 {baseDir} 指到 skill 目錄。規格對齊 Agent Skills。
把檔案放在 <workspace>/skills/<名稱>/SKILL.md 優先級最高,且只對該 agent 可見。改完 SKILL.md 後,預設會在下一輪對話刷新快照。
載入優先順序(高到低)
- Workspace:
<workspace>/skills - 專案 agent:
<workspace>/.agents/skills - 個人:
~/.agents/skills - 託管/本機:
~/.openclaw/skills(路徑隨 state dir 而變) - 內建與外掛提供的 skill
同名時高優先者勝出。Allowlist(agents.defaults.skills)是「模型看不看得到」的過濾,不是 shell 的授權邊界:agent 若能 exec,仍可能讀到主機上的檔案。要把執行真的關進籠子,靠 sandbox 與 安全 的工具政策。
在對話裡呼叫
Control UI 輸入 $ 可搜尋並插入 $skill-name。頻道上 /skill-name 仍是獨立指令。明確引用最多約 8 個不同 skill;被 allowlist 藏起來的名稱會報錯而不是默默忽略。
下一步:到 ClawHub 裝社群 skill,或先看 安全 再裝來路不明的套件。畫面跟做 SKILL.md、ClawHub 與 sandbox,見 freeCodeCamp 完整課。