Environment Variables¶

Complete reference for OmniAgent environment variables.

LLM Providers¶

Variable	Description
`OPENAI_API_KEY`	OpenAI API key
`ANTHROPIC_API_KEY`	Anthropic API key
`GEMINI_API_KEY`	Google Gemini API key

Agent Configuration¶

Variable	Description	Default
`OMNIAGENT_AGENT_PROVIDER`	LLM provider: `openai`, `anthropic`, `gemini`	`anthropic`
`OMNIAGENT_AGENT_MODEL`	Model name	`claude-sonnet-4-20250514`
`OMNIAGENT_AGENT_TEMPERATURE`	Sampling temperature	`0.7`
`OMNIAGENT_AGENT_MAX_TOKENS`	Max response tokens	`4096`

Channels¶

WhatsApp¶

Variable	Description	Default
`WHATSAPP_ENABLED`	Enable WhatsApp channel	`false`
`WHATSAPP_DB_PATH`	Session database path	`whatsapp.db`

Telegram¶

Variable	Description
`TELEGRAM_BOT_TOKEN`	Telegram bot token (auto-enables channel)

Discord¶

Variable	Description
`DISCORD_BOT_TOKEN`	Discord bot token (auto-enables channel)

Voice¶

Variable	Description	Default
`DEEPGRAM_API_KEY`	Deepgram API key	-
`ELEVENLABS_API_KEY`	ElevenLabs API key	-
`OMNIAGENT_VOICE_ENABLED`	Enable voice processing	`false`
`OMNIAGENT_VOICE_RESPONSE_MODE`	Response mode: `auto`, `always`, `never`	`auto`

Gateway¶

Variable	Description	Default
`OMNIAGENT_GATEWAY_ADDRESS`	Gateway address	`127.0.0.1:18789`

Usage Examples¶

Minimal Setup (WhatsApp + OpenAI)¶

export OPENAI_API_KEY="sk-..."
export WHATSAPP_ENABLED=true

omniagent gateway run

Full Setup¶

# LLM Provider
export ANTHROPIC_API_KEY="sk-ant-..."
export OMNIAGENT_AGENT_PROVIDER=anthropic
export OMNIAGENT_AGENT_MODEL=claude-sonnet-4-20250514

# WhatsApp
export WHATSAPP_ENABLED=true
export WHATSAPP_DB_PATH=~/.omniagent/whatsapp.db

# Voice
export DEEPGRAM_API_KEY="..."
export OMNIAGENT_VOICE_ENABLED=true
export OMNIAGENT_VOICE_RESPONSE_MODE=auto

# Gateway
export OMNIAGENT_GATEWAY_ADDRESS=0.0.0.0:18789

omniagent gateway run

Using .envrc (direnv)¶

Create a .envrc file in your project directory:

# .envrc
export OPENAI_API_KEY="sk-..."
export ANTHROPIC_API_KEY="sk-ant-..."
export DEEPGRAM_API_KEY="..."

export OMNIAGENT_AGENT_PROVIDER=anthropic
export WHATSAPP_ENABLED=true
export OMNIAGENT_VOICE_ENABLED=true

Then allow it:

direnv allow
omniagent gateway run

Precedence¶

Configuration values are resolved in this order (highest to lowest):

Environment variables
Config file values
Built-in defaults

Example:

# omniagent.yaml
agent:
  provider: openai

# Environment overrides config file
export OMNIAGENT_AGENT_PROVIDER=anthropic
omniagent gateway run  # Uses anthropic