OpenClaw schnell ausprobieren, aber unsicher wo anfangen? Dieser Guide beschreibt die Vorbereitung vor der Installation (Node-Version und Port 18789), drei Installationsarten und 10-Minuten-Routen, Schritte von der Installation bis zum ersten Chat sowie drei typische Stolpersteine, wenn die Konsole nicht erreichbar ist, plus FAQ – damit Sie unter Windows, Linux, macOS oder Remote-Mac in etwa 10 Minuten zum ersten Chat kommen.
Vor der Installation: Node-Version und Port 18789
OpenClaw 2026 benötigt Node.js v22 oder höher; ältere Versionen können zu Install- oder Build-Fehlern führen. Nvm empfohlen: nvm install 22 && nvm use 22. OpenClaw nutzt standardmäßig Port 18789 für die Web-Konsole. Auf Cloud-Servern oder Remote-Mac müssen Sie 18789 (TCP) in der Firewall/Security-Group freigeben, sonst ist die Konsole im Browser nicht erreichbar.
- Node-Version: Im Terminal
node -vausführen; muss ≥ v22.0.0 sein. - Port 18789: Eingehend 18789 auf dem Host erlauben; unter Linux mit ufw:
ufw allow 18789.
Drei Installationsarten und 10-Minuten-Routenwahl
Je nach Umgebung und Vorliebe wählen Sie eine der drei Optionen; Ziel ist, in etwa 10 Minuten installiert zu sein und die Konsole zu öffnen.
| Methode | Für wen | Typische Dauer | Hinweise |
|---|---|---|---|
| Offizielles Install-Skript | Einsteiger, lokaler oder VPS-Schnelltest | ca. 5–10 Min. | curl -fsSL https://openclaw.ai/install.sh | bash; Skript prüft und installiert Node. |
| npm global install | Entwickler mit bereits Node 22+ | ca. 5–8 Min. | npm install -g openclaw@latest, danach openclaw onboard und openclaw gateway. |
| Docker / vorgefertigtes Image | Teams oder Produktion, isolierte Abhängigkeiten | ca. 10–15 Min. | Offizielles oder Community-Docker-Image nutzen; Port 18789 mappen. Einige Clouds bieten OpenClaw-One-Click-Images. |
npm config set registry https://registry.npmmirror.com.Schritte von der Installation bis zum ersten Chat
Mit Install-Skript und onboard sieht der minimale Weg so aus.
OpenClaw installieren
curl -fsSL https://openclaw.ai/install.sh | bash oder npm install -g openclaw@latest ausführen und auf Abschluss warten.
Setup-Assistent ausführen
openclaw onboard ausführen und Gateway, API usw. nach Aufforderung einrichten; bei Berechtigungsdialog (z. B. macOS) in der GUI erlauben.
Gateway starten
openclaw gateway ausführen (oder systemd/pm2 für Dauerbetrieb); sicherstellen, dass Port 18789 lauscht.
Web-Konsole öffnen
Im Browser http://localhost:18789 (oder Ihre Server-IP:18789) aufrufen und Dashboard öffnen.
Ersten Befehl senden
In der Konsole oder TUI (openclaw tui) einen einfachen Befehl senden und prüfen, dass Modell und Gateway antworten – damit ist der „erste Chat“ erledigt.
Drei Stolpersteine: Port und Konsole nicht erreichbar
Viele bleiben bei „installiert, aber Konsole öffnet sich nicht“ oder Fehlern während onboard hängen. Typische Ursachen und Abhilfe:
- Firewall/Security-Group erlaubt 18789 nicht: In der Cloud eingehende Regel für TCP 18789 hinzufügen; lokal unter Linux mit ufw:
ufw allow 18789und reload. - Node-Version zu alt: Unter Node 22+ können Install oder Lauf fehlschlagen; mit
nvm use 22wechseln oder per System-Paketmanager upgraden und erneut versuchen. - Standard-Token unverändert und gescannt: Nach dem Deploy im Dashboard das Standard-Gateway-Token sofort ändern, um öffentliches Scannen und Missbrauch zu vermeiden; System-Prompt-Länge prüfen, um ungewöhnlichen Token-Verbrauch zu vermeiden.
FAQ
Kommt man wirklich in 10 Minuten zum ersten Chat?
Mit Node 22+ und normalem Netzwerk schaffen die meisten Nutzer mit Install-Skript oder npm global install und der Reihenfolge onboard → gateway → 18789-Konsole öffnen → einen Befehl senden in etwa 10 Minuten den ersten Chat. Bei Netz- oder Berechtigungsproblemen unsere OpenClaw-Troubleshooting- und Deploy-Artikel nutzen.
Warum OpenClaw auf einem Remote-Mac deployen?
Ein Remote-Mac bietet volle GUI (VNC), sodass System-Berechtigungsdialoge und Keychain-Abfragen während onboard direkt geklickt werden können – anders als bei reinem SSH. Passt gut zu unseren anderen OpenClaw-Deploy- und Berechtigungsdialog-Artikeln.
Was macht openclaw doctor?
openclaw doctor führt eine Gesundheitsprüfung durch und hilft, Umgebung, Abhängigkeiten und Konfiguration zu prüfen. Wenn die Konsole nicht startet oder sich seltsam verhält, zuerst doctor ausführen und dann unseren Troubleshooting-Guide nutzen.
Fazit: OpenClaw lässt sich lokal unter Windows, Linux oder auf dem eigenen VPS betreiben, aber Node-Version, Port-Freigabe, Berechtigungsdialoge und Umgebungsprobleme kosten oft Zeit. Wer weniger Umgebungsaufwand und einen schnellen Einstieg inkl. GUI-onboard und Systemberechtigungen will, kann einen Remote-Mac von VNCMac mieten und OpenClaw in der VNC-Oberfläche deployen – so vermeiden Sie lokale Unterschiede und nicht klickbare Dialoge und haben in Minuten einen bereiten Mac mit grafischem Setup. Zur Auswahl siehe unsere Seiten „OpenClaw-Umgebungswahl“ und „Schnellstart“.