English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisहिन्दीالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiРусскийفارسیไทย
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this pageOpen in PerplexityAsk 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 Runtime 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 - 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

bash
node -v

Wenn dies v24.x.x oder höher ausgibt, verwenden Sie den empfohlenen Standard. Wenn es v22.19.x oder höher ausgibt, verwenden Sie den unterstützten Node-22-LTS-Pfad; wir empfehlen jedoch weiterhin, bei Gelegenheit auf Node 24 zu aktualisieren. Node-23-Versionen vor v23.11.0 werden nicht unterstützt. Wenn Node nicht installiert ist oder die Version außerhalb des unterstützten Bereichs liegt, wählen Sie unten eine Installationsmethode aus.

Node installieren

macOS

Homebrew (empfohlen):

bash
brew install node

Oder laden Sie den macOS-Installer 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 den Windows-Installer von nodejs.org herunter.

Versionsmanager verwenden (nvm, fnm, mise, asdf)

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

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

  • Globales npm-Präfix finden

    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 / 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 das globale Präfix von npm auf ein vom Benutzer beschreibbares Verzeichnis:

    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?
    On this page

    On this page