Skills

• 省略 agents.defaults.skills，即可讓所有 Skills 預設不受限制。
• 省略 agents.list[].skills，即可繼承 agents.defaults.skills。
• 將 agents.list[].skills 設為 []，即可不向該代理程式公開任何 Skills。
• 非空白的 agents.list[].skills 清單就是最終集合，不會 與預設值合併。
• 有效的允許清單會套用於提示詞建構、斜線命令 探索、沙箱同步和 Skill 快照。
• 這不是主機殼層的授權邊界。如果同一代理程式可以 使用 exec，請另行透過沙箱、作業系統使用者 隔離、exec 拒絕／允許清單以及各資源憑證來限制該殼層。

openclaw skills install 預設會安裝到作用中工作區的 skills/ 目錄。加入 --global 則會安裝到共用的 ~/.openclaw/skills 目錄；除非代理程式允許清單縮小可見範圍，否則所有本機代理程式都可看見。

Git 和本機安裝要求來源根目錄中有 SKILL.md。若 SKILL.md 前置資料中的 name 有效，短名會取自該欄位，否則會回退到 目錄或儲存庫名稱。使用 --as <slug> 可覆寫。 openclaw skills update 僅追蹤 ClawHub 安裝項目；若要重新整理 Git 或 本機來源，請重新安裝。

openclaw skills verify @owner/<slug> 會向 ClawHub 查詢該 Skill 的 clawhub.skill.verify.v1 信任封套。已安裝的 ClawHub Skills 會根據 .clawhub/origin.json 中記錄的版本和登錄庫進行驗證。 對於既有已安裝或沒有歧義的 Skills，仍接受未限定擁有者的短名，但 具擁有者限定的參照可避免發布者歧義。

ClawHub Skill 頁面會在安裝前顯示最新的安全掃描狀態， 並提供 VirusTotal、ClawScan 和靜態分析的詳細資訊頁面。當 ClawHub 將驗證標記為失敗時，命令會以非零狀態結束。發布者可透過 ClawHub 儀表板或 clawhub skill rescan @owner/<slug> 處理誤判。

需要非 ClawHub 傳遞方式的閘道用戶端，可以使用 skills.upload.begin、skills.upload.chunk 和 skills.upload.commit 暫存 zip Skill 封存檔，然後使用 skills.install({ source: "upload", ... }) 安裝。此路徑預設為關閉，且必須在 openclaw.json 中設定 skills.install.allowUploadedArchives: true。一般 ClawHub 安裝不需要該設定。

工作區、專案代理程式和額外目錄的 Skill 探索，只接受解析後實際路徑 保持在已設定根目錄內的 Skill 根目錄，除非 skills.load.allowSymlinkTargets 明確信任目標根目錄。 僅在啟用 skills.workshop.allowSymlinkTargetWrites 時， Skill 工作坊才能透過這些受信任的目標寫入。 受管理的 ~/.openclaw/skills 和個人的 ~/.agents/skills 可以包含 符號連結 Skill 資料夾，但每個 SKILL.md 的實際路徑仍必須 位於其解析後的 Skill 目錄內。

設定 security.installPolicy，在繼續安裝 Skill 前執行受信任的本機原則命令。 該原則會接收中繼資料和暫存來源路徑，並套用於 ClawHub、上傳、Git、本機、更新及 相依項目安裝程式路徑；若命令無法傳回有效決策，則採取封閉式失敗。

skills.entries.*.env 和 skills.entries.*.apiKey 僅會將密鑰注入該次代理程式回合的 主機程序，而不會注入沙箱。請勿在提示詞和日誌中包含密鑰。

• 列出多個安裝程式時，閘道會選擇一個偏好的 選項（可用時選 brew，否則選 node）。
• 如果所有安裝程式都是 download，OpenClaw 會列出每個項目，讓你可以 查看所有可用的成品。
• 規格可以包含 os: ["darwin"|"linux"|"win32"]，以依平台篩選。
• Node 安裝會遵循 openclaw.json 中的 skills.install.nodeManager （預設：npm；選項：npm / pnpm / yarn / bun）。這只會影響 skill 安裝；閘道執行階段仍應使用 Node。
• 閘道安裝程式偏好順序：Homebrew → uv → 已設定的 node 管理器 → go → download。

• Homebrew： OpenClaw 不會自動安裝 Homebrew，也不會將 brew formula 轉換為系統套件命令。在沒有 brew 的 Linux 容器中，只提供 brew 的安裝程式會被隱藏；請使用自訂映像檔或手動安裝 相依項目。
• Go： OpenClaw 的自動 skill 安裝需要 Go 1.21 或更新版本。 如果缺少 go 且 Homebrew 可用，OpenClaw 會先透過 Homebrew 安裝 Go；在沒有 Homebrew 的 Linux 上，如果重新整理後的 golang-go 候選版本符合最低版本要求，則可改用 root 權限或免密碼 sudo 執行 apt-get。相依項目實際使用的 go install 一律以 OpenClaw 管理的專用二進位檔目錄為目標 （全新安裝時使用 Homebrew 的 bin，否則使用 ~/.local/bin），而非 你設定的 GOBIN——系統會讀取你自己的 GOBIN、GOPATH 和 GOTOOLCHAIN 環境變數，但絕不覆寫它們。
• 下載： url（必要）、archive（tar.gz | tar.bz2 | zip）、 extract（預設：偵測到封存檔時自動啟用）、stripComponents、 targetDir（預設：~/.openclaw/tools/<skillKey>）。

requires.bins 會在載入 skill 時於主機上檢查。如果代理程式 在沙箱中執行，該二進位檔也必須存在於容器內部。 請透過 agents.defaults.sandbox.docker.setupCommand 或自訂 映像檔安裝。setupCommand 會在容器建立後執行一次，且要求 能夠連出網路、可寫入的根檔案系統，以及沙箱中的 root 使用者。

OpenClaw 預設會監看 skill 資料夾，並在 SKILL.md 檔案變更時更新快照。請在 skills.load 下設定：

{  skills: {    load: {      extraDirs: ["~/Projects/agent-scripts/skills"],      allowSymlinkTargets: ["~/Projects/manager/skills"],      watch: true, // default      watchDebounceMs: 250, // default    },  },}

對於刻意使用符號連結的配置，如果 skill 根目錄符號連結指向已設定根目錄之外，請使用 allowSymlinkTargets，例如 <workspace>/skills/manager -> ~/Projects/manager/skills。 只有當 Skill Workshop 也應透過這些受信任的符號連結路徑 套用提案時，才啟用 skills.workshop.allowSymlinkTargetWrites。

如果閘道在 Linux 上執行，但已連線允許 system.run 的 macOS 節點，且該節點具備必要的二進位檔，OpenClaw 可將僅限 macOS 的 skills 視為符合資格。代理程式應透過 exec 工具並設定 host=node 來執行這些 skills。

離線節點不會讓僅限遠端的 skills 顯示。如果節點停止 回應二進位檔探測，OpenClaw 會清除其快取的二進位檔比對結果。