How well does OpenClaw work on Windows? ๐ŸชŸ

Native install vs. Windows Hub vs. WSL2 โ€” judged against OpenClaw's own maturity scores and its live issue tracker.

Verdict: run it under WSL2. It is the only Windows path OpenClaw rates as Beta, and it is closest to the Linux runtime that CI actually exercises. Want a desktop app? Windows Hub is a fine choice โ€” it provisions a WSL gateway underneath anyway. What you should not do is put anything load-bearing on the native Windows Gateway.

OpenClaw's own scores

Straight from docs/maturity-scores.yaml in the installed package. Score run completed 2026-05-30. It keeps three separate Windows entries.

Windows via WSL2

Beta ยท M3 โ˜… Recommended
Coverage
72
Quality
69
Completeness
72

LTS-supported in 5 of 6 categories โ€” the best any Windows path manages.

WSL Setup 76 ยท CLI 76 ยท Diagnostics & Repair 74 ยท Browser & Control UI 72 ยท Gateway Access & Exposure 70 ยท Gateway Service Lifecycle 64 (the one Alpha soft spot)

  • Only Windows path rated Beta
  • Closest to the runtime CI actually covers
  • LTS in 5 of 6 categories
  • Real systemd service lifecycle
  • Gateway Service Lifecycle still Alpha at 64
  • WSL's own virtual network โ€” LAN needs netsh portproxy
  • WSL IP changes across restarts
  • Needs the dbus-launch idle-termination workaround

Native Windows CLI + Gateway

Alpha ยท M2
Coverage
68
Quality
63
Completeness
68

Install with iwr -useb https://openclaw.ai/install.ps1 | iex. LTS-supported in only 1 of 4 categories.

Updates 74 ยท CLI 72 ยท Gateway Management 68 ยท Networking 58 โ€” the weakest Windows category anywhere

  • No WSL required
  • Updates and CLI reach Beta-level coverage
  • Scheduled Task startup, Startup-folder fallback
  • LTS in only 1 of 4 categories
  • Gateway exits silently, code 0, no recovery
  • exec/read can silently return empty output
  • CLI gateway commands take 10โ€“30s

Windows Hub โ€” companion app

Planned ยท M0 Score likely stale

Native WinUI app for Windows 10 20H2+ and Windows 11. Signed x64 and ARM64 installers, no admin rights needed.

A contradiction worth knowing about. The docs lead with "Recommended: Windows Hub", yet the maturity file still rates it M0 with coverage 5. The likely explanation is timing: the score run is dated 2026-05-30, while the docs link Hub installers from release v2026.6.5 โ€” June. The Hub shipped after the last scoring pass. Read that M0 as unmeasured, not as a verdict.
  • Installs without administrator rights
  • Sets up an app-owned WSL gateway โ€” so you get the Beta runtime underneath
  • Tray status, native chat, Command Center diagnostics
  • Windows node mode + local MCP server for Claude Desktop/Code/Cursor
  • Does not mutate your existing Ubuntu distro
  • Rated M0 / coverage 5 โ€” but measured before it shipped
  • Node mode requires gateway pairing
  • Screen and camera commands need explicit opt-in

โš ๏ธ Why the quality scores are low

This is the single most illuminating finding โ€” GitHub issue #126874, still open, measured at commit e78b9d3ce4a:

0.60%of the test suite runs on Windows
66of 10,979 test files
23 / 43Windows-named test files never run on Windows

That is the mechanism behind the Alpha rating. Windows regressions are structurally unlikely to be caught before release โ€” which is exactly what you would predict from the defect list below.

Open defects โ€” 46 with "windows" in the title

#AreaIssueSeverity
126874CIWindows CI runs 66 of 10,979 test files; a skipped check counts as passingstructural
119882GatewayGateway process exits silently (code 0) with no auto-recoveryhigh
105528Core toolsexec/read tools silently return empty output (v2026.6.x regression)high
122834GatewayRestart path unreliable after active-turn crashhigh
102755StartupThe project won't start on Windows and WSLhigh
124407PerformanceCLI gateway commands take 10โ€“30s due to eager bootstrap before RPCmedium
124125CronDurable fence fails โ€” getFileLockProcessStartTime has no win32 pathmedium
111620PathsWindows file tools misresolve POSIX drive pathsmedium
105667PathsIncorrect sandbox bind-mount parsing for relative drive-letter pathsmedium
114207PathsMisclassifies same-path sandbox binds as aliasesmedium
123176NodeNode exec stops after system.run.prepare; no approval event or UI cardmedium
112051InstallerCannot repair stale Winget Node registrationsmedium
95072Gateway/restart falls back to in-process restart without changing PIDmedium
111595PathsEquivalent Windows cwd spellings split catalog project groupslow

Note the clustering: four separate open bugs on drive letters and path resolution. That is a structural weakness, not four coincidences.

Gotchas if you do run WSL2

Share

๐ŸชŸ How well does OpenClaw run on Windows?

Short answer: use WSL2. It's the only path rated Beta.

๐Ÿ“Š OpenClaw's own maturity scores:
โ€ข Windows via WSL2 โ€” BETA (M3), quality 69
โ€ข Native Windows CLI+Gateway โ€” ALPHA (M2), quality 63
โ€ข Windows companion app โ€” Planned (M0)

โš ๏ธ The reason quality is low: Windows CI runs 66 of 10,979 test files. That's 0.60% of the suite. 23 of the 43 Windows-named test files never even run on Windows, and a SKIPPED Windows job counts as PASSING. Regressions basically can't be caught.

๐Ÿ› 46 open Windows issues, including:
โ€ข Gateway exits silently (code 0), no auto-recovery
โ€ข exec/read silently return EMPTY OUTPUT (regression)
โ€ข CLI gateway commands take 10โ€“30 seconds
โ€ข 4 separate drive-letter/path bugs

โœ… Verdict: WSL2 for anything real. Windows Hub is fine for a desktop app โ€” it sets up a WSL gateway under the hood. Don't put load-bearing work on the native Windows Gateway.

Full details ๐Ÿ‘‰ https://artifact.sahirm.com/a/openclaw-on-windows/

Sources & confidence

Confidence: maturity scores read directly out of docs/maturity-scores.yaml in the locally installed OpenClaw 2026.6.10 โ€” score run dated 2026-05-30. Issue counts and titles queried live from the openclaw/openclaw tracker on 29 Aug 2026 (46 open with "windows" in the title, 200+ closed). Two caveats: the claim that the Hub's M0 rating is stale is my inference from the date gap, not something confirmed upstream; and individual issues were not re-tested against the current release, so some may be fixed but not yet closed.