本文面向在本地 Mac或MacCloud 獨享實體執行個體上落地 OpenClaw 的工程師。依「能跑起來 → 能長期跑 → 能與雲端對齊」順序撰寫；實際命令與版本請以 OpenClaw 發行說明為準，此處提供貼合 macOS 生態的基線。
一、寫給誰、目標是什麼
若你需要命令列工具常駐、偶爾又要圖形介面排錯，macOS 仍是最順的宿主。目標不是逐條複製官方文件，而是一次把路徑、權限、守護行程搞定，避免「本機 OK、一上 SSH 就掛」的反覆。
二、環境準備與架構
建議使用目前穩定版 macOS，並安裝 Xcode Command Line Tools（終端執行 xcode-select --install）。在 Apple Silicon 上確認二進位為 arm64，或與團隊 Rosetta 策略一致；混用架構常表現為偶發崩潰或動態庫載入失敗。
三、安裝 CLI 與 PATH
將可執行檔或套件管理器安裝路徑寫入 ~/.zshrc 或 ~/.bash_profile，並在當前工作階段 source 驗證。盡量避免把第三方工具塞進需提權的全域目錄——在獨享實體機上可以，但要自行承擔升級與稽核成本。
四、隱私、自動化與無頭情境
若 OpenClaw 需控制其他 App 或掃碟，請在系統設定 → 隱私權與安全性依需求開啟「完整磁碟取用」「自動化」等。純 SSH 無頭情境建議以 launchd 管理常駐行程：寫清 WorkingDirectory、標準輸出日誌路徑，以及合理的 ThrottleInterval，避免異常重啟打滿 CPU。
五、與 MacCloud 雲端執行個體聯調
在雲上重複上述步驟時，請透過控制台確認網路與安全群組策略；不要把私鑰寫進版本庫，用跳板或短期憑證。更完整的雲上實踐見同系列《在 MacCloud 雲上執行 OpenClaw 的實踐》。
六、上線前自檢清單
- 本機與雲端是否為同一 macOS／晶片架構 組合？
which openclaw（或等價命令）在登入 shell 與非互動 SSH 下是否一致？- launchd／手動啟動是否都能優雅結束，日誌裡有無循環重啟？
- 隱私權限是否在首次提示就按最小集合授予，避免後續無人值守卡在對話框？
安裝只是第一步；把 OpenClaw 接進流水線或排程時，請同步讀GitHub Actions 整合與自動化編排兩篇，把觸發、金鑰與可觀測性一次對齊。
