OpenClaw Onboarding: Dein Guide zum CLI-Setup

Kennst du das? Du willst ein neues Tool ausprobieren, aber verbringst die erste Stunde damit, Config-Dateien manuell zu editieren, API-Keys in .env-Files zu jagen und Hintergrunddienste mühsam zu bändigen. Oft scheitert der Flow schon an der ersten Fehlermeldung, weil eine Abhängigkeit fehlt oder der Pfad zum Workspace nicht stimmt.

Genau hier setzt der openclaw onboard Wizard an. Er nimmt dir das Rätselraten ab und führt dich Schritt für Schritt durch die Konfiguration, damit dein Agent schnell einsatzbereit ist. Ich empfehle diesen Weg gegenüber der manuellen Bearbeitung der JSON-Dateien, da der Wizard direkt Validierungen durchführt.

Voraussetzungen

Bevor du startest, stelle sicher, dass du folgende Voraussetzungen erfüllst:

• Node.js (empfohlen; zwingend erforderlich für WhatsApp und Telegram)
• Einen API-Key oder OAuth-Zugang (z. B. Anthropic, OpenAI oder MiniMax)
• Java 21 (nur falls du Signal über JVM-Builds nutzt)
• macOS oder Linux/Windows mit WSL2

Schnellstart

Der schnellste Weg zum fertigen Setup führt über dein Terminal. Starte den interaktiven Prozess mit diesem Befehl:

openclaw onboard

Der Wizard erkennt automatisch, ob bereits eine Konfiguration unter ~/.openclaw/openclaw.json existiert. Du kannst dann entscheiden, ob du bestehende Einstellungen behalten, ändern oder mit --reset komplett neu starten möchtest.

Der Local Flow im Detail

Wenn du den Local Mode nutzt, führt dich der Wizard durch diese Kernbereiche:

1. Model und Auth: Du kannst Anthropic (API-Key oder OAuth via Claude Code), OpenAI, xAI, MiniMax oder einen Vercel/Cloudflare AI Gateway anbinden.
2. Workspace: Der Wizard erstellt ~/.openclaw/workspace und legt die für den ersten Start benötigten Bootstrap-Dateien an.
3. Gateway: Hier legst du Port und Bind-Adresse fest. Aktiviere die Token-Auth auch für Loopback-Verbindungen, damit lokale Clients sich authentifizieren müssen.
4. Channels: Du kannst Messenger wie Telegram (Bot Token), Discord oder WhatsApp (QR-Login) konfigurieren. Für Signal lädt der Wizard bei Bedarf das signal-cli Tool herunter.
5. Daemon Install: Auf macOS wird ein LaunchAgent erstellt, auf Linux/WSL2 ein systemd User Unit. Der Wizard nutzt loginctl enable-linger, damit das Gateway nach dem Logout aktiv bleibt.

Remote Mode

Falls du diese Maschine nur als Client für ein Gateway nutzen willst, das woanders läuft, verwende den Remote Mode. Hierbei werden keine lokalen Dienste installiert. Du gibst lediglich die Remote Gateway URL (z. B. ws://...) und das benötigte Token an.

Fehlerbehebung

Falls etwas nicht nach Plan läuft, nutze diese Lösungsansätze aus der Dokumentation:

• Legacy Keys: Wenn deine Konfiguration veraltet ist, stoppt der Wizard. Führe openclaw doctor aus, um die Fehler zu beheben.
• Headless Server: Wenn keine GUI erkannt wird, gibt dir der Wizard SSH-Port-Forwarding-Anweisungen aus, damit du das Control UI im Browser deines lokalen Rechners öffnen kannst.
• Model-Warnungen: Der Wizard führt einen Health Check durch. Falls ein Model unbekannt ist oder Auth-Daten fehlen, erhältst du sofort einen Hinweis.
• Permission-Probleme: Bei der Installation des Daemons unter Linux wird eventuell nach sudo gefragt, um Linger-Optionen für den User zu schreiben.

Hast du spezifische Fragen zu deinem Setup? Nutze den AI Setup Assistant für direkte Hilfe.

Nächste Schritte

• Onboarding Hub: Onboarding Wizard (CLI)
• Automatisierung: CLI Automation
• Befehlsübersicht: openclaw onboard
• Workspace-Struktur: Agent workspace