Naar hoofdinhoud gaan

Documentation Index

Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

OpenClaw vereist Node 22.16 of nieuwer. 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 standaardversie. Als dit v22.16.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. Als Node niet is geïnstalleerd of de versie te oud is, kies dan hieronder een installatiemethode.

​
Node installeren

Homebrew (aanbevolen):
brew install node
Of download het macOS-installatieprogramma van nodejs.org.
Versiemanagers laten je eenvoudig wisselen tussen Node-versies. Populaire opties:
  • fnm - snel, platformonafhankelijk
  • nvm - veelgebruikt op macOS/Linux
  • mise - polyglot (Node, Python, Ruby, enz.)
Voorbeeld met fnm:
fnm install 24
fnm use 24
Zorg ervoor dat je versiemanager 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.

​
Problemen oplossen

​
openclaw: command not found

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

Find your global npm prefix

npm prefix -g
2

Check if it's on your PATH

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

Add it to your shell startup file

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, verplaats dan de globale prefix van npm naar 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 dit permanent te maken.

​
Gerelateerd