which openclaw 到首則訊息的七步驗收、雲端 Mac 的 PATH 與螢幕共享注意事項，以及 Retry 掩蓋記憶體壓力時的 M4 與 M4 Pro 選型；並與站內 官方 install-daemon、launchd token 修復、診斷梯子、CLI 對齊、無頭 SSH 跟做 交叉閱讀，讓 Retry 不再靠猜。
2026 雲端 Mac 安裝精靈 Retry：Gateway 未就緒的四類根因
macOS 安裝精靈會以短週期輪詢 Gateway 健康狀態。畫面只顯示Gateway 未就緒並反覆提供 Retry 時，失敗幾乎總是基礎設施尚未就緒，而不是 channel 配對或 API 金鑰。在 KVMNODE 節點上，團隊往往先用 SSH 裝好 CLI：互動式 shell 看得到全域 openclaw，精靈子程序卻繼承較窄的 PATH，於是你在終端機幾分鐘前還能下指令，精靈卻無限 Retry。
第二類根因是launchd 已失敗退出而精靈仍在倒數：SSH 執行 openclaw gateway start 可能因部分 socket 而顯示成功，但 launchctl print 顯示 LaunchAgent 工作因缺少 OPENCLAW_* 或錯誤 WorkingDirectory 而崩潰。第三類是埠 18789 爭用：舊的手動 gateway start、第二次 onboard，或殘留 Node 程序先綁定 loopback，plist 擁有的 Gateway 無法掛載。第四類是繫結位址不一致：Gateway 聽在 127.0.0.1，精靈或健康探針卻期望區域網路介面，或改過設定後方向相反。
PATH 無 CLI：圖形工作階段中 which openclaw 為空；安裝只在 SSH 完成。
launchd 失敗、精靈逾時：工作退出碼非零；Retry 不會顯示 stderr。
18789 被佔：lsof 顯示其他 PID；健康檢查永遠到不了 ready。
plist 環境漂移：SSH 用 nvm 的 Node 22，plist 仍指向系統 Node 18。
升級後分裂：應用程式套件比 CLI 新；精靈前先對齊（見 CLI 對齊）。
再次點 Retry 前，請把四類根因貼進變更單。若已依 官方 install-daemon 安裝，驗收應凍結openclaw 版本、launchd 標籤、監聽埠、doctor 退出碼、精靈截圖或略過理由。精靈終於通過後若出現驗證錯誤，請對照 診斷梯子 L2 與 launchd token 文，不要先換硬體。
平台負責人應把 Retry 迴圈在「正式 Gateway 已斷」時才升為 P1；首次安裝精靈在 PATH 與埠檢查未非互動通過前，應禁止連續點 Retry，否則日誌交錯會丟失第一次失敗時間戳。
決策矩陣：略過精靈與用螢幕共享完成精靈
無頭團隊想從 SSH 關閉精靈；macOS 應用程式仍期望部分 channel 流程在圖形介面完成。下表是分叉：若 CLI 欄每一列皆綠，請在工單記錄精靈略過並依 無頭 SSH 跟做 做 onboard。任一行為紅，請用螢幕共享登入一次，修正 launchd 與 PATH 後讓精靈跑完，使配對狀態與應用程式儲存一致。
| 檢查項 | 純 CLI（可略過精靈） | 必須用安裝精靈 |
|---|---|---|
| which openclaw | SSH 與 plist EnvironmentVariables 同一路徑 | 圖形工作階段為空 |
| openclaw doctor | 退出碼 0，無阻擋遷移 | 需 GUI 完成後 doctor 才過 |
| gateway status --deep | ready，繫結與 token 正確 | RPC 逾時或 401 迴圈 |
| 埠 18789 | 單一 listener 由 plist 擁有 | 未知 PID 或雙重 onboard |
| Channels | 已用 CLI 配對 | 僅 macOS 應用程式首次配對 |
變更單上沒有凍結的 PATH 一行就點 Retry，不是除錯，是雜訊。
請在資產清冊標註主機是精靈優先還是CLI 優先。混用範本會讓稽核困惑：同版 openclaw 一台略過精靈、另一台必須跑精靈。分叉確定後，精靈開啟時勿再從 SSH 跑第二次 onboard --install-daemon，否則會複製 LaunchAgent 標籤並重演 install-daemon 文所述的 18789 衝突。
命令塊：再次 Retry 前的 PATH、doctor、launchd 日誌與埠 18789
在獨佔雲端 Mac 上透過 SSH 執行下列區塊，再碰精靈的 Retry。將 LaunchAgent 標籤替換為 launchctl list | grep -i openclaw 的實際 plist 名稱。完整 stdout 貼進變更單；失敗對照 診斷梯子 L1。
export PATH="/opt/homebrew/bin:/usr/local/bin:$PATH" which openclaw openclaw --version node -v openclaw doctor openclaw gateway status --deep lsof -nP -iTCP:18789 -sTCP:LISTEN log show --predicate 'process == "openclaw"' --last 5m 2>/dev/null | tail -n 40 launchctl print gui/$(id -u)/com.openclaw.gateway 2>/dev/null | head -n 30
提示：若 doctor 回報 CLI 比執行中 Gateway 新，請停止 Retry 並先依 CLI 對齊，再讓精靈探測健康。
當 lsof 顯示的 listener 不是你的 plist 工作時，執行 openclaw gateway stop，僅在變更單點名 PID 後才結束殘留程序，再 openclaw gateway start 或依 官方安裝 重裝 daemon，切勿留下兩套啟動器。清埠後的 token 或驗證錯誤請走 launchd token，不要塞回精靈 Retry 迴圈。
七步：從 Retry 迴圈到 Gateway 就緒與首則訊息
凍結版本：記錄 openclaw --version、node -v 與 KVMNODE 區域。
對齊 launchd 的 PATH：將與 SSH 相同的 openclaw 與 Node 路徑寫入 LaunchAgent EnvironmentVariables。
跑一次 doctor：任何精靈 Retry 前先修遷移；保存 stdout。
清埠 18789：單一 listener；停止重複 onboard 或手動啟動。
經 plist 重啟 Gateway：對標籤工作 launchctl kickstart -k；確認 gateway status --deep 為 ready。
精靈或記錄略過：螢幕共享完成安裝精靈，或依第二節附上 CLI 略過證據。
首則訊息驗收：一則 inbound channel 或 RPC ping、健康 JSON 一行與時間戳；不穩則升 L2 梯子。
七步全過後，工單應寫明是哪個槓桿清掉 Retry：PATH、launchd、埠、版本對齊或節點檔型。驗收週請每日快照 gateway status --deep，將 P95 延遲與 SLO 對照。若步驟 05 在 SSH 已過但精靈仍 Retry，假設圖形 PATH 漂移，僅用螢幕共享登入一次確認應用程式看到相同二進位，在 doctor 與埠列皆綠前勿整機重裝。
大量 onboard 雲端 Mac 的團隊，應在堡壘機 playbook 與 SSH 金鑰同列一行健康探針：curl -sf http://127.0.0.1:18789/health 或 openclaw.json 記載的路徑，在 kickstart 之後、通知精靈負責人之前執行。這能區分「精靈 UI 慢」與「Gateway 從未監聽」，也是 Retry 截圖進群組卻沒日誌時，利害關係人需要的分界。
雲端 Mac 特點、三個硬數字，以及 Retry 掩蓋壓力時的 M4 與 M4 Pro
獨佔雲端 Mac 與筆電不同：沒有合蓋睡眠，但SSH 工作階段不繼承圖形 PATH，螢幕共享可能斷線，六區節點只改日誌時區標籤而非 Gateway 邏輯，卻會影響事件時間軸。請勿把 ~/.openclaw 放進團隊同步碟；精靈 Retry 改寫設定的同時，若 CI 程序寫同一磁碟，可能交錯部分寫入。
預設 Gateway 埠：除非 openclaw.json 覆寫，否則為 loopback 上的 18789，健康探針必須對準同一繫結。
2026 建置的 Node 主版本：doctor 前在 SSH 與 plist 凍結 Node 22（或 install.sh 釘選版本）。
精靈輪詢視窗：連續三次 Retry 仍無日誌擷取，視為流程失敗，必先跑命令塊。
| 部署情境 | 近區 M4 試跑 | 遠區 M4 Pro 常駐 |
|---|---|---|
| 雲端 Mac 首次 OpenClaw 驗證 | 對 Git 與精靈 UI 的 RTT 較佳 | 首日即需統一記憶體餘量時採用 |
| Retry 已清但 Gateway P95 對協作者仍 > 800ms | 先調區再談升檔 | 僅在 RTT 已修且記憶體仍頂滿 |
| 同一主機跑 iOS CI 與 Gateway | 16GB 在 archive 尖峰有風險 | 18789 與 xcodebuild 同抖時優先 |
注意：在規格不足的節點上多點 Retry 無法修 launchd PATH；doctor、埠與梯子 L1 連續 48 小時為綠後再談升檔。
個人 Mac 當唯一 OpenClaw 宿主時，合蓋睡眠會讓精靈完成時間不可預測，Terminal 與圖形的 PATH 也不一致。共用辦公室虛擬機還有鄰居干擾，無法合同化 7×24 launchd 驗收。對需要可審計、可換區、可升檔獨佔 Apple Silicon，且安裝精靈、Gateway 與選配 CI 共用同一台機器的團隊，KVMNODE Mac Mini 雲端租賃通常是更合適的選擇：獨佔主機、六區節點、按天到月租，與 PATH、18789、M4 Pro 升級同一套選區語言。下單見 訂購入口，操作說明見 幫助中心，檔位見 定價頁。