租用 Mac mini 上的 OpenClaw 閘道重新啟動：LaunchAgent 陷阱與 2026 安全復原
OpenClaw 閘道是在你租用的位於香港、日本、韓國、新加坡或美國的Mac mini M4上長期駐留、連線聊天通道、工具呼叫與模型後端的行程。維運會因憑證輪替、權杖重新整理、卡死的通道介面卡或 macOS 更新而重新啟動它——隨後發現機器突然「無頭」，因為 launchctl bootout 移除了唯一的監管路徑。這份 2026 手冊解釋閘道重新啟動與一次性 CLI 操作有何不同，給出四欄風險矩陣，並規定安全復原順序以避免自斷咽喉。請與 安裝與部署、部署疑難排解、LaunchAgent 排程 一起使用，以便每次 bounce 後 PATH、TMPDIR 與金鑰仍對齊。
2025–2026 的社群議題反覆出現一個 macOS 主題：在同一代理工作階段裡發起命令卻卸載 LaunchAgent，導致 launchd 沒有乾淨的重引導故事。你不必在此鏡像上游缺陷編號——只需把重新啟動順序當作生產資料：在改動無人值守金屬上的 launchd 圖之前，始終保留第二條控制面（額外 SSH、帶外 VNC 或供應商主控台）。
為何閘道重新啟動在雲端 mini 上比筆記本更危險
筆記本會在選單列圖示死掉時叫醒人類。ProxyMac mini 可能躺在機架上沒有本地座位，因此閘道既是自動化大腦，也是監聽配對審批的唯一行程。沒有清單就重新啟動可能默默丟掉通道白名單、進行中的工具控點，或與 MCP 設定 中描述的 stdio 子行程失步。
- 單租戶預期：客戶假定 CPU 屬於自己——閘道抖動若未溝通會變成一級事故。
- 貼近 GUI 的權限：重新啟動後 TCC 提示可能不再遠端出現——事先依 TCC 順序 預檢。
- 磁碟上的機密：在同一視窗輪替權杖前，依 鑰匙圈加固 驗證解鎖路徑。
風險矩陣：動作 → 爆炸半徑 → 偵測 → 緩解
| 動作 | 爆炸半徑 | 如何發現 | 如何緩解 |
|---|---|---|---|
在受監管工作階段內部執行 openclaw gateway restart | 行程在重新拉起完成前就退出 | SSH 通道關閉；webhook 佇列停滯 | 開第二條 SSH；在確認 label 後優先 launchctl kickstart -k gui/$(id -u)/… 模式 |
| 在 ~/Library 與 /Library 間移動 plist | 狀態 CLI 與域不一致 | openclaw status 與 launchctl print 不符 | 選定一種域模型；把路徑寫進手冊 |
| 編輯 EnvironmentVariables 卻不 reload | 陳舊 PATH → 找不到 MCP 二進位 | 工具呼叫以 ENOENT 失敗 | 一次性 bootout/bootstrap 對，然後浸泡測試 |
| 並行升級 + 重新啟動 | 混合 semver 設定 | doctor 告警 | 依序處理：先升級再重新啟動；儲存 openclaw doctor 輸出 |
安全復原順序（先互動，再無人值守）
- 開啟第二條 SSH 工作階段（或依 VNC 說明 使用螢幕共享）再碰
launchd。 - 抓取狀態：
openclaw status、閘道日誌與通道配對清單——貼到工單。 - 優先對已知的 LaunchAgent label 使用 kickstart -k，在流量仍流動時避免反覆 bootout 迴圈。
- 核對 plist ProgramArguments 仍指向你在 bootstrap 期間驗證過的同一 venv 或全域安裝。
- 重跑 doctor 與最小通道探測，再宣布復原。
- 僅在日誌顯示連續兩天乾淨重新啟動後才推廣到無人值守——鏡像 LaunchAgent 清單。
重新啟動後的環境 vs 設定一致性
閘道行程繼承的環境很窄。互動 shell 常拉取 nvm、pyenv 或 direnv 鉤子，而 LaunchAgents 沒有這些。每次重新啟動後，將 LaunchAgent 上下文中的 printenv 與登入 shell diff，並據此對齊 MCP 伺服器路徑。
日誌分診：先 grep 什麼
從重新啟動時間戳附近的閘道 stderr 開始，若啟用了子系統篩選器再擴展到統一日誌。若迴圈中有 HTTP 觸發，請與 入站 webhook 重試關聯——429 風暴看起來像閘道崩潰，實則未必。
銜接安裝、MCP、webhook 與生產流
閘道復原位於 首次安裝、生產工作流 與 並行代理限制 之間。文件分散時，把連結集中到內部 wiki，並複用財務已信任的 說明中心 錨點。重啟前把閘道設定納入 Git 晉升流程，請一併閱讀 OpenClaw 設定版控與 GitOps（2026），讓每次 launchctl kickstart 都對齊已標記的清單。
常見問題
為何 gateway restart 有時會讓服務一直 down？ 激進的卸載路徑 + 單通道控制——用 kickstart 模式並保留第二條工作階段。
~/Library 還是 /Library？ 預設每使用者 LaunchAgents；守護行程改變擁有者與狀態語義——選一種。
無人值守排程？ 復原後依排程文章清單重新驗證 PATH/TMPDIR。
為何在 ProxyMac 的 Mac mini 上打磨閘道重新啟動
你需要常開裸金屬、穩定的 macOS 使用者工作階段、為 MCP 子行程可預測的 CPU，以及靠近所整合聊天 API 的 HK / JP / KR / SG / US 區域。ProxyMac 讓你在可丟棄的 mini 上排練重新啟動演練，把命令記在 定價 旁，待手冊成熟後再下線主機——而不必拿筆記本上唯一的 LaunchAgent 圖冒險。
