OpenClaw-Konfigurationsreferenz

Was openclaw.json macht

Die openclaw.json-Datei ist die Hauptkonfigurationsdatei deiner OpenClaw-Instanz. Sie steuert, wie das Gateway Nutzer authentifiziert, welchen LLM-Anbieter du nutzt und welche Messenger-Kanäle aktiv sind.

ClawHosters generiert diese Datei automatisch basierend auf deinen Dashboard-Einstellungen. Wenn du deinen LLM-Anbieter änderst, einen Telegram-Bot hinzufügst oder andere Einstellungen aktualisierst, erstellt ClawHosters die Konfiguration neu und deployt sie auf deine Instanz.

Du musst diese Datei nicht manuell bearbeiten, es sei denn, du verbindest dich per SSH für erweiterte Konfiguration.

Dateispeicherort

Auf deiner Instanz ist die Konfigurationsdatei gespeichert unter:

/root/.openclaw/openclaw.json

Das ist ein Bind-Mount von /opt/openclaw/dotopenclaw/openclaw.json auf dem Host-System. Änderungen an einem der beiden Pfade betreffen dieselbe Datei.

Konfigurationsstruktur

Die Datei ist ein JSON-Objekt mit vier übergeordneten Abschnitten. Nicht alle Abschnitte sind auf jeder Instanz vorhanden — sie werden nur eingefügt, wenn sie relevant sind.

{
  "gateway": { ... },
  "env": { ... },
  "agents": { ... },
  "channels": { ... }
}

gateway (Immer vorhanden)

Steuert, wie das OpenClaw-Gateway läuft und Anfragen authentifiziert.

{
  "gateway": {
    "mode": "local",
    "trustedProxies": [
      "172.16.0.0/12",
      "10.0.0.0/8",
      "127.0.0.1"
    ],
    "auth": {
      "mode": "token",
      "token": "sha256-gehashter-token"
    },
    "controlUi": {
      "allowInsecureAuth": true
    }
  }
}

Der Gateway-Abschnitt wird immer generiert, auch auf Instanzen ohne konfiguriertes LLM oder Messenger.

env (Bedingt)

Enthält API-Schlüssel für den gewählten LLM-Anbieter. Dieser Abschnitt ist nur vorhanden, wenn du ein LLM konfiguriert hast.

{
  "env": {
    "ANTHROPIC_API_KEY": "sk-ant-..."
  }
}

Nur der relevante Schlüssel für deinen Anbieter wird eingefügt:

Wenn kein LLM konfiguriert ist (Instanz im "Kein LLM"-Modus), wird dieser Abschnitt komplett weggelassen.

agents (Bedingt)

Gibt das Standard-LLM-Modell für die Instanz an. Nur vorhanden, wenn ein LLM konfiguriert ist.

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "anthropic/claude-3-haiku"
      }
    }
  }
}

Das Format des Model-Strings variiert je nach Anbieter:

Anthropic-Modelle sind ein Sonderfall — sie haben keinen Provider-Präfix im Model-String.

channels (Bedingt)

Konfiguriert Messenger-Integrationen. Jeder Kanal wird nur einbezogen, wenn er in deinem Dashboard eingerichtet wurde.

Telegram

{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "123456789:ABCdefGHIjklMNOpqrsTUVwxyz",
      "dmPolicy": "owner_only",
      "allowFrom": ["*"]
    }
  }
}

Discord

{
  "channels": {
    "discord": {
      "enabled": true,
      "token": "bot-token-hier",
      "dm": {
        "enabled": true,
        "policy": "pairing",
        "allowFrom": ["*"]
      }
    }
  }
}

Slack

{
  "channels": {
    "slack": {
      "enabled": true,
      "botToken": "xoxb-...",
      "appToken": "xapp-..."
    }
  }
}

WhatsApp

{
  "channels": {
    "whatsapp": {
      "enabled": true,
      "dmPolicy": "owner_only"
    }
  }
}

Minimal- vs Voll-Beispiel

Eine frisch erstellte Instanz ohne LLM oder Messenger hat nur den Gateway-Abschnitt:

{
  "gateway": {
    "mode": "local",
    "trustedProxies": ["172.16.0.0/12", "10.0.0.0/8", "127.0.0.1"],
    "auth": {
      "mode": "token",
      "token": "a1b2c3d4..."
    },
    "controlUi": {
      "allowInsecureAuth": true
    }
  }
}

Eine voll konfigurierte Instanz mit Anthropic-LLM und Telegram:

{
  "gateway": {
    "mode": "local",
    "trustedProxies": ["172.16.0.0/12", "10.0.0.0/8", "127.0.0.1"],
    "auth": {
      "mode": "token",
      "token": "a1b2c3d4..."
    },
    "controlUi": {
      "allowInsecureAuth": true
    }
  },
  "env": {
    "ANTHROPIC_API_KEY": "sk-ant-api03-..."
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "claude-3-haiku"
      }
    }
  },
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "123456789:ABCdef...",
      "dmPolicy": "owner_only",
      "allowFrom": ["*"]
    }
  }
}

Wie Konfigurationsänderungen angewendet werden

Wenn du Einstellungen in deinem Dashboard aktualisierst:

1. ClawHosters generiert openclaw.json mit deinen neuen Einstellungen neu
2. Die Datei wird per SCP auf deine Instanz hochgeladen
3. Der doctor --fix-Befehl läuft, um Plugin-Änderungen anzuwenden
4. Deine Instanz übernimmt die neue Konfiguration

Dieser Vorgang dauert einige Sekunden. Während des Updates läuft deine Instanz weiter — es gibt keine Ausfallzeit für Konfigurationsänderungen.

Manuelle Bearbeitung per SSH

Wenn du dich per SSH mit deiner Instanz verbindest, kannst du die Konfiguration unter /root/.openclaw/openclaw.json einsehen. Du kannst sie manuell bearbeiten, aber beachte:

• Änderungen über das Dashboard überschreiben deine manuellen Bearbeitungen
• Ungültiges JSON verhindert den Start des Gateways
• Ein fehlender gateway-Abschnitt bricht die Authentifizierung

Wenn du die Konfiguration kaputt machst, nutze den "Redeployment"-Button in deinem Dashboard, um sie aus deinen gespeicherten Einstellungen neu zu generieren.

Verwandte Dokumentation

• SSH-Zugang — Verbindung zu deiner Instanz
• Telegram verbinden — Telegram einrichten
• LLM-Add-on — LLM-Anbieter konfigurieren
• Instanz neu aufsetzen — Factory-Reset bei kaputter Konfiguration