First steps
Onboarding-Übersicht
OpenClaw bietet ein Onboarding im Terminal und in der macOS-App. Beide richten zuerst die Inferenz ein: Sie erkennen vorhandenen KI-Zugriff, erfordern eine erfolgreiche Live-Completion und starten erst dann Crestodian, um die verbleibende Einrichtung zu konfigurieren. Ein erreichbarer, konfigurierter Gateway, dessen Standard-Agent bereits über ein konfiguriertes Modell verfügt, überspringt das Onboarding und öffnet die normale Agent-Benutzeroberfläche. Der Terminal-Ablauf bietet außerdem den vollständigen klassischen Assistenten für eine detaillierte Einrichtung.
Welchen Weg sollte ich verwenden?
| CLI-Onboarding | Onboarding in der macOS-App | |
|---|---|---|
| Plattformen | macOS, Linux, Windows (nativ oder mit WSL2) | Nur macOS |
| Oberfläche | Inferenzeinrichtung, dann Crestodian | Inferenzeinrichtung, dann Crestodian |
| Ideal für | Server, Headless-Betrieb, volle Kontrolle | Desktop-Mac, visuelle Einrichtung |
| Automatisierung | --non-interactive für Skripte |
Nur manuell |
| Befehl | openclaw onboard |
App starten |
Die meisten Benutzer sollten mit dem CLI-Onboarding beginnen — es funktioniert überall und bietet Ihnen die größtmögliche Kontrolle.
Was das Onboarding konfiguriert
Die geführte Inferenzphase richtet nur Folgendes ein:
- Modell-Provider und Authentifizierung — erkannter Zugriff oder ein verifizierter API-Schlüssel
- Verifizierte Inferenz — eine echte Completion mit dem effektiven Modell des Standard-Agenten
Nachdem diese Completion erfolgreich war, kann Crestodian den Workspace, den Gateway, den Gateway-Dienst, Kanäle, Agenten, Plugins und weitere optionale Funktionen konfigurieren.
Der klassische CLI-Assistent kann zusätzlich Folgendes konfigurieren:
- Kanäle (optional) — integrierte und gebündelte Chatkanäle wie Discord, Feishu, Google Chat, iMessage, Mattermost, Microsoft Teams, Telegram, WhatsApp und weitere
- Erweiterte Gateway-Steuerung — Remote-Modus, Netzwerkeinstellungen und Daemon-Auswahl
CLI-Onboarding
Führen Sie den folgenden Befehl in einem beliebigen Terminal aus:
openclaw onboardDer geführte Ablauf erkennt vorhandenen KI-Zugriff, testet Kandidaten der Reihe nach live,
wechselt bei einem Fehler zum nächsten und bietet eine maskierte manuelle Schlüsseleingabe an. Er speichert das
Modell und die Anmeldedaten erst nach einer erfolgreichen Completion und startet anschließend Crestodian,
um den Workspace, den Gateway, Kanäle, Agenten, Plugins und weitere
optionale Funktionen zu konfigurieren. Es gibt weder Crestodian vor der Inferenz noch einen Pfad zum Überspringen der KI oder
eine Übergabe an den klassischen Assistenten innerhalb des Ablaufs. Beenden Sie den Vorgang und führen Sie openclaw onboard --classic aus, wenn Sie
stattdessen den klassischen Assistenten verwenden möchten.
Nach erfolgreicher Inferenz kann Crestodian die Kanaleinrichtung an einen Terminal-Assistenten
mit maskierter Eingabe übergeben. Dabei wird weder die geführte noch die klassische Provider-Einrichtung geöffnet. Beenden Sie Crestodian und
führen Sie openclaw onboard aus, um den Modell-Provider oder dessen Authentifizierung zu ändern.
Verwenden Sie openclaw onboard --classic für die detaillierte Einrichtung von Modell und Authentifizierung, Kanälen, Skills,
Remote-Gateway oder Importen. Durch Hinzufügen von --install-daemon wird ebenfalls der
klassische Ablauf ausgewählt und der Hintergrunddienst in einem Schritt installiert. Verwenden Sie openclaw crestodian für die dialogbasierte Einrichtung und Reparatur außerhalb der Inferenz. openclaw onboard --modern ist ein Kompatibilitätsalias, der dieselbe Live-Inferenz-
Prüfung verwendet.
Vollständige Referenz: Onboarding (CLI)
Dokumentation zum CLI-Befehl: openclaw onboard
Onboarding in der macOS-App
Öffnen Sie die OpenClaw-App. Wenn ihr konfigurierter lokaler oder entfernter Gateway erreichbar ist und der Standard-Agent bereits über ein konfiguriertes Modell verfügt, überspringt die App das Onboarding und Crestodian und öffnet sofort die normale Agent-Benutzeroberfläche.
Bei einem neuen oder unvollständig eingerichteten Gateway erkennt der Ablauf beim ersten Start vorhandenen KI- Zugriff (Claude Code, Codex oder API-Schlüssel), testet die beste Option live und speichert sie erst nach einer echten Antwort — mit automatischem Rückgriff auf Alternativen und einem verifizierten Schritt zur manuellen Eingabe eines API-Schlüssels, wenn nichts gefunden wird. Vertrauliche Anmeldedaten werden maskiert eingegeben. Sobald die Inferenz erfolgreich ist, startet Crestodian und hilft bei der Konfiguration der übrigen Komponenten.
Gemini CLI bleibt nach der Einrichtung für normale Agenten verfügbar, wird für diese Inferenzprüfung jedoch nicht angeboten, da damit die Ausführung der Prüfung ohne Tools nicht erzwungen werden kann.
Vollständige Referenz: Onboarding (macOS-App)
Benutzerdefinierte oder nicht aufgeführte Provider
Wenn Ihr Provider nicht aufgeführt ist, führen Sie openclaw onboard --classic aus, wählen Sie
Benutzerdefinierter Provider und geben Sie Folgendes ein:
- Endpoint-Kompatibilität: OpenAI-kompatibel (
/chat/completions), mit OpenAI Responses kompatibel (/responses), Anthropic-kompatibel (/messages) oder unbekannt (prüft alle drei und erkennt sie automatisch) - Basis-URL und API-Schlüssel (der API-Schlüssel ist optional, wenn der Endpoint keinen erfordert)
- Modell-ID und optionaler Modellalias
Mehrere benutzerdefinierte Endpoints können gleichzeitig vorhanden sein — jeder erhält eine eigene Endpoint-ID.
