Work in Progress: This guide is being actively developed. Some information may change.

Quickstart Guide

Get ClawdBot running in a few steps

Prerequisite: Node.js 22+ required. Download here if needed. Windows users: use WSL2 for best results.

Install ClawdBot

macOS / Linux / WSL2
curl -fsSL https://clawd.bot/install.sh | bash
Windows PowerShell
iwr -useb https://clawd.bot/install.ps1 | iex

Get an API Key

ClawdBot needs an AI brain. Get a free API key from Anthropic (recommended) or OpenAI.

Run Setup Wizard

clawdbot onboard --install-daemon

Follow the prompts to enter your API key and choose chat apps.

Connect WhatsApp

clawdbot channels login

Scan the QR code with WhatsApp on your phone:

  • Open WhatsApp → Settings → Linked Devices
  • Tap "Link a Device"
  • Scan the terminal QR code

Start Chatting!

Send yourself a WhatsApp message:

You

What can you help me with?

ClawdBot

I can help you manage emails, schedule meetings, browse the web, control smart home devices, run commands, and much more. What would you like to do?

Quick Reference

# Check status
clawdbot status --all

# View dashboard
open http://127.0.0.1:18789/

# Approve new contacts
clawdbot pairing list whatsapp
clawdbot pairing approve whatsapp <code>

# Restart gateway
clawdbot gateway restart

Next Steps

⚙️

Full Setup Guide

Add Telegram, Discord, configure settings
💬

Example Conversations

See what ClawdBot can do
✨

All Features

Explore full capabilities