OpenClaw noch nicht installiert? Klicken Sie hier fuer die Ein-Klick-Installationsanleitung
curl -fsSL https://openclaw.ai/install.sh | bash
iwr -useb https://openclaw.ai/install.ps1 | iex
curl -fsSL https://openclaw.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
Bedenken wegen Auswirkungen auf Ihren Computer? ClawTank laeuft in der Cloud ohne Installation -- kein Risiko versehentlicher Loeschungen
Key Findings
  • Alle Einstellungen von OpenClaw sind in der JSON5-Datei ~/.openclaw/openclaw.json zusammengefasst, die Kommentare und abschliessende Kommas unterstuetzt und als „Steuerzentrale" des gesamten Agentensystems dient[1]
  • Die Modellkonfiguration verwendet einen zweistufigen Primary-+-Fallback-Mechanismus -- wenn das primaere Modell (z. B. Claude Opus 4.6) nicht verfuegbar ist, wechselt das System automatisch zum Ersatzmodell, um einen unterbrechungsfreien Betrieb des Agenten zu gewaehrleisten[4]
  • Der Gateway-Modus unterscheidet zwischen local (nur lokaler Zugriff) und remote (Fernverbindung) -- der Wechsel erfolgt mit einem einzigen Befehl[5]
  • Alle sensiblen Parameter (API Key, Gateway Token) sollten ueber die CLI mit openclaw config set geschrieben werden, um Syntaxfehler durch manuelle Bearbeitung zu vermeiden[3]

1. openclaw.json: Ihre Agenten-Steuerzentrale

Die Designphilosophie von OpenClaw lautet „eine einzige Konfigurationsdatei fuer alles". Ob Sie Modelle anpassen, Kommunikationskanaele hinzufuegen, das Gateway-Verhalten aendern oder Sicherheitsberechtigungen konfigurieren moechten -- alle Einstellungen werden in derselben Datei zusammengefuehrt.[1]

1.1 Dateispeicherort

Der Standardpfad ist ~/.openclaw/openclaw.json. Sie koennen auch ueber die Umgebungsvariable OPENCLAW_CONFIG_PATH einen benutzerdefinierten Pfad angeben, was in der Praxis aber selten erforderlich ist.[2]

Beim ersten Ausfuehren von openclaw onboard erstellt das System diese Datei automatisch und schreibt die Anfangskonfiguration hinein. Bei einer Neuinstallation muessen Sie sie nicht manuell anlegen.

1.2 JSON5-Format

openclaw.json verwendet das JSON5-Format, eine Obermenge des Standard-JSON, die Folgendes erlaubt:[8]

Das bedeutet, dass Sie die Datei direkt mit einem Texteditor oeffnen und kommentieren koennen, damit auch Teammitglieder den Zweck jeder Einstellung verstehen. Dennoch empfiehlt die offizielle Dokumentation die Verwendung von CLI-Befehlen zur Aenderung der Konfiguration, um Syntaxfehler durch manuelle Bearbeitung zu vermeiden.[3]

2. Modellkonfiguration: Primary und Fallback

Die Modellkonfiguration ist der am haeufigsten angepasste Teil von OpenClaw. Sie bestimmt, welches Large Language Model Ihr AI-Agent zum „Denken" verwendet.[4]

2.1 Primaeres Modell festlegen

Verwenden Sie den folgenden Befehl, um Ihr primaeres Modell festzulegen:

openclaw config set agents.defaults.model.primary claude-opus-4-6

OpenClaw unterstuetzt mehrere Modellanbieter, darunter Anthropic (Claude-Reihe), OpenAI (GPT-Reihe), Google (Gemini-Reihe) und andere. Verwenden Sie bei der Angabe des Modellnamens die jeweilige Modellkennung des Anbieters.

2.2 Ersatzmodell festlegen (Fallback)

Das Ersatzmodell wird automatisch aktiviert, wenn das primaere Modell nicht verfuegbar ist (z. B. aufgrund von API-Ratenlimitierung oder Dienstausfall):

openclaw config set agents.defaults.model.fallbacks '["claude-sonnet-4-6", "gpt-4o"]'

Die Fallback-Liste wird der Reihe nach durchlaufen: Das erste verfuegbare Modell wird ausgewaehlt. In Produktionsumgebungen wird dringend empfohlen, mindestens ein Ersatzmodell zu konfigurieren, um den kontinuierlichen Betrieb des Agenten sicherzustellen.

2.3 Modell-Authentifizierung

Jeder Modellanbieter erfordert einen eigenen API-Schluessel oder eine OAuth-Authentifizierung. Verwenden Sie die folgenden Befehle zur Verwaltung der Authentifizierung:

// API-Schluessel verwenden
openclaw models auth setup-token --provider anthropic

// OAuth verwenden (interaktive Autorisierung)
openclaw models auth login --provider openai

Die Authentifizierungsinformationen werden in ~/.openclaw/auth-profiles.json gespeichert, getrennt von der Hauptkonfigurationsdatei, um das Risiko einer versehentlichen Offenlegung zu reduzieren.[6]

3. Gateway-Moduskonfiguration

Das Gateway ist die Schaltzentrale von OpenClaw; alle Nachrichten werden darueber geroutet.[5] Der Gateway-Modus bestimmt, wer auf Ihren Agenten zugreifen kann.

