當 OpenClaw 風格的閘道跑在遠端、常駐開機的 Mac上，多數事故是 launchd 狀態漂移、殘留監聽，或兩份 plist 搶同一 Label。本手冊用可複現的三角：doctor、status、logs，讓 SSH 收尾有結論。路徑與 Docker／本機常駐邊界請先讀 了解更多：2026 OpenClaw 遠端 Mac 部署實操：安裝路徑對照、Docker 與本機常駐、常見錯誤與工作流案例；Agent 離線與多機 Runner 可搭配 了解更多：2026 OpenClaw 手把手部署與自動化整合手冊：解決跨平台 Agent 離線與執行權限難題，實戰 GitHub Actions 多機協作。
一、先對齊 doctor、status、logs，再動 plist
Doctor 類檢查回答執行檔已知設定：管理埠、權杖檔、資料目錄與選用模組。請用與 launchd 相同方式在 SSH 執行（bash -lc 或 plist 內寫死 PATH）。Status 是線上事實：健康檢查、TLS，以及從 Mac 本機對上游連線。Logs 收斂「doctor 綠但 status 抖動」：日誌集中到例如 ~/Library/Logs/OpenClawGateway 並以大小輪替。
二、會在無人值守 Mac 上咬人的 launchd 細節
LaunchAgent 在使用者登入後載入；LaunchDaemon 以 root 在圖形工作階段前啟動。重開機後仍要存活的閘道多半應放 /Library/LaunchDaemons（root 擁有 plist／二進位，不依賴有人解鎖鑰匙圈）。請設定 WorkingDirectory、絕對路徑 ProgramArguments、StandardOutPath／StandardErrorPath 與 ThrottleInterval。異常以 launchctl print 與 log show --predicate 'subsystem == "com.apple.launchd"' 追查；常見退出原因是 PATH、權限或沙箱，doctor 未必看得到。
若閘道必須讀 GUI 專屬密鑰而只能用 per-user Agent，維運說明應寫清：哪個帳號保持登入、螢幕共享鎖定方式、以及強制登出後行為。plist 註解與基礎設施倉庫請維持同一語意版本號，避免遠端「本機修一下」無從稽核。
三、埠號占用：當「位址已被使用」其實是兩個服務
閘道常綁固定埠；升級後孤兒行程可能占住 socket。SSH 上跑 lsof -nP -iTCP:<埠號> -sTCP:LISTEN，對照 launchctl print gui/$uid 或 print system 的 Label。PID 不符時先 bootout、確認二進位路徑，再結束遊走行程（有自託管 Runner 時避免 killall）。Docker Desktop 若佔同一主機埠，多半是 VM 先綁走——改容器埠或讓閘道留在裸 macOS。
四、雙 LaunchAgent 衝突：重複 Label 與「好心」安裝程式
兩份 plist 不同資料夾卻共用 Label，重開後誰載入成功非決定性（手寫 plist 與 Homebrew service 同時註冊常見）。盤點 /Library/LaunchAgents、~/Library/LaunchAgents、/Library/LaunchDaemons，版本控制只留一份權威 plist。Ventura 後優先 bootout／bootstrap 成對；舊 unload 可能靜默無效。寫清操作順序，避免用錯使用者 bootstrap 而在 TCC 上晚爆。
五、遠端常駐 Mac：可貼進工單的檢查清單
- 電源策略：交流電時關閉磁碟睡眠，確認顯示器睡眠時 Wi‑Fi 不會整段斷線。
- 時鐘偏移：啟用網路校時；與控制平面 TLS 時，幾分鐘偏差就會讓錯誤看起來像「幽靈」。
- 磁碟餘裕：閘道會快取對話與附件——在 85% 前告警，避免 launchd 工作因 ENOSPC 退出。
- 權杖輪替：API 金鑰更新後重啟工作，並在 logs 確認新憑證指紋，而不是卡在 401 迴圈。
- 對外煙霧測試：用使用者實際路徑對公開監聽器
curl，不要只測 localhost。
閘道類服務，為什麼仍常以 Mac mini 類主機為錨點
閘道吃硬體穩定度：健康檢查失敗即 pager 噪音。Mac mini 在 Apple Silicon 上單執行緒強、待機功耗極低，7×24 跑 daemon 比塔型空轉更划算；原生 Unix、Homebrew 與 macOS 的 Gatekeeper、SIP、FileVault 也讓對外維運較不拼裝。標準化 2026 自動化時，先選安靜、省電、可預測節點再擴區域，通常優於過早堆核心。
若你希望把本文閘道與監控跑在更流暢、長期更省心的硬體上，Mac mini M4 是兼顧體積、噪音與閘道＋鄰近 CI 餘裕的起點。現在即可把獨享遠端 Mac 納入評估：開啟 Macstripe 首頁 比對區域與機型。
