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)

Twilio SMS¶

Variable	Description	Default
`TWILIO_ACCOUNT_SID`	Twilio Account SID (auto-enables channel)	-
`TWILIO_AUTH_TOKEN`	Twilio Auth Token	-
`TWILIO_PHONE_NUMBER`	Twilio phone number in E.164 format	-
`TWILIO_WEBHOOK_PATH`	SMS webhook path	`/webhook/twilio/sms`

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 listen address	`127.0.0.1:18789`

Address Format¶

The gateway address must include a colon and port number:

# Valid formats
OMNIAGENT_GATEWAY_ADDRESS=":8080"           # All interfaces, port 8080
OMNIAGENT_GATEWAY_ADDRESS="127.0.0.1:8080"  # Localhost only
OMNIAGENT_GATEWAY_ADDRESS="0.0.0.0:8080"    # All interfaces (explicit)

# Invalid (missing colon)
OMNIAGENT_GATEWAY_ADDRESS="8080"            # Won't work

Usage Examples¶

Minimal Setup (WhatsApp + OpenAI)¶

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

omniagent gateway run

Twilio SMS Setup¶

# LLM Provider
export OPENAI_API_KEY="sk-..."

# Twilio SMS
export TWILIO_ACCOUNT_SID="AC..."
export TWILIO_AUTH_TOKEN="..."
export TWILIO_PHONE_NUMBER="+15551234567"

# Gateway (for ngrok)
export OMNIAGENT_GATEWAY_ADDRESS=":8080"

omniagent gateway run

Configure your Twilio phone number webhook to point to: https://<your-domain>/webhook/twilio/sms (POST)

For local development, use ngrok:

ngrok http 8080
# Then configure Twilio webhook to: https://<ngrok-subdomain>.ngrok.io/webhook/twilio/sms

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

# Twilio SMS
export TWILIO_ACCOUNT_SID="AC..."
export TWILIO_AUTH_TOKEN="..."
export TWILIO_PHONE_NUMBER="+15551234567"

# 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="..."

# Twilio SMS
export TWILIO_ACCOUNT_SID="AC..."
export TWILIO_AUTH_TOKEN="..."
export TWILIO_PHONE_NUMBER="+15551234567"

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