OpenClaw Installationsleitfaden: Von der Umgebungsvorbereitung bis zum ersten Start

Aktualisiert am 2026-06-08: Anhand der offiziellen OpenClaw-Doku Node-Version (v24 empfohlen, mindestens v22.14+), das Ein-Zeilen-Skript und den onboard-Ablauf geprüft sowie Weiterlesen-Links aus derselben Serie ergänzt. Befehle und Ports folgen der offiziellen Doku.

Die OpenClaw-Installation verläuft erfreulich reibungslos – egal ob Mac, Linux oder Windows: Wer dieser Anleitung folgt, sollte keine großen Stolpersteine finden. Der Artikel richtet sich an alle, die mit der Kommandozeile noch nicht so vertraut sind, aber OpenClaw ausprobieren möchten – hier ist die Installation systematisch zusammengefasst.

Günstiger Einstieg: ArkClaw macht KI-Agenten wirklich zugänglich

OpenClaw (der „Hummer“) ist beliebt, aber die Einrichtung schreckt viele ab? ByteDance Volcano Engine bringt mit ArkClaw die Hürde auf ein Minimum. Kein Server-Gefummel, keine Token-Konfiguration – mit einem Klick haben Sie einen 24/7-online Agent, der Browser steuert, Skripte ausführt und Kalender verwaltet.

Das Wichtigste: wirklich günstig – 9,9 Yuan/Monat, mit meinem Einladungscode ZLKUK54M (hier registrieren) nur 8,9 Yuan. Als Entwickler lohnt sich Coding Plan Pro sogar kostenlos.

Was ist OpenClaw?

Bevor wir installieren, kurz die Frage: Was ist OpenClaw eigentlich? Kurz gesagt: eine Open-Source-KI-Assistenten-Plattform, die große Sprachmodelle wie ChatGPT und Claude mit Ihren gewohnten Chat-Tools verbindet – etwa Telegram oder WhatsApp.

Warum lokal installieren, wenn es Web-KI gibt?

Beides hat Vorteile. Bei lokaler Installation können Sie:

• Daten und Privatsphäre selbst kontrollieren
• Funktionen und Skills individuell anpassen
• KI in Ihren Workflow einbinden
• Bei entsprechendem Aufwand sogar lokale Modelle nutzen – ganz ohne Cloud-Abhängigkeit

Persönlich reizt mich vor allem die Telegram-Anbindung: KI im Chat aufrufen, ohne zwischen Apps zu wechseln.

Vorbereitung: System prüfen

OpenClaw ist bei den Systemanforderungen recht unkompliziert. Trotzdem sollten Sie vor dem Start ein paar Dinge klären.

Betriebssystem-Kompatibilität

OpenClaw unterstützt macOS und Linux nativ. Unter Windows beschreibt die offizielle Installationsdokumentation sowohl nativ Windows als auch WSL2; wer die Linux-Befehle unten 1:1 nutzen will, ist mit WSL2 meist am schnellsten unterwegs.

WSL2 ist eine leichte Linux-Umgebung unter Windows. Installation in PowerShell mit einem Befehl:

wsl --install

Nach der Installation Rechner neu starten, dann in PowerShell wsl eingeben – schon sind Sie in der Linux-Umgebung.

Hardware-Anforderungen

OpenClaw ist hardwareseitig anspruchslos. Offizielle Empfehlung:

• Arbeitsspeicher: 8 GB reichen, 16 GB sind besser
• Speicher: mindestens 20 GB frei (SSD empfohlen – spürbar angenehmer)

Wer einen Browser flüssig nutzen kann, kann OpenClaw in der Regel auch betreiben. Auf einem älteren MacBook mit 8 GB RAM läuft es bei mir problemlos.

Node.js-Umgebung

Der wichtigste Schritt. OpenClaw basiert auf Node.js – Node muss zuerst installiert sein. Laut offizieller Installationsdokumentation: Node 24 empfohlen, Minimum Node 22.14+; das Ein-Klick-Skript warnt bei zu alter Version oder hilft bei der Behebung.

Mit nvm empfiehlt sich 24 als tägliche Entwicklungsversion.

Node.js unter macOS

Am einfachsten mit Homebrew:

Vultr - Hochleistungs-NVMe-Cloud-Server mit 32 Standorten weltweit, Docker per Klick

Preise ansehen →Anzeige

# Homebrew installieren, falls noch nicht vorhanden
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Node.js installieren
brew install node

Node.js unter Linux

Unter Linux empfehle ich nvm (Node Version Manager) – einfacher Wechsel zwischen Node-Versionen:

