Zum Hauptinhalt springen

​
Onboarding-Assistent (CLI)

Der Onboarding-Assistent ist der empfohlene Weg, um OpenClaw auf macOS, Linux oder Windows (über WSL2; dringend empfohlen) einzurichten. Er konfiguriert ein lokales Gateway oder eine entfernte Gateway-Verbindung sowie Kanäle, Skills und Workspace-Standards in einem geführten Ablauf. 
openclaw onboard
Schnellster erster Chat: Öffnen Sie die Control UI (keine Kanal-Einrichtung erforderlich). Führen Sie openclaw dashboard aus und chatten Sie im Browser. Doku: Dashboard.
So konfigurieren Sie später erneut: 
openclaw configure
openclaw agents add <name>
--json impliziert keinen nicht‑interaktiven Modus. Für Skripte verwenden Sie --non-interactive.
Empfohlen: Richten Sie einen Brave-Search-API-Schlüssel ein, damit der Agent web_search verwenden kann (web_fetch funktioniert ohne Schlüssel). Der einfachste Weg: openclaw configure --section web, wodurch tools.web.search.apiKey gespeichert wird. Doku: Web tools.

​
Schnellstart vs. Erweitert

Der Assistent startet mit Schnellstart (Standards) vs. Erweitert (volle Kontrolle).
  • Lokales Gateway (loopback)
  • Workspace-Standard (oder bestehender Workspace)
  • Gateway-Port 18789
  • Gateway-Authentifizierung Token (automatisch generiert, auch bei loopback)
  • Tailscale-Exponierung Aus
  • Telegram- und WhatsApp-Direktnachrichten standardmäßig auf Allowlist (Sie werden nach Ihrer Telefonnummer gefragt)

​
Was der Assistent konfiguriert

Lokaler Modus (Standard) führt Sie durch folgende Schritte:
  1. Modell/Auth — Anthropic-API-Schlüssel (empfohlen), OAuth, OpenAI oder andere Anbieter. Wählen Sie ein Standardmodell.
  2. Workspace — Speicherort für Agent-Dateien (Standard ~/.openclaw/workspace). Initialisiert Bootstrap-Dateien.
  3. Gateway — Port, Bind-Adresse, Authentifizierungsmodus, Tailscale-Exponierung.
  4. Kanäle — WhatsApp, Telegram, Discord, Google Chat, Mattermost, Signal, BlueBubbles oder iMessage.
  5. Daemon — Installiert einen LaunchAgent (macOS) oder eine systemd-Benutzereinheit (Linux/WSL2).
  6. Health-Check — Startet das Gateway und überprüft, ob es läuft.
  7. Skills — Installiert empfohlene Skills und optionale Abhängigkeiten.
Ein erneutes Ausführen des Assistenten löscht nichts, es sei denn, Sie wählen ausdrücklich Reset (oder übergeben --reset). Wenn die Konfiguration ungültig ist oder veraltete Schlüssel enthält, fordert der Assistent Sie auf, zuerst openclaw doctor auszuführen.
Der Remote-Modus konfiguriert nur den lokalen Client für die Verbindung zu einem Gateway an einem anderen Ort. Er installiert oder ändert nichts auf dem entfernten Host.

​
Weiteren Agenten hinzufügen

Verwenden Sie openclaw agents add <name>, um einen separaten Agenten mit eigenem Workspace, Sitzungen und Authentifizierungsprofilen zu erstellen. Das Ausführen ohne --workspace startet den Assistenten. Was eingerichtet wird:
  • agents.list[].name
  • agents.list[].workspace
  • agents.list[].agentDir
Hinweise:
  • Standard-Workspaces folgen ~/.openclaw/workspace-<agentId>.
  • Fügen Sie bindings hinzu, um eingehende Nachrichten weiterzuleiten (der Assistent kann dies erledigen).
  • Nicht‑interaktive Flags: --model, --agent-dir, --bind, --non-interactive.

​
Vollständige Referenz

Für detaillierte Schritt‑für‑Schritt‑Aufschlüsselungen, nicht‑interaktives Scripting, Signal‑Einrichtung, RPC-API und eine vollständige Liste der Konfigurationsfelder, die der Assistent schreibt, siehe die Wizard-Referenz.

​
Verwandte Dokumente