Subs -30% SUB30
How to Install OpenClaw on Windows: 3 Methods Compared (2026)
$ ./blog/guides
Guides

How to Install OpenClaw on Windows: 3 Methods Compared (2026)

ClawHosters
ClawHosters by Daniel Samer
5 min read

If you searched "install OpenClaw on Windows" recently, you probably saw some sketchy results. Fake GitHub installers, Bing AI recommending malware, the whole mess. This is the actual guide, with three real methods and honest trade-offs for each.

Quick Comparison

Method Setup Time Reliability Best For
Docker Desktop 15-20 min High Most users, clean isolation
WSL2 + npm 20-30 min High Developers who want to tinker
Native PowerShell 15-25 min Low Quick testing only

Method 1: Docker Desktop (Recommended)

This is probably the safest bet for most people. Docker wraps OpenClaw in a container, so it can't mess with your Windows install and you get a clean environment every time.

Requirements:

  • Windows 10 Pro/Enterprise build 19045+ or Windows 11

  • 8 GB RAM minimum (16 GB recommended)

  • Docker Desktop with WSL2 backend enabled

Once Docker Desktop is running, pull the official image and create a docker-compose.yaml:

services:
  openclaw:
    image: openclaw/openclaw:latest
    ports:
      - "3000:3000"
    volumes:
      - openclaw_data:/app/data
    restart: unless-stopped
volumes:
  openclaw_data:

Run docker compose up -d and open http://localhost:3000. That's it.

The container handles Node.js, dependencies, all of it. Updates are just docker compose pull && docker compose up -d. If something breaks, delete the container and start fresh. Your data lives in the volume.

Method 2: WSL2 + npm (Developer Setup)

If you want to run OpenClaw natively inside Linux on Windows, WSL2 is the way. Install it from PowerShell:

wsl --install -d Ubuntu-24.04

Reboot, launch Ubuntu, then install Node.js 22+ and OpenClaw:

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs
npm install -g @openclaw/cli
openclaw start

The one thing that will bite you: store your project files inside the WSL filesystem (~/projects/), not on /mnt/c/. The 9P protocol that bridges Windows and WSL adds 5 to 10x file system overhead. I've seen installs that took 4 minutes on /mnt/c/ finish in 30 seconds on ~/. It makes a real difference.

You might also hit npm global permission errors. Fix that with a custom prefix:

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

WSL2 gives you the full Linux experience with native performance. If you're already comfortable with terminals, this is probably your best option for OpenClaw Windows setup.

Method 3: Native npm on PowerShell (Limited)

The fastest path, but with real limitations. Install Node.js 22+ for Windows, then:

npm install -g @openclaw/cli
openclaw start

Sounds simple. And for quick testing, it works fine.

But. Docker-based plugins won't run. Some MCP servers expect Unix paths. And you'll likely hit the spawn npm ENOENT error because Windows resolves npm as npm.cmd, not npm. The fix is setting the npm path explicitly in your OpenClaw config.

I honestly wouldn't recommend this for anything beyond a quick test. If you're going to self-host an AI agent on Windows for real, use Docker or WSL2.

Security: Avoid Fake Installers

This matters more than the install method you choose.

In February 2026, security researchers documented a GhostSocks malware campaign that used fake "openclaw-installer" repositories on GitHub. The fake org looked legitimate. Bing AI briefly promoted it in search results. People downloaded SOCKS5 proxy malware thinking they were getting OpenClaw.

Only download OpenClaw from these sources:

If you're running a native install (not Docker), also check your version. CVE-2026-22176 and CVE-2026-31994 affected versions before 2026.2.25. Both are path traversal vulnerabilities. Upgrade to 2026.2.25+ immediately if you haven't already. For a deeper look at hardening your OpenClaw instance, we covered that separately.

Skip the Setup Entirely

If Docker Desktop, WSL2 configuration, and Windows firewall rules sound like more than you want to deal with, ClawHosters deploys OpenClaw in 60 seconds from any browser. No local install, automatic security updates, and your agent stays online even when your laptop sleeps. You can compare self-hosted vs managed costs to see what makes sense for your situation.

Frequently Asked Questions

Yes. Use WSL2 with npm for a full Linux environment, or install natively via PowerShell with Node.js 22+. The native approach has limitations with Docker-based plugins and some MCP servers, but it works for basic setups and quick testing.

8 GB RAM for Docker Desktop (16 GB recommended), about 2 GB of free disk space, and Windows 10 build 19045 or later. WSL2 adds roughly 1 GB overhead on top of what OpenClaw itself needs. Any modern CPU from the last five years should handle it fine.

There is no official "Windows installer." OpenClaw installs via npm, Docker, or WSL2. If you find an .exe installer claiming to be OpenClaw, it's probably malware. The GhostSocks campaign in February 2026 used exactly this trick. Stick to the official sources listed above.

Docker Desktop now supports Windows 10 Home with WSL2 backend (build 19045+). So yes, all three methods work on Home edition. You no longer need Pro or Enterprise for Docker. The WSL2 and native npm methods work on any Windows 10 build that supports WSL2.

We wrote a detailed breakdown of API token costs and how to reduce them. Short version: your LLM provider costs (OpenAI, Anthropic) usually dwarf the hosting cost itself, regardless of whether you self-host or use managed hosting.
*Last updated: May 2026*

Sources

  1. 1 Docker Desktop
  2. 2 Node.js 22+
  3. 3 security researchers documented
  4. 4 openclaw.ai
  5. 5 github.com/openclaw/openclaw
  6. 6 hardening your OpenClaw instance
  7. 7 ClawHosters deploys OpenClaw in 60 seconds
  8. 8 compare self-hosted vs managed costs
  9. 9 API token costs and how to reduce them