Zum Hauptinhalt springen
OpenClaw erfordert Node 22.19+, Node 23.11+ oder Node 24+. Node 24 ist die standardmäßige und empfohlene Runtime für Installationen, CI und Release-Workflows. Node 22 wird weiterhin über die aktive LTS-Linie unterstützt. Das Installationsskript erkennt und installiert Node automatisch - diese Seite ist für Fälle gedacht, in denen Sie Node selbst einrichten und sicherstellen möchten, dass alles korrekt verbunden ist (Versionen, PATH, globale Installationen).

​
Version prüfen

node -v
Wenn dies v24.x.x oder höher ausgibt, verwenden Sie den empfohlenen Standard. Wenn es v22.19.x oder höher ausgibt, verwenden Sie den unterstützten Node-22-LTS-Pfad; wir empfehlen jedoch weiterhin, bei Gelegenheit auf Node 24 zu aktualisieren. Node-23-Versionen vor v23.11.0 werden nicht unterstützt. Wenn Node nicht installiert ist oder die Version außerhalb des unterstützten Bereichs liegt, wählen Sie unten eine Installationsmethode aus.

​
Node installieren

Homebrew (empfohlen):
brew install node
Oder laden Sie den macOS-Installer von nodejs.org herunter.
Mit Versionsmanagern können Sie einfach zwischen Node-Versionen wechseln. Beliebte Optionen:
  • fnm - schnell, plattformübergreifend
  • nvm - auf macOS/Linux weit verbreitet
  • mise - polyglott (Node, Python, Ruby usw.)
Beispiel mit fnm:
fnm install 24
fnm use 24
Stellen Sie sicher, dass Ihr Versionsmanager in der Startdatei Ihrer Shell (~/.zshrc oder ~/.bashrc) initialisiert ist. Andernfalls wird openclaw in neuen Terminalsitzungen möglicherweise nicht gefunden, weil PATH das bin-Verzeichnis von Node nicht enthält.

​
Fehlerbehebung

​
openclaw: command not found

Das bedeutet fast immer, dass das globale bin-Verzeichnis von npm nicht in Ihrem PATH enthalten ist.
1

Globales npm-Präfix finden

npm prefix -g
2

Prüfen, ob es in Ihrem PATH enthalten ist

echo "$PATH"
Suchen Sie in der Ausgabe nach <npm-prefix>/bin (macOS/Linux) oder <npm-prefix> (Windows).
3

Zur Startdatei Ihrer Shell hinzufügen

Fügen Sie Folgendes zu ~/.zshrc oder ~/.bashrc hinzu:
export PATH="$(npm prefix -g)/bin:$PATH"
Öffnen Sie anschließend ein neues Terminal (oder führen Sie rehash in zsh / hash -r in bash aus).

​
Berechtigungsfehler bei npm install -g (Linux)

Wenn Sie EACCES-Fehler sehen, ändern Sie das globale Präfix von npm auf ein vom Benutzer beschreibbares Verzeichnis: 
mkdir -p "$HOME/.npm-global"
npm config set prefix "$HOME/.npm-global"
export PATH="$HOME/.npm-global/bin:$PATH"
Fügen Sie die Zeile export PATH=... zu Ihrer ~/.bashrc oder ~/.zshrc hinzu, um die Änderung dauerhaft zu machen.

​
Verwandte Themen