Einrichtung (CLI)

openclaw onboard

Das CLI-Onboarding ist der empfohlene Einrichtungsweg im Terminal unter macOS, Linux und Windows (nativ oder WSL2). Standardmäßig erkennt es den bereits auf dem Rechner verfügbaren KI-Zugriff, überprüft ihn mit einer echten Vervollständigung und startet Crestodian, um den Arbeitsbereich, das Gateway und optionale Funktionen zu konfigurieren. openclaw setup führt denselben Ablauf aus (Einrichtung beschreibt die reine Konfigurationsvariante --baseline). Benutzer der Windows-Desktopanwendung können auch über den Windows Hub beginnen.

Das geführte Onboarding richtet zuerst die Inferenz ein. Es erkennt verfügbaren KI-Zugriff, erfordert eine echte Vervollständigung und startet erst danach Crestodian, um den Rest von OpenClaw zu konfigurieren. Im geführten Ablauf gibt es weder Crestodian vor der Inferenz noch eine Möglichkeit, die KI-Einrichtung zu überspringen.

Der klassische Assistent bleibt für die Provider-Anmeldung, die Einrichtung eines entfernten Gateways, die Kanalkopplung, Daemon-Steuerung, Skills und Importe verfügbar. Starten Sie ihn ausdrücklich mit openclaw onboard --classic; der Kandidatenauswahlbildschirm der geführten Inferenz leitet nicht zu ihm weiter. Nach erfolgreicher Inferenz kann Crestodian mit open channel wizard for <channel> die Kanaleinrichtung, für die Geheimnisse erforderlich sind, an einen Terminalassistenten mit maskierter Eingabe übergeben. Um den Modell-Provider oder dessen Authentifizierung zu ändern, beenden Sie Crestodian und führen Sie openclaw onboard aus; Crestodian öffnet weder geführte noch klassische Provider-Abläufe.

Gebietsschema

Der Assistent lokalisiert die festen Onboarding-Texte. Auflösungsreihenfolge: OPENCLAW_LOCALE, LC_ALL, LC_MESSAGES, LANG, dann Englisch. Unterstützte Gebietsschemata: en, zh-CN, zh-TW.

OPENCLAW_LOCALE=zh-CN openclaw onboard

Produktnamen, Befehle, Konfigurationsschlüssel, URLs, Provider-IDs, Modell-IDs sowie Plugin- und Kanalbezeichnungen bleiben unabhängig vom Gebietsschema auf Englisch.

So konfigurieren Sie Einstellungen, die nicht die Inferenz betreffen, später neu:

openclaw configureopenclaw agents add <name>

Geführter Standardablauf

Ein einfacher Aufruf von openclaw onboard folgt diesem Ablauf:

1. Akzeptieren Sie den Sicherheitshinweis.
2. Erkannte konfigurierte Modelle, Umgebungsvariablen für API-Schlüssel und unterstützte lokale KI-CLIs werden ermittelt.
3. Der erste erkannte Kandidat wird mit einer echten Vervollständigung getestet. Bei einem Fehler wird der Grund angezeigt und mit dem nächsten verwendbaren Kandidaten fortgefahren.
4. Wenn die Erkennung keine weiteren Kandidaten liefert, wiederholen Sie den Versuch mit einem erkannten Kandidaten oder geben Sie einen Provider-API-Schlüssel in einer maskierten Eingabeaufforderung ein. Das geführte Onboarding bietet weder Crestodian noch eine Möglichkeit zum Überspringen der KI-Einrichtung an, bevor die Inferenz funktioniert.
5. Nur die überprüfte Modellroute und alle dafür erforderlichen Anmeldedaten- oder Plugin-Zustände werden gespeichert. Die Einstellungen für Arbeitsbereich und Gateway bleiben unverändert.
6. Crestodian wird mit dem überprüften Modell gestartet, damit es den Arbeitsbereich, das Gateway, Kanäle, Agenten, Plugins und die verbleibende optionale Einrichtung konfigurieren kann.

