Zum Hauptinhalt springen

​
Node.js

OpenClaw erfordert Node 22.14 oder neuer. Node 24 ist die Standard- und empfohlene Laufzeit für Installationen, CI- und Release-Workflows. Node 22 bleibt über die aktive LTS-Linie unterstützt. Das Installationsskript erkennt Node automatisch und installiert es bei Bedarf — diese Seite ist für den Fall gedacht, dass Sie Node selbst einrichten und sicherstellen möchten, dass alles korrekt verdrahtet ist (Versionen, PATH, globale Installationen).

​
Version prüfen

node -v
Wenn dies v24.x.x oder höher ausgibt, verwenden Sie die empfohlene Standardversion. Wenn v22.14.x oder höher ausgegeben wird, verwenden Sie den unterstützten Node-22-LTS-Pfad, wir empfehlen aber dennoch ein Upgrade auf Node 24, sobald es für Sie passt. Wenn Node nicht installiert ist oder die Version zu alt ist, wählen Sie unten eine Installationsmethode.

​
Node installieren

Homebrew (empfohlen):
brew install node
Oder laden Sie das macOS-Installationsprogramm von nodejs.org herunter.
Versionsmanager erleichtern das Umschalten zwischen Node-Versionen. Beliebte Optionen:
  • fnm — schnell, plattformübergreifend
  • nvm — weit verbreitet unter macOS/Linux
  • mise — polyglott (Node, Python, Ruby usw.)
Beispiel mit fnm:
fnm install 24
fnm use 24
Stellen Sie sicher, dass Ihr Versionsmanager in Ihrer Shell-Startdatei (~/.zshrc oder ~/.bashrc) initialisiert wird. Wenn das nicht der Fall ist, wird openclaw in neuen Terminal-Sitzungen möglicherweise nicht gefunden, weil der PATH nicht das Binärverzeichnis von Node enthält.

​
Fehlerbehebung

​
openclaw: command not found

Das bedeutet fast immer, dass das globale Binärverzeichnis von npm nicht im PATH enthalten ist.
1

Globales npm-Präfix finden

npm prefix -g
2

Prüfen, ob es im PATH enthalten ist

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

Es zur Shell-Startdatei hinzufügen

Zu ~/.zshrc oder ~/.bashrc hinzufügen:
export PATH="$(npm prefix -g)/bin:$PATH"
Öffnen Sie dann 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, stellen Sie das globale npm-Präfix auf ein vom Benutzer beschreibbares Verzeichnis um: 
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 sie dauerhaft zu machen.

​
Verwandt