Clawdbot on Windows
Run Clawdbot on Windows using WSL2 (recommended) or native installation. Follow this guide to get started.
System Requirements
Windows
10 (1903+) or Windows 11
RAM
4GB minimum (8GB recommended)
Storage
2GB free space
WSL2
Recommended for best experience
Choose Your Installation Method
WSL2 provides the best experience for running Clawdbot on Windows, with full Linux compatibility.
Step 1: Enable WSL2
Open PowerShell as Administrator and run:
wsl --install
Restart your computer when prompted.
Step 2: Install Ubuntu
After restart, Ubuntu will install automatically. Set your username and password.
Step 3: Install Node.js in WSL
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs
Step 4: Clone and Setup Clawdbot
git clone https://github.com/clawdbot/clawdbot.git
cd clawdbot
npm install
cp .env.example .env
nano .env # Add your API keys
Step 5: Start Clawdbot
npm start
Docker Desktop provides an easy containerized environment for running Clawdbot.
Step 1: Install Docker Desktop
Download and install Docker Desktop for Windows:
Download Docker Desktop →Enable WSL2 backend during installation for best performance.
Step 2: Clone and Run
Open PowerShell or Windows Terminal:
git clone https://github.com/clawdbot/clawdbot.git
cd clawdbot
copy .env.example .env
# Edit .env with Notepad or VS Code
docker compose up -d
Run Clawdbot directly on Windows without WSL. Some features may have limited compatibility.
Step 1: Install Node.js
Download and install Node.js LTS from the official website:
Download Node.js →Step 3: Clone and Setup
Open Command Prompt or PowerShell:
git clone https://github.com/clawdbot/clawdbot.git
cd clawdbot
npm install
copy .env.example .env
notepad .env
npm start
Getting Your API Keys
Sign up at console.anthropic.com and create an API key in your dashboard.
Get Claude API Key →Message @BotFather on Telegram, use /newbot command, and copy your token.
Open BotFather →Troubleshooting
Make sure virtualization is enabled in your BIOS settings. You may also need to enable the "Virtual Machine Platform" and "Windows Subsystem for Linux" features in Windows.
Ensure Hyper-V or WSL2 is properly configured. In Docker Desktop settings, make sure "Use WSL 2 based engine" is enabled.
Restart your terminal after installing Node.js. If still not working, ensure Node.js is added to your PATH environment variable.