Bei erneuter Ausführung des Befehls in einer konfigurierten Installation wird zuerst das aktuelle Standardmodell getestet. Dadurch dient der geführte Ablauf als Überprüfungs- und Reparaturdurchlauf. Eine fehlgeschlagene Prüfung ersetzt das konfigurierte Modell niemals automatisch; das Onboarding wird angehalten und fragt, wie fortgefahren werden soll. Führen Sie für spätere Ergänzungen, die nicht die Inferenz betreffen, openclaw channels add oder openclaw configure aus; verwenden Sie openclaw onboard für Änderungen am Provider oder an der Authentifizierungsroute.

Klassischer Assistent: QuickStart oder Advanced

Führen Sie openclaw onboard --classic aus, um den vollständigen Assistenten zu öffnen. Er beginnt mit einer Auswahl zwischen QuickStart (Standardeinstellungen) und Advanced (vollständige Kontrolle). Übergeben Sie --flow quickstart oder --flow advanced (Alias manual), um den klassischen Ablauf auszuwählen und diese Abfrage zu überspringen.

Der entfernte Modus (--mode remote) verwendet immer den erweiterten Ablauf; er konfiguriert lediglich diesen Rechner für die Verbindung mit einem anderen Gateway und installiert oder ändert niemals etwas auf dem entfernten Host.

Was das klassische Onboarding konfiguriert

Der lokale Modus (Standard) führt durch diese Schritte:

1. Modell/Authentifizierung – Wählen Sie einen Authentifizierungsablauf für einen Provider (API-Schlüssel, OAuth oder eine Provider-spezifische manuelle Authentifizierung), einschließlich eines benutzerdefinierten Providers (OpenAI-kompatibel, mit OpenAI Responses kompatibel, Anthropic-kompatibel oder automatische Erkennung als unbekannt). Wählen Sie ein Standardmodell. Eine neue Einrichtung mit OpenAI-API-Schlüssel verwendet standardmäßig openai/gpt-5.6 (die einfache direkte API-ID wird als Sol aufgelöst); eine neue ChatGPT-/Codex-Einrichtung verwendet standardmäßig openai/gpt-5.6-sol. Bei erneuter Ausführung der Einrichtung bleibt ein vorhandenes, ausdrücklich festgelegtes Modell erhalten, einschließlich openai/gpt-5.5. Wählen Sie openai/gpt-5.5 ausdrücklich aus, wenn das Konto GPT-5.6 nicht bereitstellt. Sicherheitshinweis: Wenn dieser Agent Werkzeuge ausführt oder Webhook-/Hook-Inhalte verarbeitet, verwenden Sie vorzugsweise das stärkste verfügbare Modell der neuesten Generation und halten Sie die Werkzeugrichtlinie streng – schwächere oder ältere Modellklassen sind anfälliger für Prompt-Injection. Bei nicht interaktiven Ausführungen speichert --secret-input-mode ref umgebungsvariablenbasierte Referenzen anstelle von API-Schlüsselwerten im Klartext; die referenzierte Umgebungsvariable muss bereits gesetzt sein, andernfalls bricht das Onboarding sofort ab. Im interaktiven Modus für Geheimnisreferenzen kann auf eine Umgebungsvariable oder eine konfigurierte Provider-Referenz (file oder exec) verwiesen werden; vor dem Speichern erfolgt eine schnelle Vorabprüfung. Nach der Modell- und Authentifizierungseinrichtung bietet der Assistent einen optionalen Live-Test der Vervollständigung an. Bei einem Fehler kann einmal zur Modell- und Authentifizierungseinrichtung zurückgekehrt oder der Fehler ignoriert werden, ohne den übrigen klassischen Assistenten zu blockieren. Durch das Ignorieren wird Crestodian nicht freigeschaltet; die dialogbasierte Einrichtung erfordert weiterhin eine erfolgreiche Inferenzprüfung.
2. Arbeitsbereich – Verzeichnis für Agentendateien (Standard: ~/.openclaw/workspace). Erstellt die Bootstrap-Dateien.
3. Gateway – Port, Bindungsadresse, Authentifizierungsmodus und Tailscale-Bereitstellung. Wählen Sie im interaktiven Token-Modus zwischen der Speicherung des Tokens im Klartext (Standard) und einer SecretRef. Nicht interaktiver SecretRef-Pfad: --gateway-token-ref-env <ENV_VAR>.
4. Kanäle – Integrierte Chatkanäle und Chatkanäle offizieller Plugins, darunter Discord, Feishu, Google Chat, iMessage, Mattermost, Microsoft Teams, QQ Bot, Signal, Slack, Telegram, WhatsApp und weitere.
5. Daemon – Installiert einen LaunchAgent (macOS), eine systemd-Benutzereinheit (Linux/WSL2) oder eine native geplante Windows-Aufgabe mit einem benutzerspezifischen Fallback über den Autostartordner. Wenn Token-Authentifizierung erforderlich ist und gateway.auth.token über SecretRef verwaltet wird, überprüft die Daemon-Installation den Token, speichert einen aufgelösten Token jedoch nicht in den Umgebungsmetadaten des Supervisor-Dienstes. Eine nicht auflösbare SecretRef blockiert die Installation und zeigt entsprechende Hinweise an. Wenn sowohl gateway.auth.token als auch gateway.auth.password gesetzt sind, während gateway.auth.mode nicht gesetzt ist, wird die Installation blockiert, bis Sie den Modus ausdrücklich festlegen.
6. Integritätsprüfung – Startet das Gateway und überprüft dessen Erreichbarkeit.
7. Skills – Installiert empfohlene Skills und deren optionale Abhängigkeiten.

