OpenClaw installieren & einrichten – Teil 2: Installation auf macOS, Linux & Raspberry Pi

📚 Serie: OpenClaw installieren & einrichten — Teil 2 von 8
← Teil 1: Was ist OpenClaw? Überblick & Architektur | Teil 3: Erste Einrichtung: Modelle, Provider & API‑Keys →

Im ersten Teil hast du gelernt, was OpenClaw ist und wie es funktioniert. Jetzt wird es praktisch: Wir installieren den Gateway‑Daemon auf deinem Rechner. Egal ob macOS, Linux oder Raspberry Pi – die Schritte sind ähnlich und dauern nur wenige Minuten.

Am Ende dieses Teils läuft OpenClaw als Hintergrunddienst, und du kannst die Web‑UI in einer Standardinstallation meist unter http://localhost:18789 öffnen. Los geht’s!

Voraussetzungen für diesen Teil

✅ Node.js 22 oder höher – OpenClaw benötigt eine aktuelle Node‑Version.
✅ npm, pnpm oder bun – ein Paketmanager deiner Wahl (empfohlen: npm oder pnpm).
✅ Internetverbindung – zum Herunterladen der Pakete und (optional) der UI‑Assets.
✅ Terminal – du solltest grundlegend mit der Kommandozeile vertraut sein.

Node.js prüfen und ggf. installieren

Öffne ein Terminal und gib ein:

node --version

Wenn v22.x.x oder höher erscheint, kannst du zum nächsten Schritt springen. Falls nicht, installiere Node.js:

macOS: Mit Homebrew: brew install node (falls Homebrew nicht installiert ist: brew.sh)
Linux (Debian/Ubuntu): curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - && sudo apt-get install -y nodejs
Linux (Fedora): sudo dnf install nodejs
Raspberry Pi (Raspbian): Gleiche Befehle wie für Debian/Ubuntu (ARM‑Version wird automatisch erkannt).
Windows: Nutze WSL2 (empfohlen) oder die offizielle Node.js‑Installer von nodejs.org.

Nach der Installation nochmals node --version prüfen.

Schritt 1: OpenClaw global installieren

Die einfachste Installationsmethode ist die globale Installation via npm (oder pnpm). Das legt das openclaw‑CLI in deinem Pfad ab.

npm install -g openclaw@latest

Alternative mit pnpm (schneller, platzsparender):

pnpm add -g openclaw@latest

Wenn du pnpm noch nicht hast: npm install -g pnpm.

Die Installation dauert je nach Netzwerk eine Minute. Danach sollte der Befehl openclaw verfügbar sein:

openclaw --version

Das sollte die aktuelle Version ausgeben (z. B. 2026.3.7).

Schritt 2: Onboarding‑Wizard starten

OpenClaw bringt einen interaktiven Wizard mit, der dich durch die Erstkonfiguration führt. Starte ihn mit:

openclaw onboard --install-daemon

Der Wizard fragt dich nacheinander:

Workspace‑Pfad – wo deine persönlichen Agenten‑ und Konfigurationsdateien liegen sollen (Standard: ~/.openclaw/workspace).
Gateway‑Port – welchen Port der Gateway‑Daemon nutzen soll (Standard in aktuellen lokalen Setups meist: 18789).
Daemon‑Installation – ob der Gateway als Hintergrunddienst gestartet werden soll (empfohlen: ja).
UI‑Assets – ob die Web‑UI‑Dateien heruntergeladen werden sollen (empfohlen: ja).

Antworte einfach mit Enter, um die Vorgaben zu übernehmen, oder passe sie an deine Bedürfnisse an.

💡 Tipp: Wenn du später nochmal etwas ändern möchtest, kannst du den Wizard jederzeit erneut mit openclaw onboard starten.

Was der Wizard im Hintergrund tut

Er legt den Workspace‑Ordner an (falls noch nicht vorhanden).
Er erstellt eine minimale openclaw.json‑Konfiguration.
Er installiert den Gateway‑Daemon als Systemdienst (launchd auf macOS, systemd auf Linux, bzw. einen Hintergrundprozess auf Windows/WSL).
Er lädt die Web‑UI‑Dateien herunter, sodass du die Oberfläche im Browser nutzen kannst.