# nvm installieren
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

# Terminal neu starten, dann Node.js installieren (24 empfohlen)
nvm install 24
nvm use 24

Node.js unter Windows (WSL2)

In WSL2 wie unter Linux – mit nvm.

Danach Version prüfen:

node --version

Ausgabe v22.14+ oder v24.x (empfohlen) – damit sind die aktuellen offiziellen Anforderungen erfüllt.

Paketmanager: npm oder pnpm?

Mit Node.js kommt npm (Node Package Manager) mit. OpenClaw funktioniert damit problemlos.

Wer pnpm kennt, kann alternativ pnpm nutzen – Vorteile:

• schnellere Installation
• weniger Speicherplatz
• strengere Abhängigkeitsverwaltung

Für die meisten Nutzer ist beides in Ordnung. Ich persönlich nutze pnpm – Geschmackssache.

pnpm installieren:

npm install -g pnpm

OpenClaw installieren

Nach der Vorbereitung geht es los. OpenClaw bietet mehrere Installationswege – nach Empfehlung sortiert.

Methode 1: Offizielles Installationsskript (am empfohlensten)

Am einfachsten – ein Befehl:

curl -fsSL https://openclaw.ai/install.sh | bash

Das Skript übernimmt automatisch:

• Systemprüfung
• Installation nötiger Abhängigkeiten
• Download und Installation der OpenClaw CLI
• Hinweis auf die Erstkonfiguration

Dauer etwa 1–2 Minuten, abhängig von der Verbindung. Beim ersten Mal mit den Log-Ausgaben im Terminal – erfüllend.

Methode 2: Globale npm-Installation

Wer Paketmanager bevorzugt:

npm install -g openclaw@latest

@latest stellt die neueste Version sicher. Danach steht openclaw im Terminal zur Verfügung.

Methode 3: Globale pnpm-Installation

Mit pnpm:

pnpm add -g openclaw@latest

Gleiches Ergebnis wie npm – nur anderes Tool.

Methode 4: Installation aus dem Quellcode (fortgeschritten)

Für Entwickler oder Mitwirkende am Projekt – Repository von GitHub klonen:

# Repository klonen
git clone https://github.com/openclaw/openclaw.git

# In Verzeichnis wechseln
cd openclaw

# Abhängigkeiten installieren
pnpm install

# Build
pnpm ui:build

Für normale Nutzer nicht empfohlen.

Erstkonfiguration: OpenClaw zum Laufen bringen

Nach der Installation folgt der Konfigurationsassistent – wichtig, aber unkompliziert.

Onboard-Assistent ausführen

Im Terminal:

openclaw onboard --install-daemon

Startet einen interaktiven Assistenten. --install-daemon installiert OpenClaw als Systemdienst – Autostart beim Boot, kein manuelles Starten nach jedem Terminal-Schließen.

Der Assistent stellt nacheinander Fragen:

🔥 Verschwende keine Monate für ungenutzte Produkte! Teste deine SaaS-Nutzenversprechen mit Adsterra bei kleinem Budget ➡️

Jetzt testen →Anzeige

1. Betriebsmodus wählen

In der Regel Local gateway – außer Sie deployen auf einen Remote-Server.

2. KI-Modell konfigurieren

KI-Anbieter auswählen. Derzeit unterstützt:

• OpenAI (GPT-5 usw.)
• Anthropic (Claude-Serie)
• Lokale Modelle (zusätzliche Konfiguration nötig)

OpenAI- oder Anthropic-API-Key hier eingeben – oder vorerst überspringen und später nachholen.

API-Keys beschaffen:

• OpenAI: Konto auf platform.openai.com, Key unter API keys erzeugen
• Anthropic: Konto auf console.anthropic.com, Key in den API-Einstellungen erzeugen

3. Arbeitsverzeichnis festlegen

Speicherort für Konfiguration und Daten – Standard ~/.openclaw/, Enter für Default reicht meist.

4. Nachrichtenkanäle verbinden

Chat-Plattform für die KI-Kommunikation:

• Telegram: Bot über @BotFather anlegen, Token kopieren
• WhatsApp: QR-Code generieren, mit WhatsApp am Handy scannen
• Überspringen: nur Web-Oberfläche – vorerst möglich

Telegram-Beispiel:

1. In Telegram @BotFather suchen
2. /newbot senden
3. Bot-Namen vergeben
4. Generierten Token kopieren
5. In OpenClaw einfügen

5. Daemon installieren

Am Ende: Daemon installieren? Bei „Ja“ läuft OpenClaw im Hintergrund – Terminal schließen ändert nichts.

