OpenClawDocs
Auf dieser Seite

Auf dieser Seite

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

Runtimes

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?