Node.js für OpenClaw richtig einrichten

Kennst du das? Du willst ein neues Tool installieren, aber die Node.js-Version auf deinem Rechner ist veraltet oder die globalen Pfade sind falsch konfiguriert. Solche Kleinigkeiten halten den Workflow auf und sorgen für unnötigen Frust beim Setup.

Damit du direkt mit OpenClaw starten kannst, zeige ich dir hier den schnellsten Weg zur richtigen Node.js-Umgebung. Eine saubere Installation spart dir später Zeit bei der Fehlersuche.

Voraussetzungen

• Node.js 22 oder neuer

Schnellstart

Prüfe zuerst, ob du bereits eine passende Version installiert hast. Öffne dein Terminal und gib folgenden Befehl ein:

node -v

Wenn die Ausgabe v22.x.x oder höher anzeigt, bist du startklar. Falls nicht, folge diesen Schritten für dein Betriebssystem:

1. Node.js installieren

macOS:

Homebrew (empfohlen):

brew install node

Alternativ kannst du den macOS-Installer direkt von nodejs.org laden.

Linux:

Ubuntu / Debian:

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

Fedora / RHEL:

sudo dnf install nodejs

Windows:

winget (empfohlen):

winget install OpenJS.NodeJS.LTS

Chocolatey:

choco install nodejs-lts

2. Version Manager nutzen (Best Practice)

Ich empfehle dir die Nutzung eines Version Managers. Damit kannst du unkompliziert zwischen Node-Versionen wechseln, ohne dein System zu verlangsamen. Hier sind vier gute Optionen:

• fnm – extrem schnell und cross-platform
• nvm – der Klassiker für macOS und Linux
• mise – unterstützt mehrere Sprachen (Node, Python, Ruby)
• asdf – ein bewährter Allrounder

Beispiel mit fnm:

fnm install 22
fnm use 22

Achtung

Stelle sicher, dass dein Version Manager in deiner Shell-Konfigurationsdatei (~/.zshrc oder ~/.bashrc) initialisiert wird. Wenn das fehlt, wird openclaw in neuen Terminal-Sessions nicht gefunden, da das Node bin-Verzeichnis nicht im PATH liegt.

Fehlerbehebung

openclaw: command not found

Das liegt meistens daran, dass das globale bin-Verzeichnis von npm nicht in deinem PATH hinterlegt ist.

1. Globalen npm-Prefix finden

    npm prefix -g

2. PATH prüfen

    echo "$PATH"

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

3. Zum Shell-Startup hinzufügen

macOS / Linux:

Füge dies zu deiner ~/.zshrc oder ~/.bashrc hinzu:

export PATH="$(npm prefix -g)/bin:$PATH"

Öffne danach ein neues Terminal oder führe rehash (zsh) bzw. hash -r (bash) aus.

Windows:

Füge den Output von npm prefix -g über Einstellungen → System → Umgebungsvariablen zu deinem System-PATH hinzu.

Permission errors bei npm install -g (Linux)

Falls EACCES-Fehler auftreten, solltest du den globalen Prefix von npm auf ein Verzeichnis ändern, für das dein User Schreibrechte hat:

mkdir -p "$HOME/.npm-global"
npm config set prefix "$HOME/.npm-global"
export PATH="$HOME/.npm-global/bin:$PATH"

Schreibe die export PATH=... Zeile in deine ~/.bashrc oder ~/.zshrc, damit die Einstellung dauerhaft bleibt.

Du hast spezifische Fragen zu deiner Umgebung? Nutze den AI Setup Assistant für Hilfe in Echtzeit.

Nächste Schritte

• Installationsmethoden im Überblick