Navigation

Setup

First-Time Setup

camel setup

The setup wizard walks you through:

  1. Choose a mode — TUI only, Telegram only, or both
  2. Pick your AI provider — Anthropic, OpenAI, OpenRouter, Ollama, or custom
  3. Enter your API key
  4. Telegram setup (optional) — create a bot via @BotFather, paste the token, pair your account

Providers

Provider API Key Required Models
Anthropic Yes Claude Sonnet, Opus, Haiku
OpenAI Yes GPT-4o, o1, o3
OpenRouter Yes 100+ models (Grok, Gemini, Llama, etc.)
Ollama No (local) Any local model
Custom Depends Any OpenAI-compatible endpoint

Telegram Setup

  1. Open @BotFather in Telegram
  2. Send /newbot and follow the prompts
  3. Copy the bot token
  4. Paste it during camel setup
  5. Send a message to your bot — it pairs with your account

This creates an admin bot. Use it to create AI agent bots with /newagent.

Start the Server

camel serve

This starts the gateway (HTTP + WebSocket + Telegram bots + cron jobs).

Terminal UI

camel chat

Full terminal interface with streaming, slash commands, model switching, and session management.

Configuration File

All settings are stored in ~/.camelagi/config.yaml. You can edit it directly or use the CLI:

Command Description
camel config list Show all settings
camel config get model Get a specific value
camel config set model claude-sonnet-4-20250514 Set a value