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)

Getting Started (use inside WSL)
Install & updates
Official WSL2 guide (Microsoft): https://learn.microsoft.com/windows/wsl/install

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.

1.9 KiB Raw Blame History