痛點拆解:remote 不是「把 URL 貼進 JSON 就結束」
痛點 1:雙設定來源。當 openclaw gateway status 同時印出 Config (cli) 與 Config (service),代表互動式 shell 與 systemd/launchd 服務讀到不同 HOME 或 EnvironmentFile 路徑;你只改 A,守護程序仍讀 B.
痛點 2:誤連舊主機。gateway.remote.url 仍指向下線 IP 或反代上游仍指舊容器 ID 時,UI 可能偶發連到 CDN 邊緣,RPC 卻打進黑洞;請把 DNS TTL、反代 reload、網關重啟放在同一變更窗口.
痛點 3:與 pairing 混淆。版本與 URL 未對齊前不要反覆配對;先讀 配對文.
痛點 4:與通道無回覆混淆。RPC 紅先修傳輸;RPC 綠但 Telegram 靜默請改讀 通道文.
分層:本機 CLI、遠端 RPC、訊息通道
L0:筆電與網關主機各自跑 openclaw --version,避免「筆電新、伺服器舊」.
L1:openclaw gateway status 記錄 Runtime、RPC 探測 URL 是否等於 gateway.remote.url 正規化結果.
L2:openclaw doctor 先清阻塞;安全版更常同時收緊 bind 與 token.
L3:L1 綠後才跑 channels status --probe,並對照 TLS/WebSocket 文.
可引用欄位:工單應固定的幾行數字
建議每次故障單附上:雙 Config 路徑摘要、remote.url、探測目標、權杖前綴(打碼)、systemd/launchd 單元名、最近一次成功 RPC 時間戳、TLS notAfter、RTT(毫秒);升級窗口內每小時追加,方便回歸比對.
容量面:同時多個 UI 連線會放大 WebSocket 壓力;請把探測 p95 與模型延遲分開畫折線.
決策矩陣:先動哪一層
| 症狀 | 高機率根因 | 首選動作 | 回滾注意 |
|---|---|---|---|
| Config(cli)≠Config(service) | 服務中繼資料陳舊 | gateway install --force 後冷重啟 | 先備份 openclaw.json 與憑證目錄 |
| probe failed 但 Runtime running | token/URL/反代 | 對齊 token;驗 upstream;curl/ws 探針 | 記錄反代 reload 與網關重啟順序 |
| remote.url 改了仍連舊 | DNS 或 UI 快取 | 清 DNS;重啟 UI;短暫顯式 hostname 試探 | 避免生產長期寫死 IP |
| 僅通道異常 | 非 remote 層 | 改走通道/429 文 | 避免並行改 token 與 webhook |
七步把 remote 拉回可證偽狀態
- 凍結變數:截圖
gateway status(脫敏)後再改設定。 - 確認 remote 語意:
gateway.mode與gateway.remote.url是否與官方敘事一致。 - 對齊權杖:CLI、UI、服務同源;非 loopback 綁定缺權杖會拒絕。
- 反代四件組:TLS、WebSocket、
allowedOrigins、上游 keepalive。 - 重裝服務中繼資料:見 install 文 執行
openclaw gateway install --force與gateway restart。 - doctor 閉環:清阻塞後再測 probe;摘要貼工單。
- 回歸基線:記錄 probe p95 與一次成功 UI 操作。
工單固定採集(示意)
openclaw --version
openclaw gateway status
openclaw config get gateway.remote.url
openclaw doctor維運加深:量化欄位、責任分界與變更窗口
(1)OpenClaw 遠端網關在 2026 年的維運現場,雙 Config 路徑 與 doctor 阻塞項 常被混寫在同一張工單上:請先凍結變數,把 `openclaw gateway status` 的 Config(cli) 與 Config(service) 路徑摘要貼齊,再核對 `gateway.remote.url` 與探測目標是否一致;若筆電合蓋導致 SSH 隧道中斷,請不要把「通道無回覆」誤判為反代壞掉。長期把網關放在長開機的遠端 Mac 或 VPS 可縮小路徑分叉,但仍要把 Token、反代、DNS 與最近一次成功探測時間戳寫進變更窗口,並把 p95 延遲列為下次升級基線。
延伸閱讀與收束
配對與版本:pairing 文。常駐安裝:gateway install。TLS/WS:反代文。通道:通道無回覆。4.14:安全審計.
正文方案能解「控制面不可達」與「設定單一來源」;但若硬體輪替、入口漂移與筆電睡眠仍吃掉工時,把網關放到長開機遠端 Mac並搭配租賃型維運基線,通常比自建更省變數.
FAQ 與租賃結論
只靠 SSH 隧道可以嗎?
過渡可行;長期仍要把 canonical URL 與權杖寫進文件,避免單人筆電醒著才可用.
何時選 VPS?
固定公網 Linux 自動化;若強調 Apple 原生交付與檔案同機,選遠端 Mac.
為何收束到 SFTPMAC?
當 runbook 已齊但硬體、入口與設定漂移仍耗時,租賃可把常駐與觀測預設值產品化,你保留權杖策略.
