Skip to content
Clawdbot Guide

Quick Start Guide

5-Minute Quick Start

Section titled “5-Minute Quick Start”

This guide will have you chatting with Clawdbot in under 5 minutes.

Prerequisites

Section titled “Prerequisites”
  • Python 3.10+ installed
  • An Anthropic API key
  • A Telegram account

  1. Clone and setup

    Terminal window
    git clone https://github.com/polvoazul/clawdbot.git
    cd clawdbot
    python3 -m venv venv
    source venv/bin/activate  # Windows: .\venv\Scripts\activate
    pip install -r requirements.txt

  2. Get a Telegram Bot Token

    • Open Telegram and search for @BotFather
    • Send /newbot and follow the prompts
    • Copy the bot token provided

  3. Configure environment

    Terminal window
    cp .env.example .env

    Edit .env and add:

    Terminal window
    ANTHROPIC_API_KEY=sk-ant-your-key-here
    TELEGRAM_BOT_TOKEN=your-telegram-bot-token

  4. Start Clawdbot

    Terminal window
    python -m clawdbot

  5. Chat with your bot

    • Open Telegram
    • Find your bot by the username you created
    • Send a message and get a response!

Verify It’s Working

Section titled “Verify It’s Working”

You should see output like:

[INFO] Clawdbot starting...
[INFO] Loading channel: telegram
[INFO] Telegram bot connected: @YourBotName
[INFO] Ready to receive messages

Try sending:

  • “Hello, who are you?”
  • “What’s the weather like?” (Claude will explain it can’t check weather)
  • “Help me write a Python function”

Next Steps

Section titled “Next Steps”

Now that Clawdbot is running:

Common Issues

Section titled “Common Issues”

Bot not responding?

  • Check the bot token is correct
  • Ensure you’ve started the bot in Telegram (send /start)
  • Verify your Anthropic API key has credits

Connection errors?

  • Check your internet connection
  • Verify firewall isn’t blocking outbound connections
  • Try running with LOG_LEVEL=DEBUG for more info

Need help?