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

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

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.

bash npm prefix -g bash echo "$PATH"

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

Fügen Sie es zu ~/.zshrc oder ~/.bashrc hinzu:

    ```
        ```
            ```bash
            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).
          </Tab>
          <Tab title="Windows">
            Fügen Sie die Ausgabe von `npm prefix -g` über Einstellungen → System → Umgebungsvariablen zu Ihrem System-PATH hinzu.
          </Tab>
        </Tabs>
        ```
    ```

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.

Community