3.1 Local-Modus (Standard)

Der standardmaessige local-Modus erlaubt nur lokale Verbindungen (127.0.0.1) und eignet sich fuer persoenliche Entwicklung und Tests:

openclaw config set gateway.mode local

In diesem Modus befindet sich die Web-UI unter http://127.0.0.1:18789 und ist nur von Ihrem eigenen Computer aus zugaenglich.

3.2 Remote-Modus

Wenn Sie von Ihrem Smartphone, anderen Geraeten oder einem externen Netzwerk auf OpenClaw zugreifen moechten, wechseln Sie in den remote-Modus:

openclaw config set gateway.mode remote

Nach dem Wechsel muessen Sie einen Gateway Token einrichten, um unbefugten Zugriff zu verhindern:

openclaw doctor --generate-gateway-token

Sicherheitshinweis: Im Remote-Modus sollten Sie unbedingt TLS (HTTPS) und ein starkes Token verwenden, da andernfalls Ihr gesamter Computer im Netzwerk exponiert ist.[6]

3.3 Port-Konfiguration

Der Standard-Port ist 18789. Bei Konflikten mit anderen Diensten koennen Sie ihn anpassen:

openclaw config set gateway.port 28789

4. Workspace- und Agenten-Konfiguration

Der Workspace ist die logische Einheit, in der OpenClaw das Gedaechtnis und den Zustand des Agenten verwaltet. Jeder Workspace kann ueber eine eigenstaendige Agentenkonfiguration verfuegen.

4.1 Standard-Workspace-Pfad

openclaw config set agents.defaults.workspace ~/my-workspace

Das Workspace-Verzeichnis enthaelt das Kontextgedaechtnis, den Gespraechsverlauf und die Tool-Call-Protokolle des Agenten. Verschiedene Projekte koennen unterschiedliche Workspaces verwenden, sodass der Agent in jedem Projekt einen eigenstaendigen Wissenskontext beibehalt.

4.2 Timeout-Konfiguration

Die maximale Ausfuehrungszeit des Agenten wird durch timeoutSeconds gesteuert:

openclaw config set agents.defaults.timeoutSeconds 300

Der Standardwert ist fuer die meisten Aufgaben ausreichend. Wenn Ihr Agent jedoch lang andauernde Operationen durchfuehren muss (z. B. Scans grosser Codebasen oder komplexe Browser-Automatisierungsablaeufe), muessen Sie diesen Wert moeglicherweise erhoehen.

5. Schnellreferenztabelle fuer gaengige Konfigurationsbefehle

VerwendungszweckBefehl
Alle Einstellungen anzeigenopenclaw config get
Bestimmte Einstellung anzeigenopenclaw config get agents.defaults.model
Primaeres Modell festlegenopenclaw config set agents.defaults.model.primary MODEL_ID
Ersatzmodelle festlegenopenclaw config set agents.defaults.model.fallbacks '["MODEL_A","MODEL_B"]'
Gateway-Modus wechselnopenclaw config set gateway.mode local|remote
Port aendernopenclaw config set gateway.port PORT
Workspace festlegenopenclaw config set agents.defaults.workspace PATH
Einstellung entfernenopenclaw config unset KEY
Konfigurationsdatei ueberpruefenopenclaw doctor

Alle config set-Befehle schreiben sofort in openclaw.json, aber einige Einstellungen (wie der Gateway-Modus) erfordern einen Neustart des Gateways, um wirksam zu werden.[3]

6. Bewaeehrte Sicherheitspraktiken

OpenClaw ist ein Agent, der auf Ihren gesamten Computer zugreifen kann. Eine fehlerhafte Konfiguration kann ernsthafte Sicherheitsrisiken mit sich bringen.[6][7]

  1. Pushen Sie openclaw.json niemals in Git: Die Konfigurationsdatei kann sensible Token und Pfadinformationen enthalten
  2. Verwenden Sie die CLI statt manueller Bearbeitung: openclaw config set validiert automatisch Format und Wertgueltigkeit
  3. Im Remote-Modus ist ein Token Pflicht: Ein Gateway im Remote-Modus ohne Token bedeutet, dass die Kontrolle ueber Ihren Computer oeffentlich im Netzwerk zugaenglich ist
  4. Rotieren Sie API-Schluessel regelmaessig: Aktualisieren Sie die API-Schluessel der Modellanbieter alle 90 Tage
  5. Prinzip der minimalen Berechtigungen: Aktivieren Sie nur die Skills und Hooks, die der Agent tatsaechlich benoetigt, um die Angriffsflaeche zu reduzieren

Fazit

Das Konfigurationssystem von OpenClaw basiert auf dem Kernprinzip „eine Datei verwaltet alles" und vereinfacht die komplexe verteilte Agentenarchitektur zu intuitiven Schluessel-Wert-Paaren.[1] Wenn Sie die Struktur von openclaw.json und den Befehl config set beherrschen, haben Sie die Kontrolle ueber das gesamte Agentensystem.

Sollten Sie waehrend der Konfiguration auf Probleme stossen, koennen Sie unseren OpenClaw-Fehlerbehebungsleitfaden konsultieren oder openclaw doctor --fix verwenden, damit das System gaengige Konfigurationsfehler automatisch behebt.