English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

Install overview

Node.js

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

macOS

Homebrew (aanbevolen):

brew install node

Of download het macOS-installatieprogramma van nodejs.org.

Linux

Ubuntu / Debian:

curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
sudo apt-get install -y nodejs

Fedora / RHEL:

sudo dnf install nodejs

Of gebruik een versiemanager (zie hieronder).

Windows

winget (aanbevolen):

winget install OpenJS.NodeJS.LTS

Chocolatey:

choco install nodejs-lts

Of download het Windows-installatieprogramma van nodejs.org.

Using a version manager (nvm, fnm, mise, asdf)

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

Problemen oplossen

openclaw: command not found

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

  • Find your global npm prefix

    npm prefix -g

  • Check if it's on your PATH

    echo "$PATH"

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

  • Add it to your shell startup file

    macOS / Linux

    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).

    Windows

    Voeg de uitvoer van npm prefix -g toe aan je systeem-PATH via Instellingen → Systeem → Omgevingsvariabelen.

    • 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