OpenClaw macOS 技能管理指南：安裝與 API 設定教學

開發時最討厭的就是環境弄得亂七八糟，尤其是要在 macOS 上管理一堆工具的依賴。OpenClaw 透過 Gateway 集中管理 Skills，讓你的本地環境保持乾淨，不用再擔心各種套件衝突。

這篇文章會帶你了解 macOS App 如何透過 Gateway 來處理 Skills 的資料、安裝流程以及環境變數設定。

資料來源

macOS App 主要是透過 Gateway 呈現 OpenClaw 的 Skills，它本身不會在本地端解析這些內容。

• skills.status (Gateway) 會回傳所有的 Skills，還有你是否符合使用資格或缺少哪些需求（包括針對內建 Skills 的 allowlist 阻擋）。
• 具體的需求是根據每個 SKILL.md 裡的 metadata.openclaw.requires 定義的。

安裝操作

• metadata.openclaw.install 定義了安裝選項（像是 brew, Node.js, Go, uv）。
• App 會呼叫 skills.install 在 Gateway 主機上執行安裝程式。
• 為了安全，如果偵測到具備危險程式碼的 critical 結果，預設會阻擋 skills.install；如果是 suspicious 則只會警告。雖然 Gateway 請求支援強制覆蓋危險警告，但 App 的預設流程是採取「失敗即關閉」的安全策略。
• 當提供多個安裝程式時，Gateway 只會顯示一個偏好的選項（優先使用 brew，沒有的話則使用 skills.install 裡的 Node.js 管理器，預設是 npm）。

環境變數與 API Key

• App 會把 Key 存放在 ~/.openclaw/openclaw.json 的 skills.entries.<skillKey> 路徑下。
• 你可以透過 skills.update 來更新 enabled、apiKey 和 env 等設定。

遠端模式

• 所有的安裝和設定更新都是發生在 Gateway 主機上，而不是你本地的 Mac。這代表你可以在不同的裝置上共用同一套 Skills 設定，不需要重複配置。

想要快速完成設定嗎？可以試試我們的 AI Setup Assistant。

下一步

• 了解 Gateway 設定細節
• 如何編寫自己的 SKILL.md