📦 Installation Guide
Install Clawdbot
Choose your platform and follow our step-by-step guide to get Clawdbot running on your machine or server.
Choose Your Platform
🍎
macOS
Native installation for Mac users with Homebrew support.
Difficulty: EasyTime: 5 min
🪟
Windows
Install on Windows with WSL2 or native support.
Difficulty: MediumTime: 10 min
🐧
Linux
Install on Ubuntu, Debian, Fedora, and other distributions.
Difficulty: EasyTime: 5 min
🐳
RecommendedDocker
The recommended way to run Clawdbot in containers.
Difficulty: EasyTime: 3 min
☁️
VPS / Cloud
Deploy on a VPS for 24/7 availability.
Difficulty: MediumTime: 15 min
System Requirements
Minimum Requirements
- RAM1GB minimum, 2GB recommended
- Storage1GB minimum for application
- Node.js18.0 or later
- DockerOptional but recommended
- InternetRequired for AI API access
API Keys Needed
- ✓
AI Provider API Key
Claude (Anthropic), GPT (OpenAI), or other providers
- ✓
Messaging Platform Token
Telegram Bot Token, Discord Bot Token, etc.
Quick Start with Docker
The fastest way to get Clawdbot running is with Docker. Just copy these commands:
1
Clone the repository
Get the latest code from GitHub
2
Configure environment
Add your API keys to .env file
3
Start with Docker Compose
Run the container and start chatting
terminal
# Clone repository
git clone https://github.com/clawdbot/clawdbot
cd clawdbot
# Configure
cp .env.example .env
nano .env # Add your API keys
# Start
docker compose up -d
Need Help?
Having trouble with installation? Check our troubleshooting guides or join the community.