OpenClaw CLI Onboarding Guide

Jeder Entwickler kennt das: Ein neues Projekt verspricht Produktivität, aber die Installation fühlt sich an wie ein Hindernislauf durch Dokumentationslücken. Du suchst nach API-Keys, erstellst Verzeichnisse manuell und hoffst, dass die Konfiguration beim ersten Mal funktioniert, statt Zeit mit Debugging zu verschwenden.

Der Onboarding Wizard für die CLI löst genau dieses Problem. Er führt dich durch die notwendigen Schritte, damit du direkt mit dem Coden oder Chatten anfangen kannst, ohne dich in manuellen Config-Dateien zu verlieren.

Voraussetzungen

• macOS oder Linux
• Windows mit WSL2 (dringend empfohlen)
• Ein Terminal deiner Wahl
• Einen API-Key für deinen bevorzugten Model-Provider

Schnellstart

Der Wizard ist der empfohlene Weg für das Setup. Er konfiguriert ein lokales Gateway oder eine Remote-Verbindung, Channels, Skills und Workspace-Defaults in einem geführten Flow. Starte den Prozess mit diesem Befehl:

openclaw onboard

Wenn du sofort chatten willst, ohne Kanäle zu konfigurieren, nutze das Control UI:

openclaw dashboard

Dies öffnet das Dashboard im Browser.

Falls du später Einstellungen ändern oder neue Agents hinzufügen möchtest, helfen dir diese Befehle:

openclaw configure
openclaw agents add <name>

Hinweis: Der Flag --json bedeutet nicht automatisch, dass der Modus non-interaktiv ist. Für Skripte solltest du --non-interactive verwenden.

QuickStart vs Advanced

Der Wizard lässt dir die Wahl zwischen zwei Pfaden:

• QuickStart (Defaults): Nutzt ein lokales Gateway (Port 18789), erstellt einen Standard-Workspace und generiert automatisch einen Auth-Token. Die Tool-Policy wird auf coding gesetzt. Tailscale ist deaktiviert und für Telegram/WhatsApp wird eine Allowlist mit deiner Telefonnummer erstellt.
• Advanced (Full Control): Du behältst die volle Kontrolle über jeden einzelnen Schritt, von der Workspace-Location bis hin zur Daemon-Konfiguration.

Was der Wizard konfiguriert

Im lokalen Modus (Standard) durchläufst du diese Phasen:

1. Model/Auth: Wähle deinen Provider (z. B. OpenAI-kompatibel, Anthropic-kompatibel oder Custom). Du legst hier das Standard-Model fest. Für automatisierte Setups kannst du --secret-input-mode ref nutzen, um API-Keys über Umgebungsvariablen statt im Plaintext zu speichern.
2. Workspace: Hier liegen deine Agent-Dateien (Standard: ~/.openclaw/workspace).
3. Gateway: Konfiguration von Port, Bind-Adresse, Auth-Modus und Tailscale-Optionen.
4. Channels: Verbinde WhatsApp, Telegram, Discord, Google Chat, Mattermost, Signal, BlueBubbles oder iMessage.
5. Daemon: Installiert einen LaunchAgent (macOS) oder eine systemd User Unit (Linux/WSL2), damit OpenClaw im Hintergrund läuft.
6. Health check: Startet das Gateway und prüft die Erreichbarkeit.
7. Skills: Installiert empfohlene Skills und deren Abhängigkeiten.

Der Wizard bietet zudem einen Schritt für die Web-Suche an. Du kannst Provider wie Perplexity, Brave, Gemini, Grok oder Kimi wählen und deinen API-Key hinterlegen, damit dein Agent das Tool web_search nutzen kann.

Fehlerbehebung

• Ungültige Konfiguration: Wenn deine Config veraltet ist oder fehlerhafte Keys enthält, fordert dich der Wizard auf, zuerst openclaw doctor auszuführen.
• Reset: Möchtest du von vorne anfangen? Nutze openclaw onboard --reset. Das löscht Configs, Credentials und Sessions. Mit --reset-scope full wird auch der Workspace entfernt.
• Daemon-Fehler: Die Installation des Daemons wird blockiert, wenn Token-Referenzen nicht aufgelöst werden können oder der Auth-Modus bei gleichzeitigem Vorhandensein von Passwort und Token nicht eindeutig gesetzt ist.

Hast du spezifische Fragen zu deinem Setup? Nutze den AI Setup Assistant.

Nächste Schritte

• CLI Command Reference: openclaw onboard
• Onboarding Overview
• macOS App Onboarding
• Agent Bootstrapping Ritual