OpenClaw Setup on Windows with WSL2: Full Walkthrough

OpenClaw setup on Windows with WSL2 is the officially recommended path for Windows users. OpenClaw is a Linux-native application, and WSL2 (Windows Subsystem for Linux 2) provides a genuine Linux kernel running inside Windows — giving you full compatibility with OpenClaw's dependencies while staying in your familiar Windows environment. This walkthrough covers everything from enabling WSL2 to your first agent message.

Why WSL2 and Not Native Windows?

OpenClaw's skill system and some core components rely on Unix process primitives that aren't available natively on Windows. Previous attempts to run OpenClaw natively on Windows via MSYS2 or Cygwin produced intermittent stability issues. WSL2 eliminates these entirely because it's a real Linux environment.

Step 1: Enable WSL2

Open PowerShell as Administrator and run:

wsl --install

This installs WSL2 with Ubuntu by default. Your system will restart. After restart, Ubuntu launches automatically and prompts you to create a Unix username and password.

If you already have WSL1 installed, upgrade to WSL2:

wsl --set-default-version 2
wsl --set-version Ubuntu 2

Step 2: Update Ubuntu

Inside the Ubuntu terminal:

sudo apt update && sudo apt upgrade -y
sudo apt install python3.12 python3.12-venv python3-pip git curl -y

Step 3: Install OpenClaw

git clone https://github.com/openclaw/openclaw.git
cd openclaw
python3.12 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

Step 4: Run the Onboarding Wizard

python -m openclaw onboard

The wizard asks for your LLM API key, channel preferences, and skill selections. Complete it, then test with:

python -m openclaw start

Step 5: Access OpenClaw from Windows

Your OpenClaw data lives in the WSL2 filesystem at \\wsl$\\Ubuntu\\home\\<username>\\.openclaw\\. You can browse it in Windows Explorer by typing \\wsl$ in the address bar.

Keeping OpenClaw Running

To run OpenClaw whenever your Windows PC is on, create a WSL startup script. In Windows Task Scheduler, create a task that runs at login:

wsl -d Ubuntu -e bash -c "cd ~/openclaw && source venv/bin/activate && python -m openclaw start"

For true 24/7 operation independent of your PC, use nacre.sh's managed hosting instead.

Common WSL2 Issues

Port forwarding: If you need to access OpenClaw's web interface from Windows, WSL2 automatically forwards ports — visit localhost:8080 in your Windows browser if OpenClaw is running on port 8080 in WSL2.

Slow file I/O: Keep your OpenClaw directory inside the WSL2 filesystem (under ~), not on your Windows drive (under /mnt/c). Cross-filesystem I/O is significantly slower.

Frequently Asked Questions

Does OpenClaw work on Windows 11 ARM?

Yes, with WSL2. Windows 11 ARM with WSL2 using Ubuntu ARM64 is supported and performs well on Snapdragon X Elite devices.

Can I run OpenClaw in Windows Terminal?

Yes. Windows Terminal supports multiple WSL2 panes simultaneously, making it an excellent environment for monitoring OpenClaw logs while running commands in a separate pane.

What about Windows Defender blocking OpenClaw?

Windows Defender may flag OpenClaw's process spawning behavior. Add your OpenClaw directory to Defender's exclusion list to prevent interference.