English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

Install overview

Node.js

OpenClaw erfordert Node 22.14 oder neuer. Node 24 ist die standardmäßige und empfohlene Runtime für Installationen, CI und Release-Workflows. Node 22 bleibt über die aktive LTS-Linie 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).

Version prüfen

node -v

Wenn dies v24.x.x oder höher ausgibt, verwenden Sie den empfohlenen Standard. Wenn es v22.14.x oder höher ausgibt, verwenden Sie den unterstützten Node-22-LTS-Pfad, wir empfehlen aber weiterhin 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 aus.

Node installieren

macOS

Homebrew (empfohlen):

brew install node

Oder laden Sie das macOS-Installationsprogramm von nodejs.org herunter.

Linux

Ubuntu / Debian:

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

Fedora / RHEL:

sudo dnf install nodejs

Oder verwenden Sie einen Versionsmanager (siehe unten).

Windows

winget (empfohlen):

winget install OpenJS.NodeJS.LTS

Chocolatey:

choco install nodejs-lts

Oder laden Sie das Windows-Installationsprogramm von nodejs.org herunter.

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

Mit Versionsmanagern können Sie einfach zwischen Node-Versionen wechseln. 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

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

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

    Windows

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

    • Berechtigungsfehler bei npm install -g (Linux)

    Wenn EACCES-Fehler angezeigt werden, stellen Sie das globale Präfix von npm auf ein benutzerbeschreibbares 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 die Änderung dauerhaft zu machen.

    Verwandte Themen