openclaw setup

openclaw setup ist der Einstiegspunkt für den System-Agenten. Auf einem konfigurierten System öffnet openclaw setup ohne weitere Argumente einen interaktiven OpenClaw-Chat. Auf einem neuen System wird stattdessen das geführte Onboarding gestartet. Verwenden Sie -m/--message für eine einzelne Anfrage oder --baseline, um Konfigurations-/Workspace-Ordner ohne den Assistenten zu initialisieren.

Routing-Reihenfolge:

1. Jede Onboarding-Option (--wizard, --baseline, Workspace, Zurücksetzen, nicht interaktiv, Ablauf, Modus, Gateway, Daemon, Überspringen, Import, Remote oder Authentifizierungsoptionen) führt das Onboarding genau wie openclaw onboard aus.
2. -m/--message oder --yes führt den System-Agenten aus.
3. Ohne Routing-Option öffnet ein konfiguriertes interaktives System OpenClaw. Auf einem neuen System wird das Onboarding ausgeführt. Auf einem konfigurierten System gibt --json auch ohne TTY die Systemübersicht aus; bei einer Onboarding-Option bleibt die JSON-Zusammenfassung des Onboardings erhalten.

Im geführten Modus ist --workspace <dir> der OpenClaw vorgeschlagene Workspace; er wird erst gespeichert, nachdem Sie diesen Vorschlag genehmigt haben. Die Baseline-, klassische und nicht interaktive Einrichtung speichern bei einer Neuinstallation den angegebenen Workspace im Rahmen ihres normalen Ablaufs. Wenn eine bestehende Agentenliste neu zugeordnet würde, verlangt der klassische Assistent eine ausdrückliche Bestätigung; die nicht interaktive Einrichtung behält den aktuellen Flotten-Workspace bei und gibt eine Warnung aus.

Die geführte Inferenzerkennung wird auf dem Gateway-Host unter macOS oder Linux ausgeführt. Die CLI und die macOS-App verwenden denselben Gateway-eigenen Detektor, der konfigurierte Modelle, unterstützte CLI-Anmeldungen, API-Schlüssel-Umgebungsvariablen und bereits installierte Ollama- oder LM-Studio-Modelle prüft. Lokale Modelle werden bei diesem automatischen Durchlauf niemals heruntergeladen. Erkannte lokale Laufzeitumgebungen werden nach CLI- und API-Schlüssel-Kandidaten automatisch getestet; wenn mehrere lokale Modelle verfügbar sind, bevorzugt OpenClaw die leistungsstärkste für Tool-Aufrufe geeignete Instruct-Familie. Der ausgewählte Kandidat muss eine echte Vervollständigung beantworten, bevor seine Provider- und Modellkonfiguration gespeichert wird. Installierte Gemini-, Antigravity-, Pi- und OpenCode-CLIs werden ebenfalls gemeldet, wenn sie nicht als wiederverwendbare Inferenzroute für die geführte Einrichtung dienen können.

setup akzeptiert dieselben Onboarding-Flags wie openclaw onboard, einschließlich Authentifizierung (--auth-choice, --token, Provider-Schlüssel-Flags), Gateway (--gateway-port, --gateway-bind, --gateway-auth, --install-daemon), Tailscale (--tailscale), Zurücksetzen (--reset, --reset-scope), Ablauf (--flow quickstart|advanced|manual|import) und Überspringen-Flags (--skip-channels, --skip-skills, --skip-bootstrap, --skip-search, --skip-health, --skip-ui, --skip-hooks). Übergeben Sie --tui, um denselben Terminal-Ausweg wie bei openclaw onboard --tui zu verwenden. Die vollständige Flag-Referenz und nicht interaktive Beispiele finden Sie unter Onboarding und CLI-Automatisierung. openclaw onboard --modern bleibt ein Kompatibilitäts- Einstiegspunkt für denselben inferenzabhängigen OpenClaw-Assistenten.

Optionen

--classic und --non-interactive schließen sich gegenseitig aus: Die klassische Variante öffnet den Assistenten mit Eingabeaufforderungen, während die nicht interaktive Einrichtung den Automatisierungspfad verwendet. Beim interaktiven Onboarding füllen --remote-url und --remote-token den Remote-Gateway-Schritt vorab aus und haben für diesen Durchlauf Vorrang vor gespeicherten Remote-Werten. Bei einer Änderung der URL werden gespeicherte Anmeldedaten nur dann wiederverwendet, wenn Sie auch ein Token übergeben. Das Token bleibt maskiert und verwendet den im Assistenten ausgewählten Speicherungsmodus für Klartext oder SecretRef.

Baseline-Modus

openclaw setup --baseline behält das ältere, ausschließlich auf die Baseline beschränkte Verhalten bei: Es erstellt die Konfigurations-, Workspace- und Sitzungsverzeichnisse und wird anschließend beendet, ohne das Onboarding auszuführen. Es akzeptiert --workspace und unbedenkliche Ausgabesteuerungen, lehnt jedoch explizite Onboarding-, Gateway-, Authentifizierungs-, Zurücksetzungs- oder Daemon-Optionen ab, anstatt sie stillschweigend zu ignorieren. Wenn eine vorhandene Konfiguration ungültig ist, behält die Baseline-Einrichtung sie bei und fordert Sie auf, vor einem erneuten Versuch openclaw doctor auszuführen.

Beispiele

openclaw setupopenclaw setup -m "status"openclaw setup -m "restart gateway" --yesopenclaw setup --jsonopenclaw setup --wizardopenclaw setup --baselineopenclaw setup --workspace ~/.openclaw/workspaceopenclaw setup --import-from hermes --import-source ~/.hermesopenclaw setup --non-interactive --accept-risk --mode remote --remote-url wss://gateway-host:18789 --remote-token <token>

Hinweise

• Führen Sie nach der Baseline-Einrichtung openclaw onboard für den vollständigen geführten Ablauf, openclaw configure für gezielte Änderungen oder openclaw channels add aus, um Kanalkonten hinzuzufügen.
• Wenn ein Hermes-Status erkannt wird, kann das interaktive Onboarding automatisch eine Migration anbieten. Das Import-Onboarding erfordert eine neue Einrichtung; verwenden Sie Migrieren für Probelaufpläne, Sicherungen und den Überschreibmodus außerhalb des Onboardings.

Verwandte Themen

• CLI-Referenz
• Onboarding
• Onboarding (CLI)
• Erste Schritte
• Installationsübersicht