Windows Setup

Overview

Clawdbot runs on Windows 10/11 with full feature support (except iMessage).

Requirements

• Windows 10 or 11
• Python 3.10+
• Git for Windows

Installation

1. Install Python

   Download from python.org

   • ✅ Check “Add Python to PATH”
   • ✅ Check “Install pip”

2. Install Git

   Download from git-scm.com

3. Clone Clawdbot

   Open PowerShell:

   git clone https://github.com/clawdbot/clawdbot.git
   cd clawdbot

4. Create virtual environment

   python -m venv venv
   .\venv\Scripts\Activate.ps1

5. Install dependencies

   pip install -r requirements.txt

6. Configure

   copy .env.example .env
   notepad .env

Running Clawdbot

Manual Start

.\venv\Scripts\Activate.ps1
python -m clawdbot

As a Windows Service

Using NSSM (Non-Sucking Service Manager):

1. Download NSSM from nssm.cc

2. Install service:

   nssm install Clawdbot

3. Configure:

   • Path: C:\path\to\clawdbot\venv\Scripts\python.exe
   • Arguments: -m clawdbot
   • Startup directory: C:\path\to\clawdbot

4. Start service:

   nssm start Clawdbot

Using Task Scheduler

1. Open Task Scheduler
2. Create Basic Task
3. Trigger: “At startup”
4. Action: Start a program
   • Program: C:\path\to\clawdbot\venv\Scripts\python.exe
   • Arguments: -m clawdbot
   • Start in: C:\path\to\clawdbot

Troubleshooting

Execution Policy Error

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

pip install fails

• Install Visual C++ Build Tools
• Try: pip install --upgrade pip

Python not found

• Reinstall Python with “Add to PATH” checked
• Or add manually to System Environment Variables

Next Steps

• Docker Deployment
• Channel Setup