三種 Windows 安裝方式

方式適合情境主要注意事項
Windows Hub偏好桌面 App、系統匣狀態、聊天與診斷依電腦架構選 x64 或 ARM64 安裝檔
PowerShell CLI熟悉 Windows 終端機，想原生管理 CLI／Gateway確認執行政策、Node 與使用者 PATH
WSL2 Gateway需要 Linux 相容工具、systemd 或既有 Linux 流程Windows 與 WSL 是兩個環境，路徑、網路與服務啟動要分開檢查

怎麼選最快？

  1. 只想先在 Windows 上完成設定與對話：從 Windows Hub 開始。
  2. 要直接用指令管理、環境也以 Windows 為主：選 PowerShell。
  3. 後續會接 Linux 工具、背景服務或既有 WSL 開發環境：選 WSL2。
  4. 若要長時間無人值守，先確認登入前後的啟動需求與實際維護人員。

官方安裝入口

OpenClaw 官方目前列出的系統需求包含受支援的 Node 版本，並提供桌面 App 與安裝腳本。版本會改動，實際操作前應以官方頁面為準，不要直接複製過期教學中的版本號。

安裝後要驗收什麼？

  • 重新開機或重新登入後，Hub 或 Gateway 是否能按預期啟動。
  • Dashboard 是否可開啟，狀態頁是否顯示正確執行環境。
  • API Key 與通訊平台權限是否由使用者本人輸入並保管。
  • 測試訊息是否能收發，錯誤時知道去哪裡查看紀錄。
  • 是否留下更新、停用、備份與移除方式。

想看跨平台概覽，可先讀 OpenClaw 安裝教學；需要遠端協助時，再確認 OpenClaw 安裝服務範圍。

常見問題

OpenClaw 在 Windows 一定要裝 WSL2 嗎？

不一定。官方目前提供 Windows Hub、原生 PowerShell CLI 與 WSL2 Gateway；若重視桌面操作可先看 Hub，需要 Linux 工具相容性時再選 WSL2。

Windows Hub 和 PowerShell 安裝有什麼差別？

Windows Hub 是原生桌面配套，包含設定、系統匣狀態與診斷；PowerShell 安裝適合希望直接操作 CLI 或 Gateway 的使用者。

安裝完成後怎麼驗收？

至少確認應用或 Gateway 能重新啟動、Dashboard 可開啟、指定通訊管道可收發測試訊息，並記錄權限、更新、停用與移除方式。