Naar hoofdinhoud gaan
OpenClaw vereist Node 22.19+, Node 23.11+ of Node 24+. Node 24 is de standaard en aanbevolen runtime voor installaties, CI en releaseworkflows. Node 22 blijft ondersteund via de actieve LTS-lijn. Het installatiescript detecteert en installeert Node automatisch - deze pagina is bedoeld voor wanneer je Node zelf wilt instellen en zeker wilt weten dat alles correct is gekoppeld (versies, PATH, globale installaties).

​
Controleer je versie

node -v
Als dit v24.x.x of hoger afdrukt, gebruik je de aanbevolen standaard. Als dit v22.19.x of hoger afdrukt, gebruik je het ondersteunde Node 22 LTS-pad, maar we raden nog steeds aan om naar Node 24 te upgraden wanneer dat uitkomt. Node 23-versies vóór v23.11.0 worden niet ondersteund. Als Node niet is geïnstalleerd of de versie buiten het ondersteunde bereik valt, kies dan hieronder een installatiemethode.

​
Node installeren

Homebrew (aanbevolen):
brew install node
Of download het macOS-installatieprogramma van nodejs.org.
Met versiebeheerders kun je eenvoudig schakelen tussen Node-versies. Populaire opties:
  • fnm - snel, platformoverschrijdend
  • nvm - veelgebruikt op macOS/Linux
  • mise - polyglot (Node, Python, Ruby, enz.)
Voorbeeld met fnm:
fnm install 24
fnm use 24
Zorg ervoor dat je versiebeheerder is geïnitialiseerd in het opstartbestand van je shell (~/.zshrc of ~/.bashrc). Als dat niet zo is, wordt openclaw mogelijk niet gevonden in nieuwe terminalsessies omdat de PATH de bin-map van Node niet bevat.

​
Probleemoplossing

​
openclaw: command not found

Dit betekent vrijwel altijd dat de globale bin-map van npm niet op je PATH staat.
1

Zoek je globale npm-prefix

npm prefix -g
2

Controleer of deze op je PATH staat

echo "$PATH"
Zoek naar <npm-prefix>/bin (macOS/Linux) of <npm-prefix> (Windows) in de uitvoer.
3

Voeg deze toe aan het opstartbestand van je shell

Voeg toe aan ~/.zshrc of ~/.bashrc:
export PATH="$(npm prefix -g)/bin:$PATH"
Open daarna een nieuwe terminal (of voer rehash uit in zsh / hash -r in bash).

​
Machtigingsfouten bij npm install -g (Linux)

Als je EACCES-fouten ziet, wijzig dan de globale prefix van npm naar een map waar je gebruiker naar 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 dit permanent te maken.

​
Gerelateerd