Getting Started with Clawdbot

New to Clawdbot? This quick start guide will get you up and running in 15 minutes.

Prerequisites

Before you begin, you’ll need:

• Node.js 18+ — Check with node --version
• An LLM API key — Anthropic Claude recommended
• A chat platform — Telegram is the easiest to start

Quick Install

# Install Clawdbot globally
npm install -g clawdbot

# Create a new workspace
mkdir my-assistant && cd my-assistant

# Initialize configuration
clawdbot init

Configure Your LLM

Add your API key to the config:

# clawdbot.yaml
llm:
  provider: anthropic
  model: claude-sonnet-4-20250514
  apiKey: ${ANTHROPIC_API_KEY}

Set your environment variable:

export ANTHROPIC_API_KEY="your-key-here"

Connect Telegram

1. Message @BotFather on Telegram
2. Send /newbot and follow the prompts
3. Copy your bot token
4. Add to config:

channels:
  telegram:
    botToken: ${TELEGRAM_BOT_TOKEN}
    allowedUsers:
      - your_telegram_id

Start Chatting

clawdbot gateway start

Open your Telegram bot and say hello! 🎉

Next Steps

• Complete Setup Guide — Full configuration options
• Telegram Integration — Advanced Telegram features
• Troubleshooting — Common issues and fixes