OpenClawDocs
Op deze pagina

Op deze pagina

View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Runtimes

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

bash
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

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 bijna altijd dat de globale bin-map van npm niet in je PATH staat.

  • Zoek je globale npm-prefix

    bash
    npm prefix -g

  • Controleer of deze in je PATH staat

    bash
    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

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

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

    Open vervolgens 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.

    • 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:

    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?