402d8f0a32
- Add comprehensive documentation for Z.AI GLM models
- Include curl examples for testing Z.AI API
- Document available models and troubleshooting
- Update .env.example with Z.AI configuration
Z.AI provides GLM models (glm-4.5, glm-4.6, glm-4.7, glm-5) through
the OpenAI-compatible endpoint at api.z.ai/api/coding/paas/v4.
Existing tests verify:
- zai_base_url() returns correct URLs for global/CN variants
- create_provider('zai', key) successfully creates provider
- Regional alias predicates cover all variants
83 lines
2.9 KiB
Text
83 lines
2.9 KiB
Text
# ZeroClaw Environment Variables
|
|
# Copy this file to `.env` and fill in your local values.
|
|
# Never commit `.env` or any real secrets.
|
|
|
|
# ── Core Runtime ──────────────────────────────────────────────
|
|
# Provider key resolution at runtime:
|
|
# 1) explicit key passed from config/CLI
|
|
# 2) provider-specific env var (OPENROUTER_API_KEY, OPENAI_API_KEY, ...)
|
|
# 3) generic fallback env vars below
|
|
|
|
# Generic fallback API key (used when provider-specific key is absent)
|
|
API_KEY=your-api-key-here
|
|
# ZEROCLAW_API_KEY=your-api-key-here
|
|
|
|
# Default provider/model (can be overridden by CLI flags)
|
|
PROVIDER=openrouter
|
|
# ZEROCLAW_PROVIDER=openrouter
|
|
# ZEROCLAW_MODEL=anthropic/claude-sonnet-4-20250514
|
|
# ZEROCLAW_TEMPERATURE=0.7
|
|
|
|
# Workspace directory override
|
|
# ZEROCLAW_WORKSPACE=/path/to/workspace
|
|
|
|
# ── Provider-Specific API Keys ────────────────────────────────
|
|
# OpenRouter
|
|
# OPENROUTER_API_KEY=sk-or-v1-...
|
|
|
|
# Anthropic
|
|
# ANTHROPIC_OAUTH_TOKEN=...
|
|
# ANTHROPIC_API_KEY=sk-ant-...
|
|
|
|
# OpenAI / Gemini
|
|
# OPENAI_API_KEY=sk-...
|
|
# GEMINI_API_KEY=...
|
|
# GOOGLE_API_KEY=...
|
|
|
|
# Other supported providers
|
|
# VENICE_API_KEY=...
|
|
# GROQ_API_KEY=...
|
|
# MISTRAL_API_KEY=...
|
|
# DEEPSEEK_API_KEY=...
|
|
# XAI_API_KEY=...
|
|
# TOGETHER_API_KEY=...
|
|
# FIREWORKS_API_KEY=...
|
|
# PERPLEXITY_API_KEY=...
|
|
# COHERE_API_KEY=...
|
|
# MOONSHOT_API_KEY=...
|
|
# GLM_API_KEY=...
|
|
# MINIMAX_API_KEY=...
|
|
# QIANFAN_API_KEY=...
|
|
# DASHSCOPE_API_KEY=...
|
|
# ZAI_API_KEY=...
|
|
# SYNTHETIC_API_KEY=...
|
|
# OPENCODE_API_KEY=...
|
|
# VERCEL_API_KEY=...
|
|
# CLOUDFLARE_API_KEY=...
|
|
|
|
# ── Gateway ──────────────────────────────────────────────────
|
|
# ZEROCLAW_GATEWAY_PORT=3000
|
|
# ZEROCLAW_GATEWAY_HOST=127.0.0.1
|
|
# ZEROCLAW_ALLOW_PUBLIC_BIND=false
|
|
|
|
# ── Optional Integrations ────────────────────────────────────
|
|
# Pushover notifications (`pushover` tool)
|
|
# PUSHOVER_TOKEN=your-pushover-app-token
|
|
# PUSHOVER_USER_KEY=your-pushover-user-key
|
|
|
|
# ── Docker Compose ───────────────────────────────────────────
|
|
# Host port mapping (used by docker-compose.yml)
|
|
# HOST_PORT=3000
|
|
|
|
# ── Z.AI GLM Coding Plan ───────────────────────────────────────
|
|
# Z.AI provides GLM models (glm-4.5, glm-4.6, glm-4.7, glm-5).
|
|
# API key format: id.secret (e.g., abc123.xyz789)
|
|
#
|
|
# Usage:
|
|
# zeroclaw onboard --provider zai --api-key YOUR_ZAI_API_KEY
|
|
#
|
|
# Or set the environment variable:
|
|
# ZAI_API_KEY=your-id.secret
|
|
#
|
|
# Available models: glm-4.5, glm-4.5-air, glm-4.6, glm-4.7, glm-5
|
|
# See docs/zai-glm-setup.md for detailed configuration.
|