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 bis zu fünf übergeordneten Abschnitten. Nicht alle Abschnitte sind auf jeder Instanz vorhanden. Sie werden nur eingefügt, wenn sie relevant sind.

{
  "gateway": { ... },
  "commands": { ... },
  "models": { ... },
  "agents": { ... },
  "channels": { ... }
}

Hinweis: API-Schlüssel werden NICHT in openclaw.json gespeichert. Sie werden als Docker-Umgebungsvariablen über die .env-Datei übergeben. Siehe Umgebungsvariablen für Details.

gateway (Immer vorhanden)

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

{
  "gateway": {
    "mode": "local",
    "auth": {
      "mode": "token",
      "token": "sha256-gehashter-token"
    },
    "controlUi": {
      "allowInsecureAuth": true
    }
  }
}

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

commands (Bedingt)

Aktiviert eingebaute Befehle für die OpenClaw-Instanz. Unterstützt aktuell den Restart-Befehl.

{
  "commands": {
    "restart": true
  }
}

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"
      }
    }
  }
}

Alle Modelle verwenden das Format provider/model-name:

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",
    "auth": {
      "mode": "token",
      "token": "a1b2c3d4..."
    },
    "controlUi": {
      "allowInsecureAuth": true
    }
  }
}

Eine voll konfigurierte Instanz mit Anthropic-LLM und Telegram:

{
  "gateway": {
    "mode": "local",
    "auth": {
      "mode": "token",
      "token": "a1b2c3d4..."
    },
    "controlUi": {
      "allowInsecureAuth": true
    }
  },
  "commands": {
    "restart": true
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "anthropic/claude-3-haiku"
      }
    }
  },
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "123456789:ABCdef...",
      "dmPolicy": "owner_only",
      "allowFrom": ["*"]
    }
  }
}

Hinweis: Der Anthropic-API-Schlüssel wird als Docker-Umgebungsvariable ANTHROPIC_API_KEY übergeben, nicht in dieser Datei.

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