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