Zum Hauptinhalt springen

​
Node.js

OpenClaw erfordert Node 22 oder neuer. Das Installationsskript erkennt und installiert Node automatisch — diese Seite ist für den Fall gedacht, dass Sie Node selbst einrichten möchten und sicherstellen wollen, dass alles korrekt verbunden ist (Versionen, PATH, globale Installationen).

​
Version prüfen

node -v
Wenn dies v22.x.x oder höher ausgibt, ist alles in Ordnung. Wenn Node nicht installiert ist oder die Version zu alt ist, wählen Sie unten eine Installationsmethode.

​
Node installieren

Homebrew (empfohlen):
````
```bash
brew install node
```

Oder laden Sie den macOS-Installer von [nodejs.org](https://nodejs.org/) herunter.
````
Versionsmanager ermöglichen es Ihnen, einfach zwischen Node-Versionen zu wechseln. Beliebte Optionen:
  • fnm — schnell, plattformübergreifend
  • nvm — weit verbreitet auf macOS/Linux
  • mise — polyglott (Node, Python, Ruby usw.)
Beispiel mit fnm:
fnm install 22
fnm use 22
Stellen Sie sicher, dass Ihr Versionsmanager in Ihrer Shell-Startdatei initialisiert ist (~/.zshrc oder ~/.bashrc). Ist dies nicht der Fall, wird openclaw in neuen Terminal-Sitzungen möglicherweise nicht gefunden, da der 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

Find your global npm prefix

npm prefix -g
2

Check if it's on your PATH

echo "$PATH"

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

Add it to your shell startup file

Fügen Sie es 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, wechseln Sie den globalen npm-Präfix zu einem für Benutzer beschreibbaren 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 dies dauerhaft zu machen.