Schritt 3: Gateway‑Daemon starten (falls nicht automatisch)

Der Wizard sollte den Gateway‑Daemon bereits gestartet haben. Du kannst den Status prüfen mit:

openclaw gateway status

Wenn der Daemon läuft, siehst du eine Meldung wie Gateway is running (pid 12345). Falls nicht, starte ihn manuell:

openclaw gateway start

Auf macOS wird der Dienst via launchd verwaltet, auf Linux via systemd --user. Der Daemon läuft im Hintergrund und bleibt auch nach einem Neustart des Rechners aktiv (sofern du die Daemon‑Installation bejaht hast).

Schritt 4: Web‑UI öffnen

Sobald der Gateway läuft, öffne deinen Browser und gehe zu:

http://localhost:18789

Du solltest die OpenClaw‑Web‑UI sehen: eine saubere, dunkle Oberfläche mit einem Chat‑Fenster und Seitenleiste. Hier kannst du später direkt mit deinem Agenten chatten, Channels verwalten und Tools bedienen.

⚠️ Achtung: Beim ersten Aufruf kann es etwas dauern, bis die UI geladen ist (die Dateien werden einmalig aus dem Cache geholt). Gib ihm ein paar Sekunden.

Schritt 5: Ersten Agenten anlegen (optional)

Die Web‑UI bietet einen Schnelleinstieg, um deinen ersten Agenten zu erstellen. Klicke auf „Create Agent“ und wähle einen Namen (z. B. assistant). Du kannst vorerst die Standardeinstellungen übernehmen – wir konfigurieren Modelle und Skills in den nächsten Teilen.

Alternativ geht es auch per CLI:

openclaw agent create --name assistant

Troubleshooting – häufige Probleme

„Command not found: openclaw“

Stelle sicher, dass die globale Installation erfolgreich war (npm list -g openclaw).
Überprüfe, dass dein PATH das npm‑Global‑Verzeichnis enthält (z. B. ~/.npm/bin bei macOS/Linux).

Gateway startet nicht („Port already in use“)

Ein anderer Dienst blockiert den Standardport 18789. Ändere den Port im Wizard (openclaw onboard) oder starte den Gateway mit einem anderen Port, z. B. openclaw gateway --port 18790.

Web‑UI lädt nicht („Cannot GET /“)

Prüfe, ob der Gateway läuft (openclaw gateway status).
Stelle sicher, dass du die UI‑Assets heruntergeladen hast (der Wizard fragt danach). Falls nicht: openclaw onboard --install-ui.

Raspberry Pi: Speicherplatz oder Performance

Auf älteren Pi‑Modellen (z. B. Pi 3) kann die Installation etwas länger dauern. Stelle sicher, dass genug freier Speicher (≥1 GB) vorhanden ist.
Falls die Web‑UI langsam lädt, kannst du sie auch über einen anderen Rechner im selben Netzwerk aufrufen (ersetze localhost durch die IP des Pi).

✅ Was du jetzt hast

Node.js 22+ installiert
OpenClaw CLI global installiert
Onboarding‑Wizard durchlaufen
Gateway‑Daemon läuft im Hintergrund
Web‑UI unter http://localhost:18789 erreichbar
Modelle konfiguriert (kommt in Teil 3)
Messaging‑Channels eingerichtet (kommt in Teil 4)
Skills und Tools hinzugefügt (kommt in Teil 5)

➡️ Weiter mit Teil 3

Im nächsten Teil kümmern wir uns um die KI‑Modelle: Du lernst, wie du OpenAI, Anthropic und OpenRouter anbindest, API‑Keys verwaltest und Fallback‑Modelle konfigurierst – damit dein Agent auch wirklich smart antwortet. Zu Teil 3 →

Quellen & weiterführende Links

OpenClaw Getting Started Guide – offizielle Dokumentation mit ausführlichen Schritten
OpenClaw GitHub Repository – Source Code, Issues und Diskussionen
Node.js Downloads – Installer für alle Plattformen
Homebrew – Paketmanager für macOS (empfohlen für Node.js)

Dieser Artikel ist Teil der Serie „OpenClaw installieren & einrichten“. Der nächste Teil erscheint in Kürze. Wenn du Fragen oder Anregungen hast, schreib mir gerne auf Mastodon oder per E‑Mail.