AI / 自動化
2026年4月8日
OpenClaw 部署排錯與恢復：Mac mini M4（2026）
ProxyMac 工程團隊
2026年4月8日
約 10 分鐘閱讀
依安裝部署指南與生產工作流完成設定後，若 daemon 退出、任務卡住或 LaunchAgent 失敗，請用本篇排查：日誌、LaunchAgent、連線與狀態目錄。SSH 不穩先讀SSH 穩定性。
60 秒分流
openclaw statusdf -h ~node --version（≥22）- 對 AI 供應商 HTTPS 出口測試
原則：筆電可、雲端 Mac 不可 → 先查網路與鑰匙串。
日誌與支援資訊
提交說明前附上 daemon 日誌末段、launchctl list | grep -i openclaw、近期是否升級 macOS。
LaunchAgent
bootout → 修正 plist / 路徑 → bootstrap。螢幕錄影權限常需 VNC 點一次。
埠與 API
檢查 127.0.0.1:3000 是否被占用；企業代理把 HTTPS_PROXY 寫進 LaunchAgent 環境變數。
若在 launchd 下因記憶體或「開啟檔案過多」靜默失敗，先讀 OpenClaw 資源上限、ulimit 與記憶體護欄，再追 TLS 與上游代理。
| 現象 | 可能 | 測試 |
|---|---|---|
| 全失敗 | 防火牆 | curl -v 供應商 API |
| 429 | 併發 | 降 maxConcurrentTasks |
狀態目錄
勿把 OPENCLAW_STATE_DIR 放在 iCloud/同步碟；用 ~/.openclaw 並 chmod 700。
決策表
| 狀態 | 動作 |
|---|---|
| daemon 停 | 重載 LaunchAgent |
| 設定壞 | 還原 JSON |
| API 錯 | 換金鑰 |
FAQ
tmux？
長任務可用；daemon 靠 LaunchAgent。
重裝？
小狀態目錄且有備份時可快速重装。
多使用者？
避免 root 寫入狀態目錄。
