Naar hoofdinhoud gaan

Documentation Index

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

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

OpenClaw vereist Node 22.14 of nieuwer. Node 24 is de standaard en aanbevolen runtime voor installaties, CI en release-workflows. 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 wilt controleren of alles correct is aangesloten (versies, PATH, globale installaties).

Controleer je versie

node -v
Als dit v24.x.x of hoger toont, gebruik je de aanbevolen standaardversie. Als dit v22.14.x of hoger toont, 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.
Met versiebeheerders kun je eenvoudig wisselen tussen Node-versies. Populaire opties:
  • fnm — snel, cross-platform
  • nvm — veel gebruikt 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 in je PATH staat.
1

Zoek je globale npm-prefix

npm prefix -g
2

Controleer of deze in 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 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