telegram

Telegram Agent Example

TypeScript Telegram bot using elizaOS with the full message pipeline (providers -> LLM -> actions -> ALWAYS_AFTER hook actions).

Quick Start

export TELEGRAM_BOT_TOKEN="your-token"
export OPENAI_API_KEY="your-key"
# Optional: export POSTGRES_URL="postgresql://..."

cd packages/examples/telegram
bun install
bun run start

How It Works

The telegramPlugin auto-integrates with the runtime. Include it and messages flow through the full pipeline automatically.

Message Pipeline

Message → Providers → LLM → Actions → Response
          (character,   (generate   (reply,
           entities,     response)   ignore,
           history)                  custom)

Configuration

The character defines personality, system prompt, and settings:

const character = {
  name: "TelegramEliza",
  bio: "A helpful AI assistant.",
  system: "Be friendly and concise...",
  settings: { model: "gpt-5-mini" },
  secrets: { TELEGRAM_BOT_TOKEN: "...", OPENAI_API_KEY: "..." },
};

Env Variables

Variable	Required	Description
TELEGRAM_BOT_TOKEN	Yes	From @BotFather
OPENAI_API_KEY	Yes	OpenAI API key
POSTGRES_URL	No	PostgreSQL URL (defaults to PGLite)

Validate

bun run test
bun run typecheck

The test suite validates required environment checks and character wiring without connecting to Telegram.