Skip to main content

​
Windows (WSL2)

Clawdbot on Windows is recommended via WSL2 (Ubuntu recommended). The CLI + Gateway run inside Linux, which keeps the runtime consistent. Native Windows installs are untested and more problematic. Native Windows companion apps are planned.

​
Install (WSL2)

​
Gateway

​
Gateway service install (CLI)

Inside WSL2: 
clawdbot onboard --install-daemon
Or: 
clawdbot daemon install
Or: 
clawdbot configure
Select Gateway daemon when prompted. Repair/migrate: 
clawdbot doctor

​
Step-by-step WSL2 install

​
1) Install WSL2 + Ubuntu

Open PowerShell (Admin): 
wsl --install
# Or pick a distro explicitly:
wsl --list --online
wsl --install -d Ubuntu-24.04
Reboot if Windows asks.

​
2) Enable systemd (required for daemon install)

In your WSL terminal: 
sudo tee /etc/wsl.conf >/dev/null <<'EOF'
[boot]
systemd=true
EOF
Then from PowerShell: 
wsl --shutdown
Re-open Ubuntu, then verify: 
systemctl --user status

​
3) Install Clawdbot (inside WSL)

Follow the Linux Getting Started flow inside WSL: 
git clone https://github.com/clawdbot/clawdbot.git
cd clawdbot
pnpm install
pnpm ui:install
pnpm ui:build
pnpm build
pnpm clawdbot onboard
Full guide: Getting Started

​
Windows companion app

We do not have a Windows companion app yet. Contributions are welcome if you want contributions to make it happen.