Gesamtdauer etwa 5–10 Minuten – meist für API-Keys und Chat-Kanäle.

Manuelle Konfiguration (optional)

Feinjustierung über die Konfigurationsdatei:

nano ~/.openclaw/openclaw.json

JSON mit allen Einstellungen – für die meisten reicht der Assistent.

Erster Start: Alles prüfen

Nach der Konfiguration OpenClaw starten.

Gateway starten

Ohne installierten Daemon manuell:

openclaw gateway --port 18789

18789 ist der Standardport – andere Ports möglich. Bei Erfolg etwa:

✓ OpenClaw Gateway started on http://localhost:18789

Web-Oberfläche öffnen

Im Browser:

http://localhost:18789

OpenClaw-Kontrollzentrum – übersichtlich mit:

• Chat: Testbereich für Dialoge
• Agents: KI-Agenten verwalten
• Skills: Skill-Plugins konfigurieren
• Settings: Systemeinstellungen

Dialog testen

In Chat eine Nachricht senden, z. B. „Hallo“ oder „Stell dich kurz vor“.

Bei korrekter Konfiguration antwortet die KI – der erste Dialog mit dem selbst aufgesetzten Assistenten ist ein schöner Moment.

Häufige Probleme

Bei Software-Installation passiert mal etwas – typische Fälle zur Fehlersuche.

Falsche Node.js-Version

Symptom: Fehler bei openclaw, Hinweis auf inkompatible Node-Version

KiloClaw - Managed OpenClaw für Unternehmen: AI-Agent-Orchestrierung und smartes Modell-Routing

Jetzt starten →Anzeige

Lösung: Node-Version prüfen – mindestens v22.14 (empfohlen v24)

node --version

Bei zu alter Version Node.js neu installieren oder upgraden.

WSL2-Probleme (Windows)

Symptom: diverse Fehler bei Installation unter Windows

Lösung: WSL2 korrekt installiert und aktuell

wsl --update

Ungültiger API-Key

Symptom: KI antwortet nicht trotz konfiguriertem Key

Lösung:

• Key vollständig kopiert (keine Leerzeichen am Anfang/Ende)
• API-Konto mit Guthaben (OpenAI und Anthropic sind kostenpflichtig)
• Key neu generieren

Port belegt

Symptom: Gateway meldet, Port 18789 ist belegt

Lösung: anderen Port oder blockierenden Prozess beenden

# Wer nutzt Port 18789?
lsof -i :18789

# Mit anderem Port starten
openclaw gateway --port 18790

Berechtigungsprobleme

Symptom: unzureichende Rechte bei der Installation

Lösung: unter Linux/Mac ggf. sudo oder Verzeichnisrechte prüfen

# Schreibrechte sicherstellen
chmod -R 755 ~/.openclaw

Sicherheitshinweise

Nach der Installation ein paar wichtige Punkte:

1. Port nicht exponieren: 18789 lauscht standardmäßig nur auf localhost – niemals ins öffentliche Netz, sonst kann jeder auf Ihre KI zugreifen
2. API-Keys schützen: Keys in der Konfiguration sind sensibel – nicht teilen, nicht ins Git-Repository committen
3. Remote-Zugriff per SSH-Tunnel: von anderen Geräten aus – SSH-Tunnel nutzen, Port nicht direkt öffnen

# Von einem anderen Rechner per SSH
ssh -L 18789:localhost:18789 user@your-server

Weiterführend

• OpenClaw-Konfiguration: der vollständige openclaw.json-Leitfaden
• OpenClaw-Architektur im Detail: dreischichtiges Design
• OpenClaw vs ChatGPT: Architektur, Kosten und Datenschutz

Abschluss

Damit sollte OpenClaw bei Ihnen laufen. Kurz der Ablauf:

Als Nächstes können Sie:

• Skills erkunden und der KI neue Fähigkeiten geben
• Telegram oder WhatsApp verbinden und KI im Messenger nutzen
• bei Interesse eigene Skills entwickeln
• in der offiziellen Dokumentation weitere Funktionen entdecken

OpenClaw ist Open Source – die Nutzererfahrung ist bereits sehr solide. Bei Problemen lohnt ein Blick in die GitHub-Issues – die Community ist aktiv.

Zum Schluss: Beim ersten Mal wirkt so ein Tool oft komplex – nach einer erfolgreichen Installation merkt man, dass es handhabbar ist. Schritt für Schritt, bei Fragen recherchieren – meist findet sich eine Lösung.

Viel Erfolg beim Ausprobieren!