Skip to content
ClawHosters ClawHosters
Anmelden
Abo -30% SUB30
> docs/environment-variables

Umgebungsvariablen-Referenz

3 min Lesezeit Configuration Zuletzt aktualisiert 05. March 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.

Erweiterter Konfigurationseditor

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...
OPENCLAW_API_ENDPOINT API-Endpunkt für Instanz-Kommunikation https://api.clawhosters.com

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
MISTRAL_API_KEY Mistral-API-Schlüssel Mistral ausgewählt
GROQ_API_KEY Groq-API-Schlüssel Groq 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-Infrastruktur geroutet

Wenn LLM_MODE auf managed steht, wird das Routing automatisch konfiguriert.

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

Einige Variablen werden in der docker-compose.yml-Datei gesetzt und beeinflussen die Container-Laufzeit. Dazu gehören Node.js-Speicheroptimierungseinstellungen, die automatisch basierend auf deinem Tier konfiguriert werden, um stabile Performance sicherzustellen.

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 den Netzwerkzugriff ein und reduziert die Angriffsfläche
  • Teile niemals die .env-Datei oder openclaw.json deiner Instanz. Sie enthalten vertrauliche Zugangsdaten.

Verwandte Dokumentation

Verwandte Dokumentation

~/docs/openclaw-json

OpenClaw-Konfigurationsreferenz

Was openclaw.json macht Die openclaw.json-Datei ist die Hauptkonfigurationsdatei deiner OpenClaw...
~/docs/docker

Docker-Konfiguration

Wie Docker genutzt wird Jede ClawHosters-Instanz führt OpenClaw in einem Docker-Container auf ei...
~/docs/first-instance

Deine erste Instanz erstellen

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