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¶

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

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.

bash npm prefix -g bash echo "$PATH"

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

Voeg 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).
      </Tab>
      <Tab title="Windows">
        Voeg de uitvoer van `npm prefix -g` toe aan je systeem-PATH via Instellingen → Systeem → Omgevingsvariabelen.
      </Tab>
    </Tabs>
    ```

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.