痛點：行程在跑不代表閘道可信
痛點1：把PID當驗收。監督器可能在快速重啟子程序，用戶端卻逾時。請依閘道維運與doctor通道排查的階梯執行。
痛點2：Linux忘了linger。SSH斷線後systemd --user工作階段結束，閘道跟著消失，這不是OpenClaw缺陷。
痛點3：混淆force與解除安裝。gateway install --force刷新閘道側產物；解除安裝清理更廣的整合面。
痛點4：launchd日誌路徑漂移。npm全域路徑變更後plist內StandardOutPath可能指向舊目錄，參考常駐與健康矩陣。
痛點5：把反代症狀當應用bug。先對照反向代理與TLS再重裝。
痛點6：三類失誤疊加成「隨機故障」。只備份 JSON 却忽略 plist／unit 雜湊、把 loginctl enable-linger 開在共用帳號、或只在 loopback 驗 RPC。請把 gateway install --force 與 semver、4.x+doctor、WSL2、快照與 MCP 冷重啟寫進同一變更單，並登錄 CLI／閘道 semver、doctor 摘要雜湊、linger、RPC p95、憑證 notAfter、監督器重啟計數、日誌碟可用率。
官方階梯：status→gateway→logs→doctor與RPC探針
先openclaw status，再閘道粒度狀態，再日誌，再openclaw doctor（先不要--fix）。僅在快照與變更視窗內執行doctor --fix。RPC要走與真實用戶端一致的網域與憑證名。
健康行程只代表監督器拉起二進位；RPC成功才代表驗證、路由、通道適配器與版本標籤一致。把p95延遲、錯誤率與反代access日誌對齊存檔。
macOS launchd安裝與force後覆核
核對Label、ProgramArguments、WorkingDirectory、KeepAlive與日誌路徑；gateway install --force後重新diff plist。
Linux systemd --user與loginctl enable-linger
為專用帳號執行loginctl enable-linger，確認Linger=yes；安排無互動登入的冷啟動驗證。
2026年可引用資料：工單建議登錄欄位與閾值基線
以下為可稽核基線，可依環境調整：以本機 openclaw gateway status 列印為準（上游文件常見本機控制台埠為18789）；Node 主版本須符合 openclaw doctor 最低要求並寫入變更單；長期日誌所在檔案系統建議保留≥15% 可用空間；啟用 loginctl enable-linger 後至少執行一次冷重啟與一次經公開主機名與憑證鏈的 RPC 探測；快照需含 plist／unit 的 SHA256 與 which openclaw 路徑。
| 欄位 | 範例 | 用途 |
|---|---|---|
| CLI／閘道 semver | 2026.4.x | 對應二進位與公告 |
| plist 或 unit SHA256 | 64 位十六進位 | force 後與快照 diff |
Linger | yes／no | 驗證無 SSH 仍可常駐 |
| RPC p95 | 如內網邊緣 <300 ms（範例） | 區分網路與閘道路由 |
| 日誌碟可用率 | ≥15% | 避免輪替截斷證據 |
gateway install --force與七步路徑
# 1) openclaw status
# 2) openclaw gateway status
# 3) 依通道ID過濾日誌
# 4) openclaw doctor
# 5) gateway install --force
# 6) systemctl --user daemon-reload && systemctl --user restart SERVICE
# 7) loginctl enable-linger USER
- 歸檔JSON、金鑰、plist/unit片段與反代片段。
- 依階梯執行到doctor（無fix）並分類錯誤。
- 若僅閘道產物損毀，在核可視窗內執行force。
- 重載監督器；啟用MCP則冷重啟。
- Linux啟用linger並做無SSH驗收。
- 送出合成RPC與通道探針。
- 若路徑衝突或完整性不可證，解除安裝單通道後乾淨重裝。
決策矩陣、量化欄位、FAQ與SFTPMAC
| 情境 | 首選動作 | 證據 | 風險 |
|---|---|---|---|
| RPC失敗但行程在 | 階梯→定向重啟 | 結構化日誌+公網SNI | 僅loopback誤判 |
| 升級後模板缺 | gateway install --force | doctor告警 | 覆蓋本地熱修 |
| SSH退出即停 | loginctl enable-linger | 變更前Linger=no | 誤用system域 |
| npm與Docker並存 | 解除其一 | which歧義 | 停機視窗失控 |
Linux上SSH斷線就停？
檢查user linger與帳號隔離。
force等於解除安裝？
不等，作用域不同。
行程健康就夠？
不夠，需要RPC與TLS邊緣一致。
總結：閘道可靠性是系統工程。
局限：自管主機仍要承擔修補與磁碟成本。SFTPMAC託管遠端Mac以可重複映像疊加SFTP/rsync交付。
三段收束：先肯定自建價值；再點出多機分散成本；最後說明託管遠端Mac如何把常駐與證據鏈壓成可複製服務。
版本、快照、linger與RPC探針同面板。