若你剛跑完官方 install.sh 或 install.ps1，終端機卻提示 找不到 Gateway、預設連接埠無監聽、Control UI 打不開——這通常不是「你裝錯了」，而是 2026 年社群裡高頻出現的 半安裝狀態：CLI 已就位，但 Gateway 守護進程與 onboard 收尾未閉環。本文面向要把 OpenClaw 推進生產的開發者，給出 10 分鐘驗收階梯、六步恢復 Runbook、對照表與上線 checklist；並與站內 全平台安裝避坑、Node 24 生產基線 分工閱讀。
2026 年 3 月前後，上游社群集中回報過一類問題：安裝腳本在全新環境只刷新了既有 Gateway 服務，卻未執行首次 daemon install，導致表面成功、實則 Gateway 缺席。即便你已升級到包含修復的版本，舊機器仍可能殘留半安裝痕跡。下面五條任意命中兩條以上，就應走本文恢復路徑，而不是直接重裝整台主機。
openclaw-gateway 或等價指令不存在：which openclaw 有結果，但 Gateway 二進位或符號連結未寫入 PATH 預期目錄。
預設連接埠（常見 18789）無監聽：openclaw gateway status 顯示未執行或反覆退出，且 openclaw logs 為空或極短。
Control UI / Dashboard 無回應：瀏覽器存取本機管理端逾時；這與「鑑權失敗」不同，多半是行程根本沒起來。
onboard --install-daemon 曾報錯或跳過：v2026.3.x 部分建置在 systemd 檢查環節失敗，留下「組態寫了、服務沒裝」的縫隙。
升級後反而變壞：從舊版 npm 全域套件升級後，PATH 上同時存在兩個 openclaw，doctor 提示 split brain 或舊二進位閘門——應先讀站內 升級分叉恢復，再回本文驗收 Gateway。
僅頻道探測失敗、Gateway 卻顯示 running：表示半安裝已度過最危險階段，應轉讀 鑑權排錯專文，避免誤刪組態。
| 檢查項 | 健康（可進生產） | 半安裝（本文範圍） | 偽成功（易誤判） |
|---|---|---|---|
openclaw gateway status | Runtime: running；探針 ok | not running / 指令缺失 | running 但連接埠實際未監聽（陳舊 PID 檔） |
openclaw doctor | 無阻塞項；組態 validate 通過 | 提示 daemon 未安裝或 PATH 異常 | 僅 warning，被忽略未處理 |
channels status --probe | Connectivity probe: ok | 未設定頻道（可接受於純 Gateway 階段） | probe 失敗卻當作「裝壞了」 |
| Node 執行環境 | Node 24（或官方宣告的最低 22.14+） | 混用系統 Node 與 nvm，導致 service 使用者讀不到 | 互動 shell 裡 node -v 正確，systemd 單元裡仍是舊版 |
「腳本最後一行顯示成功」不等於 Gateway 已託管——生產驗收必須落到 status、doctor 與連接埠監聽三件事上。
順序很重要：先讓 Gateway 能啟動並持久化，再跑 onboard 補全模型與頻道；不要在行程不存在時反覆改 openclaw.json。
凍結現場：記錄 openclaw --version、which -a openclaw、安裝方式（curl 腳本 / npm -g / git），避免同時改 Node 與組態。
跑官方診斷階梯：openclaw status → openclaw gateway status → openclaw logs --follow（另開終端機）→ openclaw doctor。
拉起 Gateway：openclaw gateway start；若提示 daemon 未安裝，執行 openclaw onboard --install-daemon（依精靈完成 Token 與最小組態）。
修復「CLI 有、Gateway 無」：在確認 Node 24 基線後，可執行 npm install -g openclaw --force 對齐全域套件與二進位；容器環境請改走 Docker/Podman 路徑而非強行 systemd。
版本策略：若卡在 v2026.3.2 類 daemon 迴歸，短期可鎖定 v2026.3.1 或更新到含 PR #48649 修復的建置，並在變更單寫明回滾點。
生產驗收：openclaw channels status --probe、確認 loopback/Token、重啟後複檢；macOS 常駐請對照 遠端 Mac launchd 專文，Linux 對照 Ubuntu systemd 部署。
# 10 分鐘驗收階梯（2026 推薦順序） openclaw status openclaw gateway status openclaw doctor openclaw gateway start openclaw onboard --install-daemon # 若 daemon 未安裝 openclaw channels status --probe
提示：官方安裝腳本在 macOS/Linux 上推薦 Node 24；生產環境請先完成 CVE-2026-25253 與 Node 24 基線，再執行本文恢復，避免在安全修補未對齊時開放 Gateway。
注意：不要在半安裝階段把 Gateway 直接暴露到公網；預設應綁定 127.0.0.1，遠端存取走 Tailscale 或反向隧道，詳見站內 Gateway 安全與 Tailscale 專題。
onboard --install-daemon 解決「把 Gateway 變成可重啟的服務」——兩步缺一即半安裝。doctor 與 gateway status 的定期探測記錄；GitHub issue #48272 類問題說明「安裝日誌成功」不能替代行程級驗收。把 Gateway 長期放在會睡眠的筆電或與他人混用的開發機上，容易在系統更新後回到半安裝邊緣；而獨占、長期在線的 macOS 節點更適合作為 Agent 閘道宿主。若你需要像租 VPS 一樣快速拿到可 SSH 維護、可重複跑驗收腳本的 Mac 算力，NodeMini 的 Mac Mini 雲端租賃通常是更優解：與 OpenClaw 遠端模式、CI 建置同機部署等站內實踐同一維運心智，便於把「安裝後 10 分鐘驗收」固化進標準映像與 Runbook。規格與頻寬、伺服器檔位可參考 租賃價格說明，接入流程見 雲端 Mac 說明中心（繁中）。