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) - Legt jeden Schritt offen (Modus, Workspace, Gateway, Kanäle, Daemon, Skills).

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¶

• CLI-Befehlsreferenz: openclaw onboard
• macOS-App-Onboarding: Onboarding
• Agent-Erststart‑Ritual: Agent Bootstrapping