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 vereist Node 22.22.3+, Node 24.15+ of Node 25.9+. Node 24 is de standaard en aanbevolen runtime voor installaties, CI en releaseworkflows; Node 22 blijft ondersteund via de actieve LTS-lijn. Node 23 wordt niet ondersteund. Het installatiescript detecteert en installeert Node automatisch — gebruik deze pagina als je Node zelf wilt configureren (versies, PATH, globale installaties).

Controleer je versie

bash
node -v

v24.15.0 of een nieuwere 24.x-versie is de aanbevolen standaard. v22.22.3 of een nieuwere 22.x-versie is het ondersteunde Node 22 LTS-traject; Node v25.9.0+ wordt ook ondersteund. Node 23 wordt niet ondersteund. Als Node ontbreekt of buiten het ondersteunde bereik valt, kies dan hieronder een installatiemethode.

Node installeren

macOS

Homebrew (aanbevolen):

bash
brew install node

Of download het macOS-installatieprogramma van nodejs.org.

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

Of gebruik een versiebeheerder (zie hieronder).

Windows

winget (aanbevolen):

powershell
winget install OpenJS.NodeJS.LTS

Chocolatey:

powershell
choco install nodejs-lts

Of download het Windows-installatieprogramma van nodejs.org.

Een versiebeheerder gebruiken (nvm, fnm, mise, asdf)

Met versiebeheerders kun je eenvoudig tussen Node-versies schakelen. Populaire opties:

  • fnm - snel, platformonafhankelijk
  • nvm - veelgebruikt op macOS/Linux
  • mise - meertalig (Node, Python, Ruby enzovoort)

Voorbeeld met fnm:

bash
fnm install 24fnm use 24

Problemen oplossen

openclaw: command not found

Dit betekent bijna altijd dat de globale bin-map van npm niet in je PATH staat.

  • Zoek je globale npm-prefix

    bash
    npm prefix -g

  • Controleer of deze in je PATH staat

    bash
    echo "$PATH"

    Zoek in de uitvoer naar <npm-prefix>/bin (macOS/Linux) of <npm-prefix> (Windows).

  • Voeg deze toe aan het opstartbestand van je shell

    macOS / Linux

    Voeg het volgende toe aan ~/.zshrc of ~/.bashrc:

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

    Open daarna een nieuwe terminal (of voer rehash uit in zsh / hash -r in bash).

    Windows

    Voeg de uitvoer van npm prefix -g toe aan je systeem-PATH via Settings → System → Environment Variables.

    • Machtigingsfouten bij npm install -g (Linux)

    Als je EACCES-fouten ziet, wijzig dan de globale prefix van npm in een map waarin de gebruiker kan schrijven:

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

    Voeg de regel export PATH=... toe aan je ~/.bashrc of ~/.zshrc om de wijziging permanent te maken.

    Gerelateerd

    Was this useful?
    On this page

    On this page