From 3cdc6b6ebdb251783d76c4971655177dbe7950be Mon Sep 17 00:00:00 2001
From: fettpl <38704082+fettpl@users.noreply.github.com>
Date: Mon, 16 Feb 2026 17:54:06 +0100
Subject: [PATCH] docs: add .env.example for local secret handling

Provide a template with all recognized environment variables so
developers can set up their local .env without guessing.
The actual .env is already in .gitignore.

Closes #364

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
---
 .env.example | 26 ++++++++++++++++++++++++++
 1 file changed, 26 insertions(+)
 create mode 100644 .env.example

diff --git a/.env.example b/.env.example
new file mode 100644
index 0000000..17686d3
--- /dev/null
+++ b/.env.example
@@ -0,0 +1,26 @@
+# ZeroClaw Environment Variables
+# Copy this file to .env and fill in your values.
+# NEVER commit .env — it is listed in .gitignore.
+
+# ── Required ──────────────────────────────────────────────────
+# Your LLM provider API key
+# ZEROCLAW_API_KEY=sk-your-key-here
+API_KEY=your-api-key-here
+
+# ── Provider & Model ─────────────────────────────────────────
+# LLM provider: openrouter, openai, anthropic, ollama, glm
+PROVIDER=openrouter
+# ZEROCLAW_MODEL=anthropic/claude-sonnet-4-20250514
+# ZEROCLAW_TEMPERATURE=0.7
+
+# ── Gateway ──────────────────────────────────────────────────
+# ZEROCLAW_GATEWAY_PORT=3000
+# ZEROCLAW_GATEWAY_HOST=127.0.0.1
+# ZEROCLAW_ALLOW_PUBLIC_BIND=false
+
+# ── Workspace ────────────────────────────────────────────────
+# ZEROCLAW_WORKSPACE=/path/to/workspace
+
+# ── Docker Compose ───────────────────────────────────────────
+# Host port mapping (used by docker-compose.yml)
+# HOST_PORT=3000