如何在 Mac 上安裝 OpenClaw

OpenClaw 可用多種方式安裝在 Mac 上，取決於你的工作習慣與設定管理方式。本指南提供不同安裝方法的逐步說明，並附上實用提示，幫助你順利啟動 OpenClaw。

快速總覽：在 Mac 上安裝 OpenClaw 的三種方式

以下並列比較三種方法。它們的差異在於需要你手動處理的設定多寡。

Kimi Claw 讓你無須設定 Node.js、Homebrew 或 API keys，就能在雲端執行 OpenClaw。幾分鐘內，你就能在瀏覽器中開始使用可運作的 agent。

如果你偏好本機設定，請繼續閱讀下一節。若想採用更簡�的方式，請跳至使用 Kimi Claw 在 Mac 上執行 OpenClaw一節，或點擊下方按鈕立即開始。

開始之前：必要準備與安全事項

在 Mac 本機安裝 OpenClaw 之前，需要先完成幾項準備與安全設定。若你打算使用 Kimi Claw，可以略過本節，直接前往下方的設定說明。

• 相依項目：一行式安裝程式會在需要時自動安裝 Node.js。若選擇 Homebrew，則需手動安裝 Node.js（建議使用 Node 24；Node 22 LTS 22.16+ 也可使用）。

• 防火牆與網路設定： macOS 防火牆通常預設為關閉。你可以在「系統設定 > 網路 > 防火牆」中啟用。OpenClaw 會將 gateway 綁定到 127.0.0.1（localhost），因此同一網路中的其他裝置無法直接連線。如果需要行動裝置或遠端存取，可以使用 Tailscale 或 SSH tunnel 等工具。請不要透過路由器轉發連接埠 18789。

使用一行式 script 在 Mac 上安裝 OpenClaw

這是在 Mac 本機執行 OpenClaw 最快速的方式。OpenClaw 會從 Terminal 執行，並提供瀏覽器介面來管理你的 agent，而不是傳統圖形化 app。只要一行指令，就能安裝 CLI、檢查 Node.js 版本，並啟動 onboarding wizard。

步驟 1：在 Terminal 執行安裝 script

使用 Spotlight（⌘ + Space）開啟 Terminal，然後貼上以下指令：

script 會偵測你的系統、安裝 OpenClaw CLI，並檢查 Node.js 版本。若缺少 Node.js 或版本過舊，會自動安裝 Node 24（也支援 Node 22 LTS 22.16+）。

步驟 2：設定 API key 並配置 gateway

安裝完成後，onboarding wizard 會自動啟動。請選擇 Moonshot AI（Kimi K2.5）作為 LLM provider，並在提示時貼上你的 Kimi API key。gateway 連接埠與 authentication 可接受預設設定。若希望 OpenClaw 在 Mac 開機時自動啟動，請在 onboarding 過程中選擇 daemon 安裝選項。

步驟 3：確認 gateway 並開啟 dashboard

執行以下指令，確認 gateway 正在執行：

接著開啟 dashboard：

這個指令會在瀏覽器中開啟位於 http://127.0.0.1:18789 的 Control UI。輸入你的 gateway token 登入。登入後，就可以開始與你的 OpenClaw agent 互動。

使用 Homebrew 在 Mac 上安裝 OpenClaw

如果你偏好用 Homebrew 管理套件，也可以用較手動的方式在 Mac 上安裝 OpenClaw。這種方法讓你更能掌握相依項目，也能融入既有的 Homebrew 工作流程。

步驟 1：安裝 Homebrew

使用 Spotlight（⌘ + Space）開啟 Terminal。若尚未安裝 Homebrew，請執行以下指令。Homebrew 是 macOS 的套件管理工具，可讓你從 Terminal 安裝與管理開發工具，類似 app store 安裝 app 的方式。

安裝過程中，系統可能會要求你輸入 Mac 登入密碼。請注意，基於安全原因，Terminal 在你輸入時不會顯示任何字元。你也可能會看到確認安裝的提示，以及顯示正在安裝檔案的訊息。

安裝完成後，你會在 Terminal 中看到成功訊息與後續步驟。

步驟 2：安裝 Node.js

安裝 Homebrew 後，接著安裝 Node.js：

安裝完成後，請確認版本為 v24（建議）或 v22.16+。

步驟 3：安裝 OpenClaw CLI 並執行 onboarding

使用 npm 全域安裝 CLI，然後執行 onboarding：

如果在執行 npm install -g 時看到 EACCES 權限錯誤，表示你的 npm 全域目錄需要更高權限。你可以執行 sudo npm install -g openclaw@latest，或變更 npm 預設目錄，以後就不必使用 sudo。

--install-daemon 旗標會將 OpenClaw 註冊為 LaunchAgent，讓 gateway 在你登入時自動啟動。onboarding 過程中，請選擇 Moonshot AI（Kimi K2.5）作為 provider，並輸入你的 Kimi API key。

步驟 4：檢查 gateway 並開啟 dashboard

確認 gateway 正在執行，並開啟 dashboard：

Control UI 會在瀏覽器中開啟。輸入你的 gateway token，就可以開始使用。

使用 Kimi Claw 在 Mac 上執行 OpenClaw

Kimi Claw 是一款線上工具，可讓你無須本機設定，就能在雲端執行 OpenClaw。Mac 上不需要安裝任何東西，也不必使用 Terminal 或管理相依項目；一切都在瀏覽器中執行。你可以在幾分鐘內建立 OpenClaw agent。Kimi Claw 會處理 gateway、workspace、storage 與模型存取，因此即使 MacBook 闔上，你的 agent 也能 24/7 保持在線。

