# AI Core — configuration template. Copy to .env and fill in. NEVER commit .env.
# Variable names marked (verify) should be confirmed against https://docs.openclaw.ai
# for your OpenClaw version before relying on them.

# --- OpenAI / ChatGPT (LLM backend, current) --------------------------------
# OpenClaw talks to OpenAI via an API key. Create one at https://platform.openai.com.
# Keep this secret — it is billed per token.
OPENAI_API_KEY=

# --- Model routing (cost control) -------------------------------------------
# Route routine work to a small/fast model; reasoning/aggregation to a strong model.
# (verify current model IDs at https://platform.openai.com/docs/models)
OPENAI_MODEL_PRIMARY=gpt-5        # reasoning, planning, aggregation
OPENAI_MODEL_FAST=gpt-5-mini      # routing, triage, simple classification
# OPENAI_MODEL_HEAVY=             # reserve a top model for rare hard cases; prefer escalating to Sam

# --- FUTURE: Amazon Bedrock (when we migrate to AWS) ------------------------
# Not used now. On AWS EC2 later, drop OPENAI_* above, attach an IAM instance role,
# and let OpenClaw use the AWS credential chain (no API key). Same compose, same agents.
# AWS_REGION=us-east-1

# --- Gateway ----------------------------------------------------------------
# Keep the gateway bound to loopback in docker-compose; do not expose publicly.
GATEWAY_PORT=18789
# (verify) set an access token/secret for the web UI if your version supports it:
# OPENCLAW_GATEWAY_TOKEN=

# --- Channels (add only what you use; leave blank to disable) ----------------
# Sam's single point of contact should bind to CHIEF only (see agents/chief/SOUL.md).
# TELEGRAM_BOT_TOKEN=
# SLACK_BOT_TOKEN=
