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

macOS
Linux
Windows

Homebrew (empfohlen):

````
```bash
brew install node
```

Oder laden Sie den macOS-Installer von [nodejs.org](https://nodejs.org/) herunter.
````

Ubuntu / Debian:

````
```bash
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs
```

**Fedora / RHEL:**

```bash
sudo dnf install nodejs
```

Oder verwenden Sie einen Versionsmanager (siehe unten).
````

winget (empfohlen):

````
```powershell
winget install OpenJS.NodeJS.LTS
```

**Chocolatey:**

```powershell
choco install nodejs-lts
```

Oder laden Sie den Windows-Installer von [nodejs.org](https://nodejs.org/) herunter.
````

Using a version manager (nvm, fnm, mise, asdf)

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.

Find your global npm prefix

npm prefix -g

Check if it's on your PATH

echo "$PATH"

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

Add it to your shell startup file

macOS / Linux
Windows

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).

Fügen Sie die Ausgabe von npm prefix -g über Einstellungen → System → Umgebungsvariablen zu Ihrem System-PATH hinzu.

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.

Hilfe

Community

Umgebung und Debugging

Node-Runtime

Kompaktierungs-Interna

Entwickler-Setup

Docs-Meta

Node.js

Node.js

Version prüfen

Node installieren

Fehlerbehebung

`openclaw: command not found`

Berechtigungsfehler bei `npm install -g` (Linux)

​Node.js

​Version prüfen

​Node installieren

​Fehlerbehebung

​openclaw: command not found

​Berechtigungsfehler bei npm install -g (Linux)

Node.js

Version prüfen

Node installieren

Fehlerbehebung

`openclaw: command not found`

Berechtigungsfehler bei `npm install -g` (Linux)