Node.js

OpenClaw vereist Node 22 of nieuwer. 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 v22.x.x of hoger weergeeft, zit je goed. Als Node niet is geïnstalleerd of de versie te oud is, kies hieronder een installatiemethode.

Node installeren

macOS
Linux
Windows

Homebrew (aanbevolen):

````
```bash
brew install node
```

Of download het macOS-installatieprogramma van [nodejs.org](https://nodejs.org/).
````

Ubuntu / Debian:

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

**Fedora / RHEL:**

```bash
sudo dnf install nodejs
```

Of gebruik een versiebeheerder (zie hieronder).
````

winget (aanbevolen):

````
```powershell
winget install OpenJS.NodeJS.LTS
```

**Chocolatey:**

```powershell
choco install nodejs-lts
```

Of download het Windows-installatieprogramma van [nodejs.org](https://nodejs.org/).
````

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

Versiebeheerders maken het eenvoudig om tussen Node-versies te wisselen. Populaire opties:

fnm — snel, cross‑platform
nvm — veelgebruikt op macOS/Linux
mise — polyglot (Node, Python, Ruby, enz.)

Voorbeeld met fnm:

fnm install 22
fnm use 22

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.

Problemen oplossen

`openclaw: command not found`

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

Find your global npm prefix

npm prefix -g

Check if it's on your PATH

echo "$PATH"

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

Add it to your shell startup file

macOS / Linux
Windows

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

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

Rechtenfouten bij `npm install -g` (Linux)

Als je EACCES-fouten ziet, wijzig dan de globale npm-prefix naar een map waarvoor de gebruiker schrijfrechten heeft:

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.

Help

Community

Omgeving en debugging

Node runtime

Compaction-internals

Developer-setup

Docs-meta

Node.js

Node.js

Controleer je versie

Node installeren

Problemen oplossen

`openclaw: command not found`

Rechtenfouten bij `npm install -g` (Linux)

​Node.js

​Controleer je versie

​Node installeren

​Problemen oplossen

​openclaw: command not found

​Rechtenfouten bij npm install -g (Linux)

Node.js

Controleer je versie

Node installeren

Problemen oplossen

`openclaw: command not found`

Rechtenfouten bij `npm install -g` (Linux)