Skip to content

建立 2026-09-15 更新 2026-09-15

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...

namedescription 是最低需求。user-invocable: true 時會變成使用者可叫的 slash 指令(Telegram 特別好用)。正文裡可用 {baseDir} 指到 skill 目錄。規格對齊 Agent Skills

把檔案放在 <workspace>/skills/<名稱>/SKILL.md 優先級最高,且只對該 agent 可見。改完 SKILL.md 後,預設會在下一輪對話刷新快照。

載入優先順序(高到低)

  1. Workspace:<workspace>/skills
  2. 專案 agent:<workspace>/.agents/skills
  3. 個人:~/.agents/skills
  4. 託管/本機:~/.openclaw/skills(路徑隨 state dir 而變)
  5. 內建與外掛提供的 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 完整課