OpenClaw konfigurieren: Einstellungen & Gateway-Setup

Kennst du das? Du willst nur kurz ein Tool einrichten, aber die Konfiguration fühlt sich an wie ein Ratespiel. Entweder suchst du ewig nach der richtigen Datei oder eine kleine Änderung zerschießt dir direkt das ganze Setup.

Damit du bei OpenClaw sofort durchstartest, habe ich hier die wichtigsten Grundlagen zusammengefasst. So behältst du die Kontrolle über dein System und vermeidest die typischen Stolperfallen beim Setup.

Configuration Basics

Das Konfigurationssystem von OpenClaw verstehen.

Welches Format hat die Config? Wo liegt sie?

OpenClaw liest eine optionale JSON5-Konfiguration aus $OPENCLAW_CONFIG_PATH (Standardwert: ~/.openclaw/openclaw.json).

Falls die Datei fehlt, nutzt das System sichere Defaults (einschließlich eines Standard-Workspaces unter ~/.openclaw/workspace).

Ich habe gateway.bind: "lan" (oder "tailnet") gesetzt und jetzt antwortet nichts / die UI sagt “unauthorized”

Binds, die nicht über Loopback laufen, erfordern eine Authentifizierung. Du musst gateway.auth.mode + gateway.auth.token konfigurieren (oder OPENCLAW_GATEWAY_TOKEN verwenden).

{
  gateway: {
    bind: "lan",
    auth: {
      mode: "token",
      token: "replace-me"
    }
  }
}

Warum brauche ich jetzt ein Token auf localhost?

Der Wizard generiert standardmäßig ein Gateway-Token (sogar auf Loopback), damit lokale WS-Clients sich authentifizieren müssen. Das verhindert, dass andere lokale Prozesse einfach dein Gateway aufrufen können.

Wenn du einen offenen Loopback wirklich bevorzugst, entferne einfach gateway.auth aus deiner Config.

Muss ich nach einer Config-Änderung neu starten?

Das Gateway überwacht die Config und unterstützt Hot-Reload:

• gateway.reload.mode: "hybrid" (Standard): Wendet sichere Änderungen sofort an, startet bei kritischen Änderungen neu
• hot, restart und off werden ebenfalls unterstützt

Wie aktiviere ich Web Search (und Web Fetch)?

web_fetch funktioniert ohne API-Key. web_search benötigt hingegen einen Brave Search API Key.

Meine Empfehlung: Führe openclaw configure --section web aus, um den Key in tools.web.search.apiKey zu speichern.

{
  tools: {
    web: {
      search: {
        enabled: true,
        apiKey: "BRAVE_API_KEY_HERE",
        maxResults: 5
      },
      fetch: { enabled: true }
    }
  }
}

config.apply hat meine Config gelöscht. Wie rette ich das und wie verhindere ich es?

config.apply ersetzt die gesamte Konfiguration. Wenn du nur ein unvollständiges Objekt sendest, wird alles andere entfernt.

Wiederherstellung:

• Aus einem Backup wiederherstellen
• Wenn du kein Backup hast: Führe openclaw doctor erneut aus und starte die Konfiguration neu

Vermeidung:

• Nutze openclaw config set für kleine Änderungen
• Nutze openclaw configure für interaktive Bearbeitungen

Wie betreibe ich ein zentrales Gateway mit spezialisierten Workern auf verschiedenen Geräten?

Das übliche Muster besteht aus einem Gateway plus Nodes und Agents:

• Gateway (zentral): Verwaltet Channels, Routing und Sessions
• Nodes (Geräte): Macs/iOS/Android verbinden sich als Peripherie und stellen lokale Tools bereit
• Agents (Worker): Separate Instanzen oder Workspaces für spezielle Rollen
• Sub-agents: Starten Hintergrundaufgaben von einem Haupt-Agenten aus
• TUI: Verbindet sich mit dem Gateway und wechselt zwischen Agents oder Sessions

Kann der OpenClaw-Browser headless laufen?

Ja. Das ist eine Konfigurationsoption:

{
  browser: { headless: true },
  agents: {
    defaults: {
      sandbox: { browser: { headless: true } }
    }
  }
}

Der Standardwert ist false (headful). Headless führt auf manchen Seiten eher dazu, dass Anti-Bot-Prüfungen anschlagen.

Wie nutze ich Brave für die Browser-Steuerung?

Setze browser.executablePath auf deine Brave-Binary (oder einen anderen Chromium-basierten Browser) und starte das Gateway neu.

---

Du hast noch Fragen zum Setup? Der AI Setup Assistant hilft dir direkt weiter.

Nächste Schritte

• Gateway Security Guide
• Custom Agent Setup
• CLI Reference
• Troubleshooting Common Errors