1. 為什麼在 Mac 上部署 OpenClaw 值得單獨說
OpenClaw 支援多平台，但 Mac（尤其 Apple Silicon）在環境路徑、Homebrew 與 npm 全域目錄、Gatekeeper 與權限、以及後台常駐方式上與 Linux/Windows 不同。不少人在本機或遠端 Mac 上安裝時卡在「命令找不到」、EACCES 權限或埠被佔，本文按 Mac 專屬路徑給出可複現的完整步驟與排查表。
2. Mac 環境準備（Xcode CLI、Homebrew、Node）
第一步： 安裝 Xcode Command Line Tools。終端執行 xcode-select --install，依提示完成。
第二步： 安裝 Homebrew。執行官方一鍵腳本。若為 Apple Silicon，安裝後必須把 Homebrew 加入 PATH：echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile，再 source ~/.zprofile。
第三步： 安裝 Node.js 22+。推薦用 nvm：brew install nvm，依提示設定 shell，然後 nvm install 22、nvm use 22。或直接 brew install node@22 並 brew link node@22 --force。用 node -v 與 npm -v 確認。
3. 安裝方式對比與推薦
| 方式 | 指令/說明 | 適用場景 |
|---|---|---|
| npm 全域 | npm install -g openclaw@latest | 已有 Node 環境，快速體驗 |
| 官方安裝腳本 | curl -fsSL https://openclaw.ai/install.sh | bash | 一鍵完成依賴與 PATH |
| Docker | 使用官方或社群 OpenClaw 映像 | 隔離環境 |
4. 五步安裝與首次運行
第一步： 選擇安裝方式並執行。若遇 EACCES: permission denied，可執行 sudo chown -R $(whoami) $(npm config get prefix)/{lib/node_modules,bin,share} 修復 npm 全域目錄權限。
第二步： 確認命令可用。新開終端執行 openclaw --version。若提示「命令未找到」，檢查 PATH 是否包含 npm 的 global bin 目錄。
第三步： 依官方文件執行初始化並設定 API Key。若使用 Web 控制台，預設埠常為 18789 或 3000，確保防火牆或安全群組已放行。
第四步： 啟動閘道/服務。在瀏覽器存取對應埠驗證控制台是否正常。
第五步： 做一次最小化驗證，確認端到端可用後再設定開機自啟或後台保活。
5. Apple Silicon 特別注意
（1）Homebrew 路徑：Apple Silicon 上 Homebrew 安裝在 /opt/homebrew，需將 /opt/homebrew/bin 加入 PATH。（2）Rosetta 2：部分 npm 原生模組可能提示安裝 Rosetta，依系統提示安裝即可。（3）Gatekeeper：若從非 App Store 安裝的二進位被攔截，在「系統設定 → 隱私權與安全性」中選擇「仍要開啟」。
6. Mac 常見問題排查表
| 現象 | 可能原因 | 建議操作 |
|---|---|---|
| 命令未找到（openclaw / node） | PATH 未含 Homebrew 或 npm global bin | 在 ~/.zprofile 或 ~/.bash_profile 中加入對應路徑並 source |
| EACCES 權限錯誤 | npm 全域目錄屬主不是當前使用者 | chown -R $(whoami) $(npm config get prefix)/{lib/node_modules,bin,share} |
| 埠已被佔用 | 預設埠被其它進程佔用 | 修改設定換埠或 lsof 查佔用進程後關閉 |
| 控制台無法存取 | 防火牆或安全群組未放行 | macOS 防火牆允許該應用；若為遠端 Mac，放行 18789/3000 等埠 |
| 關蓋或鎖定後進程退出 | 預設未做後台保活 | 使用 LaunchAgent 或 nohup/screen 保持常駐；或部署到遠端 Mac 24/7 運行 |
7. 小結與延伸：在遠端 Mac 上 24/7 運行 OpenClaw
在本地 Mac 上安裝並跑通 OpenClaw 後，若需要 24/7 在線、不佔本機資源或避免關蓋/休眠導致中斷，可將 OpenClaw 部署到遠端 Mac 節點。遠端 Mac 同樣為 macOS，環境與本文步驟一致，且可專機專用、穩定常駐。若你希望省去本機保活與維運負擔，可直接租賃 MACGPU 的遠端 Mac 節點，在標準化 macOS 下依本文步驟安裝 OpenClaw，一次配置、長期穩定運行。