OpenClaw installieren

Du kennst das sicher: Du willst ein neues Tool testen, aber die Installation fühlt sich wie ein Endgegner an. Abhängigkeiten fehlen, Versionen beißen sich und am Ende starrst du auf kryptische Fehlermeldungen in deinem Terminal, statt produktiv zu sein.

Es nervt, wenn das Setup länger dauert als die eigentliche Arbeit. Deshalb ist OpenClaw so gebaut, dass du ohne Kopfschmerzen direkt starten kannst.

Voraussetzungen

Bevor du loslegst, stelle sicher, dass deine Umgebung bereit ist. Hier sind die Anforderungen aus der Dokumentation:

1. Node 22+: Das Installer-Script installiert Node automatisch, falls es fehlt.
2. Betriebssystem: macOS, Linux oder Windows.
3. WSL2: Für Windows-Nutzer wird OpenClaw unter WSL2 dringend empfohlen.
4. pnpm: Nur notwendig, wenn du OpenClaw aus dem Source-Code baust.

Schnellstart

Ich empfehle dir das Installer-Script. Es ist der schnellste Weg, da es die Node-Erkennung, die Installation und das Onboarding in einem Rutsch erledigt.

macOS / Linux / WSL2

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

Windows (PowerShell)

iwr -useb https://openclaw.ai/install.ps1 | iex

Falls du das Onboarding überspringen und nur die Binary installieren willst, nutze diese Befehle:

macOS / Linux / WSL2 (nur Binary)

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

Windows (PowerShell, nur Binary)

& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard

Alternative: npm oder pnpm

Wenn du Node 22+ bereits hast und deine Pakete lieber selbst verwaltest, kannst du die CLI manuell installieren:

Mit npm

npm install -g openclaw@latest
openclaw onboard --install-daemon

Mit pnpm

pnpm add -g openclaw@latest
pnpm approve-builds -g
openclaw onboard --install-daemon

Hinweis: pnpm erfordert eine explizite Freigabe für Build-Scripts. Führe nach der Installation pnpm approve-builds -g aus.

Fehlerbehebung

Manchmal läuft es nicht sofort glatt. Hier sind die Lösungen für bekannte Probleme:

openclaw nicht gefunden

Wenn dein Terminal den Befehl nicht kennt, liegt das meist an einem fehlenden Eintrag im PATH. Prüfe deine Umgebung:

node -v
npm -v
npm prefix -g
echo "$PATH"

Falls das Verzeichnis von npm prefix -g nicht in deinem PATH ist, füge es deiner Shell-Konfigurationsdatei (z. B. ~/.zshrc oder ~/.bashrc) hinzu:

export PATH="$(npm prefix -g)/bin:$PATH"

sharp Build-Fehler

Falls du libvips global installiert hast (oft via Homebrew) und die Installation von sharp fehlschlägt, erzwinge die Nutzung von prebuilt binaries:

SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

After Install

Sobald die Installation durch ist, solltest du prüfen, ob alles läuft. Nutze diese Befehle:

1. openclaw doctor: Prüft auf Konfigurationsprobleme.
2. openclaw status: Zeigt dir den Status des Gateway.
3. openclaw dashboard: Öffnet das UI im Browser.
4. openclaw onboard: Startet den Onboarding-Prozess erneut.

Wenn du eigene Pfade für die Runtime benötigst, kannst du Umgebungsvariablen wie OPENCLAW_HOME, OPENCLAW_STATE_DIR oder OPENCLAW_CONFIG_PATH nutzen.

Hast du Fragen zum Setup? Frag den AI Setup Assistant.

Nächste Schritte

Hier findest du weitere Installationsoptionen für spezifische Workflows:

• Docker: Containerisierte Deployments.
• Nix: Deklarative Installation.
• Ansible: Automatisierte Bereitstellung.
• Bun: Nutzung über die Bun-Runtime.