Skip to content
ClawHosters ClawHosters
Anmelden Jetzt starten
Abo -25% LAUNCH-SUB
Claws -25% LAUNCH-CLAWS

Umgebungsvariablen-Referenz

3 min Lesezeit Configuration Zuletzt aktualisiert 10. February 2026

Überblick

Umgebungsvariablen steuern, wie deine OpenClaw-Instanz sich mit Diensten verbindet und ihr Laufzeitverhalten konfiguriert. Die meisten Variablen werden automatisch von ClawHosters basierend auf deinen Dashboard-Einstellungen gesetzt. Einige können per SSH für fortgeschrittene Anwendungsfälle angepasst werden.

Von ClawHosters gesetzte Variablen

Diese Variablen werden automatisch verwaltet. Änderungen deiner Dashboard-Einstellungen aktualisieren sie beim nächsten Config-Deployment.

Instanz-Identifikation

Variable Beschreibung Beispiel
OPENCLAW_INSTANCE_ID Eindeutige Instanz-ID 42
OPENCLAW_CUSTOMER_ID Deine Kunden-ID 7
OPENCLAW_TIER Dein Tier-Name budget, balanced, pro
OPENCLAW_INSTANCE_NAME Der Name deiner Instanz mein-assistent
OPENCLAW_GATEWAY_MODE Gateway-Betriebsmodus local
OPENCLAW_GATEWAY_TOKEN SHA256-gehashter Token für Web-UI-Auth a1b2c3...

LLM-Konfiguration

Variable Beschreibung Gesetzt wenn
LLM_MODE LLM-Betriebsmodus Immer
ANTHROPIC_API_KEY Anthropic-API-Schlüssel Anthropic ausgewählt
OPENAI_API_KEY OpenAI-API-Schlüssel OpenAI ausgewählt
OPENROUTER_API_KEY OpenRouter-API-Schlüssel OpenRouter ausgewählt
GEMINI_API_KEY Google-Gemini-API-Schlüssel Google ausgewählt
DEEPSEEK_API_KEY DeepSeek-API-Schlüssel DeepSeek ausgewählt

LLM_MODE-Werte:

Wert Bedeutung
none Kein LLM konfiguriert — Nur-Gateway-Modus
byok Bring Your Own Key — dein API-Schlüssel, direkt zum Anbieter
managed Managed LLM — über ClawHosters-Proxy geroutet

Wenn LLM_MODE auf managed steht, wird auch die Proxy-URL gesetzt:

Variable Wert
LLM_PROXY_URL https://llm-proxy.clawhosters.com/v1

Playwright (Browser)

Variable Beschreibung Wert
PLAYWRIGHT_BROWSERS_PATH Wo Chromium installiert ist /opt/playwright-browsers

Diese Variable ist auf allen Instanzen gesetzt. Chromium ist im Base-Snapshot für Web-Automatisierungs-Skills vorinstalliert.

Docker-Compose-Variablen

Diese Variablen werden in der docker-compose.yml-Datei gesetzt und beeinflussen die Container-Laufzeit:

Variable Beschreibung Budget Balanced Pro
NODE_OPTIONS Node.js-Speicherlimit --max-old-space-size=768 --max-old-space-size=1536 --max-old-space-size=3072

Die NODE_OPTIONS-Variable begrenzt die Node.js-Heap-Größe, um zu verhindern, dass dem Container der Arbeitsspeicher ausgeht. Sie wird basierend auf dem Docker-Speicherlimit deines Tiers gesetzt.

Aktuelle Variablen anzeigen

Über das Dashboard

Die aktuellen Umgebungsvariablen deiner Instanz sind auf der Instanz-Detailseite sichtbar. Sensible Werte (API-Schlüssel, Tokens) werden maskiert.

Per SSH

Um alle Variablen im laufenden Container zu sehen:

bash 
docker exec openclaw-<id> env

Um eine bestimmte Variable zu prüfen:

bash 
docker exec openclaw-<id> printenv LLM_MODE

Eigene Variablen hinzufügen

Wenn du eigene Umgebungsvariablen brauchst (für MCP-Server oder eigene Skills):

Temporär (bis Container-Neustart)

bash 
docker exec openclaw-<id> bash -c "export MEINE_VAR=wert && ..."

Das bleibt nicht über Neustarts erhalten.

Persistent (über .env-Datei)

Verbinde dich per SSH mit deiner Instanz und bearbeite die .env-Datei:

bash 
# Auf dem Host (nicht im Container)
nano /opt/openclaw/.env

Füge deine Variable hinzu:

text 
MEINE_EIGENE_VAR=ein-wert

Dann starte den Container neu:

bash 
cd /opt/openclaw && docker compose restart

Eigene Variablen in .env bleiben über Neustarts erhalten, werden aber bei einem vollständigen Redeploy vom Dashboard überschrieben. Um eigene Variablen nach einem Redeploy zu behalten, füge sie nach jedem Deployment erneut hinzu.

Sicherheitshinweise

  • API-Schlüssel werden verschlüsselt in der ClawHosters-Datenbank gespeichert
  • Schlüssel werden nur während des Config-Deployments entschlüsselt
  • Auf der Instanz existieren Schlüssel als Klartext in openclaw.json und Umgebungsvariablen
  • Die Firewall der Instanz schränkt Netzwerkzugriff ein und begrenzt die Exposition
  • Teile niemals die .env-Datei oder openclaw.json deiner Instanz — sie enthalten Geheimnisse

Verwandte Dokumentation

Verwandte Dokumentation

OpenClaw-Konfigurationsreferenz

Was openclaw.json macht Die openclaw.json-Datei ist die Hauptkonfigurationsdatei deiner OpenClaw...

Deine erste Instanz erstellen

Was du einrichtest Eine Instanz ist ein dedizierter Server, auf dem OpenClaw läuft und der aussc...

Docker-Konfiguration

Wie Docker genutzt wird Jede ClawHosters-Instanz führt OpenClaw in einem Docker-Container auf ei...