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.19+, Node 23.11+ oder Node 24+. Node 24 ist die standardmäßige und empfohlene Laufzeitumgebung für Installationen, CI und Release-Workflows; Node 22 wird weiterhin über die aktive LTS-Linie 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 prüfen

bash
node -v

v24.x.x oder höher ist der empfohlene Standard. v22.19.x oder höher ist der unterstützte Node-22-LTS-Pfad (führen Sie bei Gelegenheit ein Upgrade auf Node 24 durch). Node-23-Builds vor v23.11.0 werden 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 einfach zwischen Node-Versionen wechseln. Beliebte Optionen:

  • fnm - schnell und plattformübergreifend
  • nvm - unter macOS/Linux weit verbreitet
  • 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 das globale bin-Verzeichnis von npm nicht in Ihrem PATH enthalten ist.

  • Globales npm-Präfix ermitteln

    bash
    npm prefix -g

  • Prüfen, ob es in Ihrem PATH enthalten ist

    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 angezeigt werden, ändern Sie das globale Präfix von npm in ein Verzeichnis, in das der 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 übernehmen.

    Verwandte Themen

    Was this useful?
    On this page

    On this page