為什麼「安裝路徑」會決定你能否連上 Gateway
CLI、守護行程與 Gateway 共用設定目錄與環境變數。NPM 全域安裝把二進位檔放在 node_modules/.bin，設定多在使用者主目錄；Docker 把路徑鎖在容器內，卷掛載錯了則宿主機改的 config.yaml 進不去；curl 腳本若以 root 執行，可能與登入使用者權限分裂，launchd 讀不到權杖。工作目錄相關環境變數若在不同 shell profile 裡不一致，也會出現「終端機能跑、服務起不來」。先確認行程在讀哪條路徑。部署全貌可參考 了解更多：《2026年 OpenClaw 部署實戰：如何打造穩定運行的 AI 數位員工？》。
NPM、Docker 與 curl：三種裝法的典型差異
| 維度 | NPM 全域 | Docker | curl 腳本 |
|---|---|---|---|
| 升級方式 | npm update -g，隨 Node 變 |
新映像 + 卷遷移 | 重跑腳本，防覆寫設定 |
| 網路出口 | 同宿主 | bridge，須對映埠號 | 同宿主 |
| 權限模型 | 使用者／全域 | 常 root | 易 root／使用者混用 |
| 適合情境 | 本機開發 | 生產隔離 | 裸機首裝 |
Gateway 排錯：先監聽位址，再憑證
常見三類：連線被拒（未啟動或只綁 127.0.0.1）、TLS 失敗（反代協定／憑證網域不一致）、WebSocket 中斷（CDN 未開升級）。先本機 curl -v 直連埠號，再走網域 HTTPS；兩者結果不一致時，問題多半在網路層而非應用程式。遠端 Mac 上跑 Gateway 時，注意隧道別把回環指錯。
遠端 Mac：誰在跑 Gateway
執行端放遠端 Mac 可取一致執行環境與穩定供電，但要付 RTT。Gateway 在本機、worker 在遠端會分裂日誌；宜定一側為唯一入口。節點與成本見 了解更多：短期專案買 Mac 還是租遠端主機的決策矩陣。
記憶體與統一記憶體
- 並發：預留高於各任務峰值之和約 1.3–1.5 倍，防 swap 拖慢 Gateway。
- 同機疊加：本機模型或 Xcode 與 OpenClaw 搶統一記憶體時，須設資源上限。
- 無人值守：避免長期頂滿記憶體致 OOM；自動拉起後日誌落後更難查。
最小排錯順序
行程 → 監聽與埠號 → 設定路徑一致 → 反代／TLS → 防火牆。混用 NPM 開發機與 Docker 生產時，文件寫清預設路徑與團隊覆寫路徑，比多裝除錯器更省事。
維運成本簡表
| 成本項 | NPM | Docker | curl |
|---|---|---|---|
| 版本鎖定 | 隨 Node 漂移 | tag 可鎖死 | 看腳本維護 |
| 備份 | 自建 | 卷＋映像 | 常混系統備份 |
| 復現問題 | 難 | 易 | 中 |
常見問題
ps aux 找二進位檔再反推設定。在 Mac mini 上跑 OpenClaw：路徑更乾淨、長期更省心
Apple Silicon 統一記憶體減少 Gateway 與工具鏈搶頻寬的卡頓；M 系列待機功耗低，適合 7×24 入口或執行節點；Gatekeeper、SIP、FileVault 降低無人值守風險。Homebrew 與 Docker 同使用者態，排錯不必跨 WSL。要把部署落在穩定硬體上，Mac mini M4 是兼顧性價比與靜音的務實起點。
若你正準備把 Gateway 與執行端收束到可備份、可預期的路徑，現在入手 Mac mini M4，能讓遠端協作與自動化少踩環境坑。