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 instellen (versies, PATH, globale installaties).

Controleer je versie

node -v

v24.15.0 of nieuwer binnen 24.x is de aanbevolen standaard. v22.22.3 of nieuwer binnen 22.x 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
Linux
Windows

Homebrew (aanbevolen):

brew install node

Of download het macOS-installatieprogramma van nodejs.org.

Ubuntu / Debian:

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

Fedora / RHEL:

sudo dnf install nodejs

Of gebruik een versiebeheerder (zie hieronder).

winget (aanbevolen):

winget install OpenJS.NodeJS.LTS

Chocolatey:

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 wisselen. Populaire opties:

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

Voorbeeld met fnm:

fnm install 24
fnm use 24

Initialiseer je versiebeheerder in het opstartbestand van je shell (~/.zshrc of ~/.bashrc). Als je dit overslaat, wordt openclaw mogelijk niet gevonden in nieuwe terminalsessies, omdat PATH de bin-map van Node niet bevat.

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

npm prefix -g

Controleer of deze in je PATH staat

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
Windows

Voeg dit toe aan ~/.zshrc of ~/.bashrc:

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

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

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:

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

Installatieoverzicht - alle installatiemethoden
Bijwerken - OpenClaw up-to-date houden
Aan de slag - eerste stappen na de installatie

Install overview

Maintenance

Containers

Hosting

Advanced setup

Controleer je versie

Node installeren

Problemen oplossen

`openclaw: command not found`

Machtigingsfouten bij `npm install -g` (Linux)

Gerelateerd

​Controleer je versie

​Node installeren

​Problemen oplossen

​openclaw: command not found

​Machtigingsfouten bij npm install -g (Linux)

​Gerelateerd

Controleer je versie

Node installeren

Problemen oplossen

`openclaw: command not found`

Machtigingsfouten bij `npm install -g` (Linux)

Gerelateerd