OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Install overview

Node.js

OpenClaw erfordert Node 22.22.3+, Node 24.15+ oder Node 25.9+. Node 24 ist die standardmäßige und empfohlene Runtime für Installationen, CI und Release-Workflows; Node 22 wird weiterhin über die aktive LTS-Linie unterstützt. Node 23 wird nicht unterstützt. Das Installationsskript erkennt und installiert Node automatisch – verwenden Sie diese Seite, wenn Sie Node selbst einrichten möchten (Versionen, PATH, globale Installationen).

Version überprüfen

bash
node -v

v24.15.0 oder neuer aus der 24.x-Reihe ist der empfohlene Standard. v22.22.3 oder neuer aus der 22.x-Reihe ist der unterstützte Node-22-LTS-Pfad; Node v25.9.0+ wird ebenfalls unterstützt. Node 23 wird nicht unterstützt. Wenn Node fehlt oder außerhalb des unterstützten Bereichs liegt, wählen Sie unten eine Installationsmethode aus.

Node installieren

macOS

Homebrew (empfohlen):

bash
brew install node

Alternativ können Sie das macOS-Installationsprogramm von nodejs.org herunterladen.

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

Alternativ können Sie einen Versionsmanager verwenden (siehe unten).

Windows

winget (empfohlen):

powershell
winget install OpenJS.NodeJS.LTS

Chocolatey:

powershell
choco install nodejs-lts

Alternativ können Sie das Windows-Installationsprogramm von nodejs.org herunterladen.

Versionsmanager verwenden (nvm, fnm, mise, asdf)

Mit Versionsmanagern können Sie problemlos zwischen Node-Versionen wechseln. Beliebte Optionen:

  • fnm – schnell und plattformübergreifend
  • nvm – unter macOS/Linux weitverbreitet
  • mise – mehrsprachig (Node, Python, Ruby usw.)

Beispiel mit fnm:

bash
fnm install 24fnm use 24

Fehlerbehebung

openclaw: command not found

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

  • Globales npm-Präfix ermitteln

    bash
    npm prefix -g

  • Prüfen, ob es sich in Ihrem PATH befindet

    bash
    echo "$PATH"

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

  • Zur Startdatei Ihrer Shell hinzufügen

    macOS / Linux

    Fügen Sie Folgendes 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 beziehungsweise hash -r in bash aus).

    Windows

    Fügen Sie die Ausgabe von npm prefix -g über Settings → System → Environment Variables zum PATH Ihres Systems hinzu.

    • Berechtigungsfehler bei npm install -g (Linux)

    Wenn EACCES-Fehler auftreten, ändern Sie das globale Präfix von npm in ein Verzeichnis, in das Ihr Benutzer schreiben darf:

    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 übernehmen.

    Verwandte Themen

    Was this useful?
    On this page

    On this page