Environment Variables

All env vars OpenVesper reads. Most have sensible defaults.

Gateway core

VariableDefaultPurpose
OPENVESPER_GATEWAY_HOST127.0.0.1Bind address
OPENVESPER_GATEWAY_PORT18789Bind port
OPENVESPER_AGENTS_DIR./.agentsBundled agents dir
OPENVESPER_CONFIG_DIR~/.openvesperUser config root
OPENVESPER_HEARTBEAT_INTERVAL60000Heartbeat check (ms)
OPENVESPER_MAX_CONCURRENT4Max parallel agent runs
OPENVESPER_SEARCH_PROVIDERduckduckgoWeb search default

LLM providers

VariableFor
ANTHROPIC_API_KEYClaude
OPENAI_API_KEYGPT-4o, o-series
GROQ_API_KEYGroq (fast Llama)
GEMINI_API_KEYGoogle Gemini
MISTRAL_API_KEYMistral
DEEPSEEK_API_KEYDeepSeek
OPENROUTER_API_KEYOpenRouter (multi-provider)
OLLAMA_URLLocal Ollama (default: http://127.0.0.1:11434)

Tool API keys

VariableFor
HELIUS_API_KEYSolana RPC + DAS API
BRAVE_SEARCH_API_KEYBrave web search
TAVILY_API_KEYTavily search
SERPAPI_API_KEYSerpApi search
SEARXNG_URLSelf-hosted SearXNG
COINGECKO_API_KEYCoinGecko Pro (optional)

Channels

VariableFor
TELEGRAM_BOT_TOKENTelegram bot
SLACK_BOT_TOKENSlack bot
DISCORD_WEBHOOK_URLDiscord webhook send
DISCORD_BOT_TOKENDiscord bot send

Workspaces

For running multiple gateways:

  • OPENVESPER_GATEWAY_PORT — per-workspace port
  • OPENVESPER_AGENTS_DIR — per-workspace agents
  • OPENVESPER_CONFIG_DIR — per-workspace config
  • OPENVESPER_PID_FILE — per-workspace PID

See Workspaces for details.