OpenClaw
6 Schritte zum Bereitstellen

OpenClaw Erste Schritte

Folgen Sie diesen Schritten, um OpenClaw von Grund auf zu installieren und zu konfigurieren

Schnellster Weg

Möchten Sie es nur ausprobieren? Ein Befehl startet das Dashboard für sofortiges Chatten:

$ openclaw dashboard
http://127.0.0.1:18789/

OpenClaw-Anforderungen

Bevor Sie beginnen, stellen Sie sicher, dass Ihr System diese Anforderungen erfüllt

Node.js ≥ 22

Erforderlich zum Ausführen von OpenClaw

Betriebssystem

macOS, Linux oder Windows (WSL2 empfohlen)

Brave Search API (Optional)

Aktiviert die Websuchfunktion

Windows
Windows-Benutzern wird dringend empfohlen, WSL2 für bessere Kompatibilität und Leistung zu verwenden.
1

OpenClaw installieren

Wählen Sie Ihre bevorzugte Installationsmethode. Der Einzeiler wird empfohlen

$ curl -fsSL https://openclaw.bot/install.sh | bash
Der Einzeiler erkennt und installiert automatisch Node.js und alle Abhängigkeiten. Keine manuelle Einrichtung erforderlich.
2

OpenClaw-Konfigurationsassistent

Der Assistent führt Sie durch alle notwendigen Einrichtungen einschließlich Gateway, Authentifizierung und Chat-Plattform-Verbindungen

$ openclaw onboard --install-daemon

Der Assistent konfiguriert

  • Gateway-Typ - Wählen Sie lokales oder Remote-Gateway
  • KI-Modell-Authentifizierung - OpenAI (OAuth/API-Schlüssel) oder Anthropic (API-Schlüssel empfohlen, claude setup-token auch unterstützt)
  • Chat-Plattformen - WhatsApp QR-Code, Telegram/Discord Bot-Token usw.
  • Daemon-Dienst - Hintergrunddienst-Installation (macOS: launchd, Linux/WSL2: systemd)
Speicherorte der Konfigurationsdateien (Wichtig)
  • Haupt-Konfigurationsverzeichnis~/.openclaw/
  • OAuth-Anmeldedaten~/.openclaw/credentials/oauth.json
  • Authentifizierungsprofile (OAuth + API-Schlüssel)~/.openclaw/agents/<agentId>/agent/auth-profiles.json
Wenn Sie Claude Code installiert haben, können Sie vorhandene Anmeldedaten über claude setup-token ohne Neukonfiguration wiederverwenden.
Headless-Server-Tipp: Schließen Sie OAuth zuerst auf einem Computer mit Browser ab und kopieren Sie dann die oauth.json-Datei in das entsprechende Verzeichnis des Servers.
3

OpenClaw-Gateway starten

Das Gateway ist der Kerndienst von OpenClaw, der alle Nachrichten verarbeitet

Dienststatus prüfen

$ openclaw gateway status

Gateway manuell starten (um Port anzugeben)

$ openclaw gateway --port 18789

Web-Dashboard aufrufen

http://127.0.0.1:18789/
Schnellverifizierung (bestätigen, dass der Dienst läuft)
$ openclaw status
$ openclaw health
$ openclaw security audit --deep
4

Chat-Plattformen verbinden

Koppeln und verbinden Sie Ihre erste Chat-Schnittstelle

WhatsApp (QR-Code-Anmeldung)

$ openclaw channels login

Führen Sie den Befehl aus, um einen QR-Code anzuzeigen. Öffnen Sie WhatsApp → Einstellungen → Verknüpfte Geräte → Scannen Sie den QR-Code zum Verbinden.

Eine dedizierte Telefonnummer wird empfohlen. VoIP-Nummern werden nicht empfohlen (leicht blockiert). Anmeldedaten werden im Verzeichnis ~/.openclaw/credentials/whatsapp/ gespeichert.

Telegram / Discord / Andere

Der Assistent kann bei der Token-Konfiguration helfen. Wenn Sie manuelle Einrichtung bevorzugen, siehe diese Dokumentation:

Telegram-Tipp: Ihre erste DM gibt einen Kopplungscode zurück. Sie müssen ihn genehmigen (siehe nächster Schritt), sonst antwortet der Bot nicht.
5

OpenClaw-Sicherheitseinrichtung

Stellen Sie sicher, dass nur autorisierte Benutzer Ihren KI-Assistenten nutzen können

Standardverhalten: Unbekannte DMs erhalten einen kurzen Code, und Nachrichten werden nicht verarbeitet, bis sie genehmigt sind. Wenn Ihre erste DM keine Antwort erhält, genehmigen Sie die Kopplung:

Ausstehende Kopplungsanfragen auflisten

$ openclaw pairing list whatsapp

Kopplung genehmigen (ersetzen Sie [code] durch den tatsächlichen Code)

$ openclaw pairing approve whatsapp <code>
Dies ist eine wichtige Sicherheitsmaßnahme, um unbefugten Zugriff zu verhindern. Sie können auch eine Erlaubnisliste in der Konfigurationsdatei einrichten, um bestimmte Nummern automatisch zu erlauben.
6

OpenClaw verifizieren

Senden Sie in einem neuen Terminal eine Testnachricht

Testnachricht senden (ersetzen Sie mit Ihrer Zielnummer)

$ openclaw message send --target +15555550123 --message "Hello from OpenClaw"
Wenn openclaw health "auth not configured" anzeigt, gehen Sie zurück zum Assistenten und richten Sie OAuth/API-Schlüssel-Authentifizierung ein—ohne sie antwortet der Agent nicht.

Debug-Tipps

  • openclaw status --allBester kopier- und einfügbarer, schreibgeschützter Debug-Bericht
  • openclaw healthoderopenclaw status --deepFordert Gesundheits-Snapshot vom laufenden Gateway an

OpenClaw-Einrichtung abgeschlossen

Herzlichen Glückwunsch! Sie haben OpenClaw erfolgreich installiert und konfiguriert. Beginnen Sie jetzt mit Ihrem KI-Assistenten zu chatten.