Skip to content
OwliaBot

Quick Start

Prerequisites

Section titled “Prerequisites”
  • Node.js 22 or later
  • A Telegram Bot token (from @BotFather)
  • An AI provider API key (Anthropic, OpenAI, etc.)

Installation

Section titled “Installation”
Terminal window
# Clone the repository
git clone https://github.com/owliabot/owliabot.git
cd owliabot


# Install dependencies
npm install


# Copy example config
cp config.example.yaml config.yaml

Configuration

Section titled “Configuration”

Edit config.yaml:

providers:
  - id: claude
    model: claude-sonnet-4-5
    apiKey: "your-anthropic-api-key"


telegram:
  token: "your-telegram-bot-token"
  allowList:
    - "your-telegram-user-id"


workspace: ./workspace

First Run

Section titled “First Run”
Terminal window
npm run dev

Send a message to your Telegram bot. You should get a response!

Testing Skills

Section titled “Testing Skills”

OwliaBot comes with built-in skills. Try:

What's the current price of bitcoin?

The crypto-price skill will fetch the price from CoinGecko.

Next Steps

Section titled “Next Steps”