ClawdBot for Windows

💻 System Requirements

🐧 WSL2 Setup (Recommended Method)

Why WSL2? ClawdBot runs best in a Linux environment. WSL2 provides native Linux on Windows.

Step 1: Enable WSL2

# Open PowerShell as Administrator
wsl --install

# Restart your computer when prompted

Step 2: Install Ubuntu

# After restart, install Ubuntu
wsl --install -d Ubuntu-22.04

# Create username and password when prompted

Step 3: Update Ubuntu

# Inside WSL2 Ubuntu terminal
sudo apt update && sudo apt upgrade -y

Step 4: Install Node.js

# Install Node.js 22
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs

# Verify installation
node --version
npm --version

Step 5: Install ClawdBot

npm install -g clawdbot@latest

# Run onboarding
clawdbot onboard

🚀 Complete Installation Guide

Method 1: WSL2 + Ubuntu (Best)

1. Install WSL2 (see above)
2. Install Node.js in Ubuntu
3. Install ClawdBot via npm
4. Configure and start

Method 2: Docker Desktop

# Install Docker Desktop for Windows
# Download from docker.com

# Pull ClawdBot image
docker pull clawdbot/clawdbot:latest

# Run container
docker run -d --name clawdbot -p 3000:3000 clawdbot/clawdbot

See: Docker Installation Guide

🪟 Native Windows Installation

Note: Native Windows support is experimental. WSL2 is strongly recommended.

Step 1: Install Node.js

Download from nodejs.org (Windows Installer)

Step 2: Install ClawdBot

# In PowerShell
npm install -g clawdbot@latest

Step 3: Configure

clawdbot onboard

Known Limitations

• ⚠️ Some features may not work (browser automation)
• ⚠️ Performance may be slower
• ⚠️ Path issues with Windows file system

🔧 Troubleshooting

WSL2 Not Installing

# Enable required Windows features
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

# Restart and try again

Permission Errors

# Run PowerShell as Administrator
# Or in WSL2, use sudo

Port Already in Use

# Find process using port
netstat -ano | findstr :3000

# Kill process
taskkill /PID [PID] /F

❓ Windows FAQ