Konfiguration

Alle Einstellungen von OpenClaw befinden sich in einer einzigen Konfigurationsdatei. Lass uns lernen, wie du sie anpassen kannst.

📄 Speicherort der Konfigurationsdatei

Die Hauptkonfigurationsdatei von OpenClaw befindet sich unter:

~/.openclaw/openclaw.json

Das ~ steht für dein Benutzerverzeichnis. Auf macOS ist der vollständige Pfad normalerweise /Users/dein-benutzername/.openclaw/openclaw.json.

💡 Kleiner Tipp: .openclaw ist ein versteckter Ordner (Ordner, deren Name mit einem Punkt beginnt, werden standardmäßig nicht angezeigt). Im macOS Finder kannst du Command + Shift + . drücken, um versteckte Dateien anzuzeigen. Unter Linux nutzt du den Befehl ls -a.

⚙️ Wichtige Konfigurationsoptionen

Hier sind die am häufigsten verwendeten Einstellungen in der Konfigurationsdatei:

KI-Modellauswahl

Das standardmäßig verwendete KI-Modell festlegen:

{
  "model": {
    "provider": "anthropic",
    "name": "claude-sonnet-4-20250514",
    "api_key": "sk-ant-..."
  }
}

Du kannst provider auf "openai", "deepseek" oder "google" ändern und den entsprechenden Modellnamen sowie API-Schlüssel angeben.

Sitzungsverwaltung

Das Verhalten der KI-Gespräche steuern:

{
  "session": {
    "max_history": 50,
    "timeout_minutes": 30,
    "system_prompt": "Du bist ein hilfreicher KI-Assistent..."
  }
}

max_history — Wie viele Nachrichten maximal im Gesprächsverlauf gespeichert werden
timeout_minutes — Nach wie vielen Minuten ohne Interaktion automatisch ein neues Gespräch begonnen wird
system_prompt — Die "Rollendefinition" der KI, hier kannst du die Persönlichkeit der KI anpassen

Kanalkonfiguration

Verbindungsinformationen für die einzelnen Chat-Plattformen festlegen:

{
  "channels": {
    "telegram": {
      "enabled": true,
      "bot_token": "123456:ABC-DEF..."
    },
    "discord": {
      "enabled": true,
      "bot_token": "MTIz..."
    }
  }
}

🔄 Hot Reload

OpenClaw unterstützt Hot Reload, das bedeutet: Nachdem du die Konfigurationsdatei geändert hast, musst du OpenClaw nicht neu starten — es erkennt die Änderungen automatisch und wendet die neuen Einstellungen an.

Einfach gesagt: Du musst nur die Konfigurationsdatei bearbeiten und speichern, und OpenClaw verwendet automatisch die neuen Einstellungen. Sehr praktisch!

ℹ️ Hinweis: Einige Kerneinstellungen (wie die Portnummer) erfordern möglicherweise einen manuellen Neustart. Die meisten Einstellungen (wie Modellwechsel, Kanalkonfiguration) können jedoch per Hot Reload aktualisiert werden.