Windows/WSL2 裝 OpenClaw 最常見的五條誤判簽名
OpenClaw 在 2026 年的安裝面同時涵蓋 macOS、Linux 與 Windows（多經 WSL2）。Windows 側故障常疊加三層：Node 執行環境版本、systemd 使用者工作階段是否可用、18789 是否被幽靈行程占用。運維若把三層壓成「重裝一遍」，就會在 2026.4.24 一類版本上陷入 30–50 秒當機循環，而真正阻塞點仍是使用者級與系統級 Gateway 服務重複註冊。建議變更單先勾選簽名編號，再決定是清理埠號、回退 dist-tag，還是把生產 Gateway 遷到雲端 Mac。
把 WSL 能 ping 通雲端 Mac 當成 Gateway 已健康：傳輸可達不等於 openclaw gateway status 為 active；Node 側 remote URL 寫錯時，Windows 本機仍會獨自當機重啟。
未啟用 WSL2 systemd 就執行 onboard --install-daemon：守護單元寫入後無法由 user session 拉起，SSH 斷線即行程消失，表現像「偶發掉線」。
在 Windows 宿主與 WSL 內各裝一套 Gateway：雙監聽爭用 18789，日誌呈現幽靈 EADDRINUSE，且 doctor 輸出互相矛盾。
筆電睡眠後怪頻道不回：消費級 Windows 休眠會凍結 WSL；生產 webhook 應落在不睡眠的雲端 Mac Master，Windows 僅作 Node 或控制台。
升級後 config key 漂移卻不跑 doctor：跨小版本後舊鍵名仍留在 json 裡，Gateway 行程能起但 channels probe 紅燈，被誤判為 Windows 防火牆。
給簽名貼標籤後再動模型路由。若你已在雲端 Mac 跑 Master，配對與 remote 接線應優先讀 遠端 Node 配對與跨區遷移；若 Gateway 從未在雲主機驗收，請先對照 無頭 SSH 首小時清單，再在 Windows 上疊加 WSL 守護，否則會在抖動 Master 上疊出更多本機重啟雜訊。
Windows 原生、WSL2 與「雲端 Mac Gateway」三分法決策矩陣
2026 年社群共識並非「Windows 不能跑 OpenClaw」，而是把 7×24 控制面與頻道 webhook 放在穩定宿主。下表粗粒度對齊團隊常見組合：僅本機實驗、WSL 開發機自建 Gateway、以及建議的「雲端 Mac Master + Windows Node」分裂拓撲。分裂拓撲與全平台部署手冊互補，見 Gateway 全平台部署與故障恢復。
| 維度 | Windows 原生 (PowerShell) | WSL2 + systemd | 雲端 Mac Gateway + Win Node |
|---|---|---|---|
| 安裝入口 | install.ps1 | install.sh（Ubuntu 內） | 雲端 Mac：install.sh；Win：僅 CLI/Node |
| 守護形態 | 排程工作，易彈窗 | 使用者級 systemd unit | 雲端 Mac：LaunchAgent；Win：可選無守護 |
| 7×24 頻道 | 睡眠／更新打斷風險高 | WSL 暫停即斷 | 頻道僅在雲端 Mac，最穩 |
| 排錯複雜度 | 路徑與權限分裂 | 需懂 systemd + 埠號 | 分層：Win 看 Node，雲端 Mac 看 Gateway |
| 2026 建議情境 | 短期演示 | 本機復現生產腳本 | 跨區小團隊、自動化負責人 |
生產頻道不要賭筆電不睡眠；把 Gateway 放在雲端 Mac loopback，Windows 只跑 node run。
選定分裂拓撲後，文件應寫明：哪台雲端 Mac 接 webhook、Windows 是否僅 openclaw node run --remote wss://...。實驗期可在 WSL 臨時起 Gateway 做對照，但不要與雲端 Mac Master 同時接同一頻道 token，否則會出現雙消費與靜默丟訊息。Docker 與裸金屬差異見 Docker 與 install.sh 雙路徑對照；版本釘版見 升級與回滾 Runbook。
WSL2 前置檢查、Node 24 驗收與「幽靈 EADDRINUSE」分層排錯
在 WSL 內執行生產級 openclaw onboard --install-daemon 前，先確認 Node ≥ 22.16（建議 24） 與 systemd=true。2026 年 4 月下旬部分 2026.4.24 建置在 WSL2 上曾回報：Gateway 日誌顯示啟動，但 Control UI 不可達，並伴隨 30–50 秒一次的 EADDRINUSE 循環——社群緩解之一是釘版到 2026.4.22 並清理重複 systemd 單元。下列命令區塊為值班骨架，請依工單環境替換發行版路徑。
grep -q 'systemd=true' /etc/wsl.conf || echo '[boot]' >> /etc/wsl.conf && echo 'systemd=true' >> /etc/wsl.conf node -v curl -fsSL https://openclaw.ai/install.sh | bash openclaw onboard --install-daemon systemctl --user status openclaw-gateway lsof -i :18789 openclaw doctor openclaw gateway status
若 lsof 顯示 18789 已被占用但 gateway status 為 stopped，優先查殘留 openclaw 行程與/etc/systemd/system 與 ~/.config/systemd/user 是否各有一份 unit。清理後只保留使用者級服務，再 systemctl --user daemon-reload 重啟。仍循環時記錄 openclaw --version，依 Runbook 評估是否從 2026.4.24 回退，並在變更視窗跑 openclaw doctor --fix。Windows 宿主防火牆若需本機除錯 Control UI，僅對開發機放行 18789，生產仍建議 Tailscale Serve 指向雲端 Mac Master，而非把筆電埠號曝露到公網。
提示：每次 onboard 前後各存檔 systemctl --user status 與 lsof -i :18789 輸出，便於區分「雙實例」與「版本缺陷」。
六步 Runbook：從 WSL 驗收到雲端 Mac Master 頻道冒煙
凍結拓撲：記錄 Win 角色（僅 Node／臨時 Gateway）、雲端 Mac 城區、頻道是否只掛 Master。
WSL 前置：啟用 systemd，驗證 node -v ≥ 22.16，必要時在 Ubuntu 內單獨安裝 Node 24。
雲端 Mac 部署 Master：依首小時清單完成 install.sh、onboard、LaunchAgent；確認 loopback 18789 與 gateway status 正常。
Win/WSL 側接 remote：設定 node run --remote 或 Control UI 指向 Master WSS；若 1008 則在 Master 執行 devices approve（見遠端 Node 文）。
清理 Win 本機 Gateway（若採分裂）：停止 WSL 使用者級 unit，避免與 Master 爭用同一頻道設定。
Master 頻道冒煙：在雲端 Mac 跑 channels probe，發真實入站訊息；Win 側僅驗證工具執行，不把 webhook 指回筆電。
三條值班硬閾值與六區雲端 Mac Gateway 選型
埠號爭用紅線：同一台 WSL 實例若 10 分鐘內出現 3 次以上 EADDRINUSE 且行程表存在 2 個以上 openclaw-gateway，應視為雙實例，先停服清理再談升級。
Node 版本下限：官方 2026 安裝文件以 Node 24 為建議基線；低於 22.16 時 doctor 可能通過但外掛載入異常，應在工單註明 node -v 截圖。
分裂拓撲驗收：Master 恢復後 10 分鐘內至少 3 次 channels probe；Win 休眠一次後僅 Node 應可重連，頻道不得依賴筆電在線。
注意：閾值為值班溝通口徑，不構成廠商 SLA。
把 Gateway 綁在 Windows 筆電上，會重新引入睡眠、自動更新重啟與 WSL 凍結；純 Linux VPS 雖便宜，卻與 macOS 瀏覽器自動化、公證鏈工具脫節。以裸金屬雲端 Mac 為 Master、Windows 僅作 Node 或控制台，能在 Apple 工具鏈鄰近、loopback 紀律與可預測換租視窗之間取得平衡。對要 7×24 頻道、又不願賭消費級硬體在線率的團隊，MESHLAUNCH 的 Mac Mini 雲端租用通常是較優解：建議目標城區日租先完整跑通六步與一次宿主重啟，再鎖月租。容量與下單見 租用價格 與 雲端說明中心。
先 lsof -i :18789 與 systemctl --user status openclaw-gateway，清理雙 unit 與殘留行程；核對 2026.4.24 是否需釘版回退。對照 全平台 Gateway 手冊；下單見 價格頁。
可以用於短期實驗。生產頻道建議遷到雲端 Mac Master，Win 僅 node run。部署步驟見 無頭 SSH 首小時清單。
檢查 /etc/wsl.conf 的 systemd 是否仍啟用，並跑 openclaw doctor。分裂拓撲下頻道應在雲端 Mac 仍在線；說明見 雲端說明中心。