.env.example

# ZeroClaw Environment Variables — V0.8.0
#
# Copy this file to `.env` and fill in your local values.
# Never commit `.env` or any real secrets.
#
# Single override surface: `ZEROCLAW_<dotted_path_with_double_underscores>=<value>`
# The tail mirrors the TOML config path 1:1. `__` (double underscore) is the
# path separator (`.` in TOML); single `_` is either a snake-case joiner
# inside a field name (`api_key` → the schema's kebab `api-key`) or a literal
# char inside an alias key (`prod_v2`).
#
# Provider-specific env-var fallbacks (`ANTHROPIC_API_KEY`, `OPENAI_API_KEY`,
# etc.) and the V1/V2 generic fallbacks (`ZEROCLAW_API_KEY`, `API_KEY`,
# `ZEROCLAW_PROVIDER`, `ZEROCLAW_MODEL`) were eradicated in V0.8.0.
#
# Aliases are `[a-z0-9][a-z0-9_]{0,62}` — lowercase ASCII alphanumeric plus
# underscore (no leading underscore, no hyphen, no uppercase).

# ── Bootstrap (uppercase tail; pre-load, decides where the config file is) ─
# ZEROCLAW_DATA_DIR=/path/to/data
# ZEROCLAW_CONFIG_DIR=/path/to/.zeroclaw
# ZEROCLAW_WORKSPACE=/path/to/legacy/workspace  # DEPRECATED — use ZEROCLAW_DATA_DIR

# ── Schema-mirror examples ────────────────────────────────────────────────
# Set the Anthropic credential for the `default` typed-family alias:
# ZEROCLAW_providers__models__anthropic__default__api_key=sk-ant-...
#
# Set an OpenRouter alias's model + key (alias with `_` is fine):
# ZEROCLAW_providers__models__openrouter__prod_v2__model=anthropic/claude-sonnet-4-6
# ZEROCLAW_providers__models__openrouter__prod_v2__api_key=sk-or-...
#
# Toggle a channel:
# ZEROCLAW_channels__matrix__enabled=true
# ZEROCLAW_channels__matrix__homeserver=https://matrix.example.org
#
# Override a runtime knob:
# ZEROCLAW_gateway__request_timeout_secs=120
# ZEROCLAW_gateway__long_running_request_timeout_secs=900
#
# Inject a webhook signing secret:
# ZEROCLAW_channels__whatsapp__default__app_secret=...
# ZEROCLAW_channels__linq__default__signing_secret=...
# ZEROCLAW_channels__nextcloud_talk__default__webhook_secret=...
#
# Inject memory/Qdrant credentials:
# ZEROCLAW_storage__qdrant__default__url=https://qdrant.example.com
# ZEROCLAW_storage__qdrant__default__collection=zeroclaw
# ZEROCLAW_storage__qdrant__default__api_key=...

# ── Optional integrations (read directly by their tools) ──────────────────
# Pushover notifications (`pushover` tool)
# PUSHOVER_TOKEN=your-pushover-app-token
# PUSHOVER_USER_KEY=your-pushover-user-key
#
# Web search (Brave / SearXNG) — read by the web-search tool, not config:
# BRAVE_API_KEY=your-brave-search-api-key
# SEARXNG_INSTANCE_URL=https://searx.example.com

# ── Docker Compose ─────────────────────────────────────────────────────────
# Host port mapping (used by docker-compose.yml)
# HOST_PORT=3000