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

Install overview

Node.js

Edit source

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

bash
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

macOS

Homebrew (empfohlen):

bash
brew install node

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

Linux

Ubuntu / Debian:

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

Fedora / RHEL:

bash
sudo dnf install nodejs

Oder verwenden Sie einen Versionsmanager (siehe unten).

Windows

winget (empfohlen):

powershell
winget install OpenJS.NodeJS.LTS

Chocolatey:

powershell
choco install nodejs-lts

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

Einen Versionsmanager verwenden (nvm, fnm, mise, asdf)

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:

bash
fnm install 24fnm use 24

Fehlerbehebung

openclaw: command not found

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

  • Ihren globalen npm-Präfix finden

    bash
    npm prefix -g

  • Prüfen, ob er in Ihrem PATH liegt

    bash
    echo "$PATH"

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

  • Ihn zur Startdatei Ihrer Shell hinzufügen

    macOS / Linux

    Zu ~/.zshrc oder ~/.bashrc hinzufügen:

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

    Windows

    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, ändern Sie den globalen Präfix von npm auf ein Verzeichnis, in das Ihr Benutzer schreiben kann:

    bash
    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

    Was this useful?