.env.example

# ──────────────────────────────────────────────────────────────────────────────
# better-openclaw — Docker Compose Environment Variables
# Copy to .env and fill in values before running `docker compose up`
# ──────────────────────────────────────────────────────────────────────────────

# ── Convex Self-Hosted Backend ───────────────────────────────────────────────

# Name for your Convex instance (used as internal identifier)
INSTANCE_NAME=openclaw-convex

# Secret for the Convex instance (leave blank to auto-generate)
INSTANCE_SECRET=

# Optional: PostgreSQL URL for Convex (default: uses embedded SQLite)
DATABASE_URL=

# The origin URLs for Convex. These must match how you access the backend.
# For local Docker: use http://127.0.0.1:<port>
# For production: use your public domain
CONVEX_CLOUD_ORIGIN=http://127.0.0.1:3210
CONVEX_SITE_ORIGIN=http://127.0.0.1:3211

# Convex log level (trace, debug, info, warn, error)
RUST_LOG=info

# Disable Convex telemetry beacon (set to any value to disable)
DISABLE_BEACON=

# ── Convex Dashboard ────────────────────────────────────────────────────────

# Internal Docker URL for the dashboard to reach the backend
NEXT_PUBLIC_DEPLOYMENT_URL=http://convex:3210

# ── Mission Control ─────────────────────────────────────────────────────────

# URL the browser uses to connect to Convex (build-time, embedded in JS bundle).
# This should be reachable from the end-user's browser, NOT the Docker network.
VITE_CONVEX_URL=http://127.0.0.1:3210

# URL the Docker build process uses to push Convex functions (internal Docker network).
CONVEX_SELF_HOSTED_URL=http://convex:3210

# Admin key for pushing Convex functions during build.
# Generate this by running:
#   docker compose exec convex ./generate_admin_key.sh
# Then paste the output here.
CONVEX_SELF_HOSTED_ADMIN_KEY=

# ── SkillsMP API ─────────────────────────────────────────────────────────────
# API key for SkillsMP skills marketplace (https://skillsmp.com/docs/api)
SKILLSMP_API_KEY=sk_live_your_api_key_here