2026 OpenClaw Windows 端可復現安裝：PowerShell 一鍵腳本與 WSL2 對比、Gateway 常駐差異與 PATH／doctor 分級排障教程 FAQ

在 Windows 上裝 OpenClaw，最常翻車的不是「下載不到」，而是同一台機器裡同時存在原生 PowerShell、WSL2、多個 Node 安裝與舊版 PATH，導致 CLI 指到錯的執行檔、Gateway 常駐在 A 環境起來、Bot 卻從 B 環境連。本文用一條可復現路線：先釐清你要走原生 Windows 還是 WSL2，再把 Gateway 常駐與防火牆對齊，最後用 PATH 與 doctor 做分級排障。

PowerShell 一鍵腳本與可復現檢查清單

建議以「系統管理員身分」開啟 PowerShell 7+，先固定執行原則與工作目錄，再跑官方或內部維護的一鍵腳本；腳本結尾應輸出版本號、安裝前綴、日誌路徑三行摘要，方便寫進工單。團隊若要完全可復現，請把「Windows 組建號、PowerShell 版本、是否啟用 WSL、預設發行版」寫進 README，避免同事複製貼上同一條指令卻得到不同行為。

# 確認實際執行的是哪一顆 node / openclaw
where.exe node
where.exe openclaw
openclaw doctor

原生 Windows 與 WSL2：選路徑比選指令重要

原生路徑最貼近 Windows 服務與開機工作排程，適合要把 Gateway 當成本機服務、由 RDP 或本機工具鏈喚醒的流程。WSL2 則接近小型 Linux VM：套件管理與 systemd 心智模型與 Linux 文章一致，但網路邊界、localhost 轉發與 Windows Defender 規則是另一套宇宙，不建議在沒畫清邊界前混用兩邊的設定檔。

Gateway 常駐：工作階段、服務帳戶與防火牆

Gateway 常見症狀是「本機 curl 通、同事電腦不通」或「登出 RDP 後服務消失」。原生 Windows 請確認程序是否掛在使用者工作階段、是否改由本機服務帳戶執行，並把入站規則綁在正確設定檔（網域／私人／公用）。WSL2 則要先回答：對外聽埠的是 Windows 端的轉發還是發行版內的程序，再決定探測指令要從哪一層下。

PATH 與 doctor：三級排障

第一級（環境）：比對「安裝前綴\bin」是否在使用者與系統 PATH 的最前面；清掉過期的 nvm、Volta、舊版 Git 內建 mingw 路徑。第二級（執行檔）：用 where.exe 與 Get-Command 交叉驗證，避免 PowerShell 別名遮住真相。第三級（執行期）：跑 openclaw doctor 對齊版本、憑證目錄、監聽埠與日誌目錄權限；若你同時暴露 MCP，請一併核對令牌與白名單設定，細節可延伸閱讀 2026 OpenClaw 作為 MCP Server 接入開發工作流：從 openclaw mcp serve 到令牌鑑權、工具白名單與會話隔離的落地步驟與 FAQ。

簡短 FAQ

為什麼腳本成功但指令找不到？ 多數是新開視窗未載入更新後的 PATH；請關閉終端機或重新登入，並避免在「安裝視窗」與「工作視窗」混用不同使用者。

WSL2 里能用 Windows 的憑證嗎？ 建議把敏感憑證與設定檔放在單一明確掛載點，並在文件中寫清讀寫權限，避免跨邊界複製造成權限漂移。