先確認 App 還是 CLI
| 方式 | 適合對象 | 要確認什麼 |
|---|---|---|
| macOS App | 希望從選單列操作、處理權限提示與本機 Gateway | 下載版本是否提供 DMG／ZIP，以及 macOS 相容性 |
| CLI／Gateway | 需要終端機、背景服務、開發工具或進階整合 | Node 版本、PATH、LaunchAgent 與日誌位置 |
| 連接遠端 Gateway | Mac 只作為操作端，主要服務跑在另一台主機 | Gateway 位址、登入方式、網路與權限邊界 |
MacBook 與 Mac mini 的差異
- MacBook：闔上螢幕、切換網路或休眠後，背景流程可能中斷，適合有人使用時啟動。
- Mac mini：適合固定連線，但要明確設定誰維護、何時更新、停電或重開機後如何恢復。
- 共通事項：確認 macOS 版本、Apple Silicon 或 Intel 架構、可用空間、管理權限與備份。
安裝前檢查清單
- 確認 macOS 版本符合 OpenClaw App 與 Node 執行環境要求。
- 從官方 Releases 下載實際存在的 DMG 或 ZIP；若最新版本沒有 macOS 資產，依官方說明選擇可用版本。
- 決定 Gateway 跑在這台 Mac，還是連接既有遠端 Gateway。
- 列出需要的 macOS 權限，例如通知或特定本機工具存取，逐項由使用者核准。
- 準備模型與通訊平台帳號，但不要把密鑰放進公開文件或聊天紀錄。
安裝後的四項驗收
先測啟動，再測 Dashboard，接著測一個實際任務，最後測重新登入或重新開機後能否恢復。若作為常駐主機，還應記錄網路中斷、休眠與更新失敗時的處理方式。
官方資料請以 OpenClaw macOS App 文件、安裝總覽為準。也可先看 AI 助理遠端安裝檢查清單，或了解 個人 AI 助理安裝服務。
常見問題
OpenClaw 適合裝在 MacBook 還是 Mac mini？
兩者都可使用。MacBook 適合個人隨身操作；Mac mini 較適合固定放置與長時間運行，但仍要處理登入、休眠、網路、更新與遠端維護。
Mac 可以只裝 OpenClaw App，不裝 CLI 嗎？
依使用情境而定。官方 macOS App 可連接或建立本機 Gateway；需要終端機操作、背景服務或開發工具時，仍可能需要 CLI 與受支援的 Node 環境。
遠端安裝需要把 Mac 密碼交給服務方嗎？
不應透過聊天傳送密碼或 API Key。涉及系統、模型或通訊平台的敏感憑證，應由使用者在自己的裝置上輸入並保管。