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.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 — gebruik deze pagina wanneer je Node zelf wilt configureren (versies, PATH, globale installaties).

Controleer je versie

bash
node -v

v24.x.x of hoger is de aanbevolen standaard. v22.19.x of hoger is het ondersteunde pad voor Node 22 LTS (voer wanneer het uitkomt een upgrade naar Node 24 uit). Node 23-builds ouder dan v23.11.0 worden niet ondersteund. Als Node ontbreekt of buiten het ondersteunde bereik valt, kies je 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 wisselen. 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 vrijwel altijd dat de globale bin-map van npm niet in je PATH staat.

  • Zoek je globale npm-voorvoegsel

    bash
    npm prefix -g

  • Controleer of het in je PATH staat

    bash
    echo "$PATH"

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

  • Voeg het 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.

    • Toestemmingsfouten bij npm install -g (Linux)

    Als je EACCES-fouten ziet, wijzig je het globale npm-voorvoegsel naar 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