Zum Hauptinhalt springen

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

OpenClaw benötigt Node 22.16 oder neuer. Node 24 ist die standardmäßige und empfohlene Runtime für Installationen, CI und Release-Workflows. Node 22 wird weiterhin über den aktiven LTS-Zweig 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).

​
Ihre Version prüfen

node -v
Wenn dies v24.x.x oder höher ausgibt, verwenden Sie den empfohlenen Standard. Wenn es v22.16.x oder höher ausgibt, befinden Sie sich auf dem unterstützten Node-22-LTS-Pfad, wir empfehlen 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.
Mit Versionsmanagern können Sie einfach zwischen Node-Versionen wechseln. Beliebte Optionen:
  • fnm - schnell, plattformübergreifend
  • nvm - weit verbreitet auf macOS/Linux
  • 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 initialisiert wird (~/.zshrc oder ~/.bashrc). Ist dies nicht der Fall, wird openclaw in neuen Terminal-Sitzungen möglicherweise nicht gefunden, da PATH das bin-Verzeichnis von Node nicht enthält.

​
Fehlerbehebung

​
openclaw: command not found

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

Ihren globalen npm-Präfix finden

npm prefix -g
2

Prüfen, ob er in Ihrem PATH liegt

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

Ihn zur Startdatei Ihrer Shell hinzufügen

Zu ~/.zshrc oder ~/.bashrc hinzufügen:
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 den globalen Präfix von npm auf ein Verzeichnis, in das Ihr Benutzer schreiben kann: 
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