📋 Download Guide
⚡ Quick Download
ClawdBot is distributed via npm (Node Package Manager). Choose your installation method:
NPM (Recommended)
npm install -g clawdbot@latest
Easiest method, automatic updates
GitHub Source
git clone https://github.com/steipete/ClawdBot.git
For developers, latest features
Docker
docker pull clawdbot/clawdbot
Containerized deployment
💻 Platform-Specific Downloads
macOS
Requirements
- macOS 12 (Monterey) or later
- Apple Silicon (M1/M2/M3) or Intel
- Node.js 22+ (install via Homebrew)
Installation
# Install Node.js via Homebrew
brew install node
# Install ClawdBot
npm install -g clawdbot@latest
# Verify installation
clawdbot --version
Windows
Requirements
- Windows 10/11 (64-bit)
- WSL2 (Windows Subsystem for Linux)
- Node.js 22+
Installation
# Install WSL2 (PowerShell as Admin)
wsl --install
# Inside WSL2 Ubuntu:
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs
# Install ClawdBot
npm install -g clawdbot@latest
Linux
Requirements
- Ubuntu 20.04+, Debian 11+, or equivalent
- Node.js 22+
- systemd (for service management)
Installation
# Ubuntu/Debian
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs
# Install ClawdBot
npm install -g clawdbot@latest
# Set up as service (optional)
clawdbot service install
Docker
Requirements
- Docker 20.10+
- Docker Compose (optional)
Quick Start
# Pull image
docker pull clawdbot/clawdbot:latest
# Run container
docker run -d \
--name clawdbot \
-v ~/.clawdbot:/root/.clawdbot \
-p 3000:3000 \
clawdbot/clawdbot:latest
📋 System Requirements
Minimum Requirements
| Component | Minimum | Recommended |
|---|---|---|
| CPU | 2 cores | 4+ cores |
| RAM | 4GB | 8GB+ |
| Storage | 2GB free | 10GB+ free |
| Node.js | v22.0.0 | Latest LTS |
| Internet | Required for API | Broadband |
For Local AI Models (Ollama)
| Model Size | RAM Required | Recommended Hardware |
|---|---|---|
| 7-8B models | 8GB | M1 Mac, 16GB RAM PC |
| 13B models | 16GB | M2 Pro, 32GB RAM PC |
| 70B models | 48GB+ | Mac Studio, High-end workstation |
See detailed requirements: System Requirements Guide
🔧 Installation Methods Compared
| Method | Difficulty | Best For | Pros | Cons |
|---|---|---|---|---|
| NPM Global | Easy | Most users | Simple, auto-updates | Requires Node.js |
| GitHub Clone | Medium | Developers | Latest features, customizable | Manual updates |
| Docker | Medium | Servers, isolation | Clean, portable | Overhead, complexity |
| Cloud Deploy | Hard | 24/7 availability | Always-on, accessible | Monthly cost |
Recommended Installation Path
- Install Node.js - Download from nodejs.org or use package manager
- Install ClawdBot - Run
npm install -g clawdbot@latest - Run Onboarding - Execute
clawdbot onboard - Configure API Keys - Add your Claude/GPT-4 keys
- Connect Messaging - Link Telegram, WhatsApp, etc.
- Start Gateway - Run
clawdbot start
Detailed walkthrough: Complete Installation Guide
🚀 After Installation
1. Initial Configuration
# Run the interactive setup wizard
clawdbot onboard
# This will guide you through:
# - Choosing AI provider (Claude, GPT-4, Gemini, Ollama)
# - Adding API keys
# - Selecting messaging platforms
# - Configuring preferences
2. Connect Messaging Platforms
- Connect Telegram - Most popular, easiest setup
- Connect WhatsApp - QR code pairing
- Connect Discord - Great for communities
3. Choose Your AI Model
- Set up Claude - Best for coding
- Compare AI Models - Find the right fit
- Understand Costs - Budget planning
4. Learn to Use ClawdBot
- User Guide - Complete tutorial
- Install Skills - Extend functionality
- Browser Automation - Advanced features
❓ Download FAQ
Do I need to create an account to download ClawdBot?
No! ClawdBot is open-source. Just install via npm or download from GitHub.
No registration required.
Is ClawdBot available on the App Store or Microsoft Store?
No, ClawdBot is distributed via npm (Node.js package manager). This gives
you the latest version and easier updates.
Can I install ClawdBot without Node.js?
Node.js is required for ClawdBot to run. However, you can use the Docker
version which includes all dependencies.
How do I update ClawdBot to the latest version?
Run
npm update -g clawdbot to get the latest version. Check
releases at GitHub.Can I run ClawdBot on a Raspberry Pi?
Technically yes, but it's not recommended due to performance constraints. A
Mac Mini or old laptop works much better.
Is there a portable version?
ClawdBot runs as a Node.js application, so it's inherently portable. You can
copy the installation folder to any compatible system.
What's the download size?
The npm package is ~50MB. With dependencies, total installation is around
200-300MB.