This page lists environment variables that are read by current source code and are useful for operators or integrations. Build-time, test-only, and parent-process-injected variables are intentionally excluded from this public reference.
| Variable | Purpose | Default |
|---|
OPENCORVUS_HOME | Absolute canonical root for every OpenCorvus-owned directory: bin, cache, config, data, log, state, temporary files, and Overlay/WebView data. | %LOCALAPPDATA%/opencorvus on Windows; Application Support on macOS; XDG data home on other platforms |
OPENCORVUS_CONFIG | Load one explicit config file after global config. | unset |
OPENCORVUS_CONFIG_DIR | Load a local OpenCorvus config directory. | unset |
OPENCORVUS_CONFIG_CONTENT | Inline JSON config content, commonly injected by channel runtimes or containers. | unset |
OPENCORVUS_DISABLE_PROJECT_CONFIG | Disable project config discovery. | false |
OPENCORVUS_PROJECT_DIR | Default project directory for serve and benchmark helpers. | current working directory |
| Variable | Purpose | Default |
|---|
OPENCORVUS_CHANNEL | Installation/channel label used in the user agent. | local |
OPENCORVUS_CLIENT | Client label used in runtime behavior and provider headers. | cli |
OPENCORVUS_SERVER_USERNAME | HTTP Basic Auth username. | opencorvus |
OPENCORVUS_SERVER_PASSWORD | HTTP Basic Auth password for public servers. | unset |
OPENCORVUS_SERVER_URL | Server URL exported by server and sidecar entrypoints. | set by the process that starts the server |
OPENCORVUS_PUBLIC_URL | Public URL used when publishing channel attachments. | unset |
OPENCORVUS_PUBLIC_URL_SECRET | Secret used with public attachment URLs. | unset |
| Variable | Purpose | Default |
|---|
OPENCORVUS_EXPERIMENTAL_BASH_DEFAULT_TIMEOUT_MS | Default inactivity timeout for bash tool calls. | tool default |
OPENCORVUS_RUN_STALL_TIMEOUT_MS | Inactivity timeout for opencorvus run. | runtime default |
OPENCORVUS_BROWSER_LAUNCH_TIMEOUT_MS | Browser launch timeout. | runtime default |
OPENCORVUS_QUESTION_TIMEOUT_MS | Reject timeout for unanswered question interactions. | 300000 |
| Variable | Purpose |
|---|
OPENCORVUS_DISABLE_AUTOUPDATE=1 | Disable auto-update. |
OPENCORVUS_DISABLE_PRUNE=1 | Disable compaction pruning. |
OPENCORVUS_DISABLE_AUTOCOMPACT=1 | Disable automatic compaction. |
OPENCORVUS_DISABLE_TERMINAL_TITLE=1 | Disable terminal title changes. |
OPENCORVUS_DISABLE_LSP_DOWNLOAD=1 | Disable language-server downloads. |
OPENCORVUS_DISABLE_CLAUDE_CODE=1 | Disable Claude Code integration. |
OPENCORVUS_DISABLE_CLAUDE_CODE_PROMPT=1 | Disable Claude Code prompt discovery. |
OPENCORVUS_DISABLE_CLAUDE_CODE_SKILLS=1 | Disable Claude Code skill discovery. |
OPENCORVUS_DISABLE_EXTERNAL_SKILLS=1 | Disable external skill discovery. |
OPENCORVUS_ENABLE_QUESTION_TOOL=1 | Enable the question tool for non-interactive clients. |
OPENCORVUS_ENABLE_EXPERIMENTAL_MODELS=1 | Include alpha models from the model catalog. |
OPENCORVUS_ENABLE_EXA=1 | Enable Exa-backed web search when configured. |
| Variable | Purpose |
|---|
OPENCORVUS_MODELS_URL | Override the models.dev catalog URL. |
OPENCORVUS_MODELS_PATH | Read the model catalog from a local JSON file. |
OPENCORVUS_VISION_MODEL | Vision model for channel-runtime visual analysis. |
OPENCORVUS_BENCHMARK_MODEL | Explicit model used by benchmark scripts. |
ANTHROPIC_API_KEY | Anthropic provider API key. |
OPENAI_API_KEY | OpenAI provider API key. |
GOOGLE_GENERATIVE_AI_API_KEY | Google AI provider API key. |
DEEPSEEK_API_KEY | DeepSeek provider API key. |
OPENROUTER_API_KEY | OpenRouter provider API key. |
DASHSCOPE_API_KEY | DashScope key shared by DashScope providers. |
ALIBABA_CODING_PLAN_API_KEY | DashScope Coding Plan provider key. |
MCP means Model Context Protocol.
| Variable | Purpose |
|---|
OPENCORVUS_BROWSER_EXECUTABLE | Browser executable path. |
OPENCORVUS_BROWSER_LAUNCH_ARGS | JSON array of browser launch args for browser preview. |
OPENCORVUS_BROWSER_MCP_SOURCE_PACKAGE_DIR | Source package directory for Browser MCP. |
OPENCORVUS_BROWSER_MCP_PACKAGED=1 | Mark Browser MCP as packaged. |
OPENCORVUS_BROWSER_MCP_NODE | Node executable used by Browser MCP sidecar. |
STT means speech-to-text.
| Variable | Purpose |
|---|
OPENCORVUS_CHANNEL_SERVER_URL | Backend URL used by channel runtime. |
OPENCORVUS_CHANNEL_PERMISSION_PROFILE | Channel permission profile. |
OPENCORVUS_CHANNEL_PROTOCOL=1 | Enable channel protocol mode for supported platforms. |
OPENCORVUS_SHARED_SESSION_MODE=1 | Enable shared session mode. |
OPENCORVUS_SHARED_SESSION_FILE | Shared session file path. |
OPENCORVUS_MIRROR_STDOUT=1 | Mirror channel-runtime stdout upstream. |
OPENCORVUS_MONITOR_DIFF_THRESHOLD | Visual monitor difference threshold. |
STT_PROVIDER | Single speech-to-text provider. |
STT_LANGUAGE | Speech recognition language. |
GROQ_API_KEY | Groq speech-to-text key. |
STT_GROQ_MODEL / STT_GROQ_BASE_URL | Groq speech-to-text model and base URL. |
STT_OPENAI_MODEL / STT_OPENAI_BASE_URL | OpenAI Whisper model and base URL. |
DEEPGRAM_API_KEY | Deepgram key. |
STT_DEEPGRAM_MODEL / STT_DEEPGRAM_BASE_URL | Deepgram model and base URL. |
GOOGLE_API_KEY | Google Gemini speech-to-text key. |
STT_GOOGLE_MODEL / STT_GOOGLE_BASE_URL | Google Gemini speech-to-text model and base URL. |
STT_LOCAL_COMMAND | Local speech-to-text command. |