如何使用 Kimi Claw？

步驟 1：開啟 Kimi Claw

前往 Kimi Claw 頁面，點擊 Create 開始部署你的 OpenClaw 環境。

步驟 2：自動部署 OpenClaw

在彈出視窗中確認部署。接著 Kimi Claw 會設定 OpenClaw 環境，包括 gateway、workspace 和 tools。整個流程通常會在幾分鐘內完成。

步驟 3：開始使用 OpenClaw

部署完成後，你的 workspace 會在 dashboard 中開啟。你可以直接在瀏覽器中與 agent 對話、設定 skills、安排任務並管理檔案。

Kimi Claw 與本機執行 OpenClaw 的差異

Kimi Claw 提供更簡單的 OpenClaw 執行方式，無須本機設定。你不必安裝相依項目或管理本機環境，只要直接在瀏覽器中執行 agent；底層設定與基礎架構則由 Kimi Claw 處理。

• 無須本機設定： 不必安裝 Node.js，也不用使用 Terminal，就能執行 OpenClaw。所有功能都能直接在瀏覽器中運作，讓你更快開始，並避開環境設定問題。

• 即時存取 5,000+ skills：不必手動安裝 tools，Kimi Claw 可從龐大的可用 tools 資料庫中，自動使用任務所需的 skills，降低設定時間與相容性問題。

• 常駐自動化與排程：不同於 Mac 進入睡眠就停止的本機 agents，Kimi Claw 會在雲端 24/7 執行，適合排程任務與長時間工作流程。

• 40GB 雲端儲存與持久記憶：本機設定通常會��檔案綁定單一裝置；Kimi Claw 則內建 40GB 儲存空間，讓你的報告與研究可從任何瀏覽器存取。它也會跨 session 記住你的偏好與工作脈絡，方便你從上次中斷處繼續。

• 整合 Kimi K2.5 模型與專業級搜尋： Kimi Claw 內建 Kimi K2.5 存取能力與進階搜尋功能，因此你不必管理 API keys 或設定外部服務。它能自動引入金融、科技、新聞等領域的最新資訊，讓研究與任務執行更順暢。

讓 OpenClaw 在 Mac 上 24/7 持續執行

多數使用者會把 AI 當作傳統桌面 app：坐在桌前時使用，完成後就關閉。但對有價值的自動化來說，例如夜間監控全球市場，或在早上 8 點前把研究報告送到你的 inbox，agent 必須全天候保持運作。由於 macOS 會在系統睡眠時自然暫停本機程序，要做到這點就需要特定策略。本節介紹兩種維持持續連線的方法：

選項 A：專用 Mac 硬體

其中一種方式是讓一台 Mac（例如 Mac mini）持續運轉。你可以使用 sudo pmset -a sleep 0 停用睡眠，並在「系統設定」中啟用「喚醒以供網路存取」。若需要遠端存取，可以使用 Tailscale 或 SSH tunnel 等工具。

這種設定能讓 OpenClaw 在你自己的硬體上持續執行，但你必須讓機器保持開機，並自行處理維護、更新與重新啟動。

選項 B：由 Kimi Claw 自動處理

如果用 Kimi Claw 執行 agent，24/7 可用性已經內建。你的 agent 會獨立於本機裝置執行，因此即使 Mac 闔上或離線，也會繼續工作。你不需要調整睡眠設定，也不用讓某台機器一直開著。

修正常見的 Mac 版 OpenClaw 安裝錯誤

即使設定流程很簡單，安裝時仍可能遇到問題。以下整理常見問題與修正方式。

OpenClaw command not found 錯誤

• 原因： npm 全域 bin 目錄不在你的 shell PATH 中。

• 修正： 執行 source ~/.zshrc 重新載入 shell 設定。若你使用 Bash 而不是 Zsh，請將 ~/.zshrc 換成 ~/.bash_profile。如果錯誤仍持續，請找出 npm prefix 並加入 PATH：

重新開機後 OpenClaw 未啟動

• 原因： onboarding 時未安裝 LaunchAgent。

• 修正： 使用 daemon 旗標執行 onboarding 指令：

這會註冊一個 LaunchAgent，讓 OpenClaw gateway 在你登入時自動啟動。若要確認它是否啟用：

連接埠 18789 已被使用

• 原因： 另一個 process 正在占用 gateway 連接埠。

• 修正： 找出並停止衝突的 process：

skill 安裝期間發生 Xcode Command Line Tools 錯誤

• 原因： 部分 npm packages 需要 native compilation，但 Xcode Command Line Tools 缺少或版本過舊。

• 修正： 安裝或更新 tools：

安裝完成後，重新嘗試安裝該 skill。

Node.js 版本過舊

• 原因： 你的 Mac 已安裝的 Node.js 版本低於 22.16。OpenClaw 需要 Node 24（建議）或 Node 22 LTS 22.16+。

• 修正： 如果你使用 Homebrew：

如果你使用一行式安裝程式，請重新執行。script 會偵測過舊版本並進行更新。

結語

OpenClaw 可以透過一行式安裝程式或 Homebrew 在你的 Mac 本機執行，也可以透過 Kimi Claw 在瀏覽器中執行，無須本機設定。每種方式都能讓 agent 順利運作，只是需要的手動操作程度不同。若你想要更快速完成設定，並內建 24/7 可用性，可以從 Kimi Claw 開始，幾分鐘內就讓你的 agent 開始運行。