--flow import führt im klassischen Assistenten anstelle einer neuen Einrichtung einen erkannten Migrationsablauf aus (beispielsweise Hermes); siehe Migration und die Migrationsanleitungen unter Installation. openclaw onboard --modern ist ein Kompatibilitätsalias für Crestodian. Es verwendet dieselbe Inferenzprüfung wie openclaw crestodian: Bei überprüfter Inferenz wird der Assistent gestartet, während ein interaktiver Fehler zur geführten Inferenzeinrichtung zurückführt.

Weiteren Agenten hinzufügen

Verwenden Sie openclaw agents add <name>, um einen separaten Agenten mit eigenem Arbeitsbereich, eigenen Sitzungen und eigenen Authentifizierungsprofilen zu erstellen. Eine Ausführung ohne --workspace startet einen interaktiven Ablauf für Name, Arbeitsbereich, Authentifizierung, Kanäle und Bindungen – dies ist nicht der vollständige Assistent von openclaw onboard.

Festgelegte Werte:

• agents.list[].name
• agents.list[].workspace
• agents.list[].agentDir

Hinweise:

• Standardarbeitsbereich: ~/.openclaw/workspace-<agentId> (oder unter agents.defaults.workspace, falls dies festgelegt ist).
• Fügen Sie bindings hinzu, um eingehende Nachrichten an diesen Agenten weiterzuleiten (das Onboarding kann dies für Sie übernehmen).
• Nicht interaktive Flags: --model, --agent-dir, --bind, --non-interactive.

Vollständige Referenz

Ausführliche Informationen zum schrittweisen Verhalten und zu den Konfigurationsausgaben finden Sie in der Referenz zur CLI-Einrichtung. Nicht interaktive Beispiele finden Sie unter CLI-Automatisierung. Die vollständige Flag-Referenz finden Sie unter openclaw onboard.

Verwandte Dokumentation

• CLI-Befehlsreferenz: openclaw onboard
• Onboarding-Übersicht: Onboarding-Übersicht
• Onboarding der macOS-App: Onboarding
• Ritual beim ersten Start eines Agenten: Agenten-Bootstrapping