Installatie

Al de Aan de slag-gids gevolgd? Dan ben je klaar — deze pagina is voor alternatieve installatiemethoden, platformspecifieke instructies en onderhoud.

Systeemvereisten

Node 24 (aanbevolen) (Node 22 LTS, momenteel 22.16+, wordt nog steeds ondersteund voor compatibiliteit; het installerscript installeert Node 24 als dat ontbreekt)
macOS, Linux of Windows
pnpm alleen als je vanuit broncode bouwt

Opmerking: Op Windows raden we sterk aan om OpenClaw onder WSL2 te draaien.

Installatiemethoden

Tip: Het installerscript is de aanbevolen manier om OpenClaw te installeren. Het regelt Node-detectie, installatie en onboarding in één stap.

Waarschuwing: Vermijd bij VPS/cloud-hosts waar mogelijk marketplace-images van derden (“1-click”). Gebruik liever een schone basis-OS-image (bijvoorbeeld Ubuntu LTS) en installeer OpenClaw zelf met het installerscript.

Installerscript

Download de CLI, installeert deze globaal via npm en start de onboarding-wizard.


  #### macOS / Linux / WSL2
    ```bash
    curl -fsSL https://openclaw.ai/install.sh | bash
    ```

  #### Windows (PowerShell)
    ```powershell
    iwr -useb https://openclaw.ai/install.ps1 | iex
    ```



Dat is alles — het script regelt Node-detectie, installatie en onboarding.

Om onboarding over te slaan en alleen de binary te installeren:


  #### macOS / Linux / WSL2
    ```bash
    curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
    ```

  #### Windows (PowerShell)
    ```powershell
    & ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard
    ```



Voor alle flags, omgevingsvariabelen en CI/automatiseringsopties, zie [Installer-internals](/docs/install/installer).

npm / pnpm

Als je Node al zelf beheert, raden we Node 24 aan. OpenClaw ondersteunt nog steeds Node 22 LTS, momenteel `22.16+`, voor compatibiliteit:


  #### npm
    ```bash
    npm install -g openclaw@latest
    openclaw onboard --install-daemon
    ```

    <details>

sharp build-fouten?

      Als je libvips globaal hebt geïnstalleerd (gebruikelijk op macOS via Homebrew) en `sharp` faalt, forceer dan voorgebouwde binaries:

      ```bash
      SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest
      ```

      Als je `sharp: Please add node-gyp to your dependencies` ziet, installeer dan build-tooling (macOS: Xcode CLT + `npm install -g node-gyp`) of gebruik de bovenstaande omgevingsvariabele.
    </details>

  #### pnpm
    ```bash
    pnpm add -g openclaw@latest
    pnpm approve-builds -g        # approve openclaw, node-llama-cpp, sharp, etc.
    openclaw onboard --install-daemon
    ```

    > **Opmerking:** pnpm vereist expliciete goedkeuring voor pakketten met build-scripts. Na de eerste installatie die de waarschuwing "Ignored build scripts" toont, voer je `pnpm approve-builds -g` uit en selecteer je de vermelde pakketten.

Vanuit broncode

Voor bijdragers of iedereen die vanuit een lokale checkout wil draaien.


  ### Stap 1: Klonen en bouwen
    Kloon de [OpenClaw-repo](https://github.com/openclaw/openclaw) en bouw:

    ```bash
    git clone https://github.com/openclaw/openclaw.git
    cd openclaw
    pnpm install
    pnpm ui:build
    pnpm build
    ```

  ### Stap 2: De CLI koppelen
    Maak het `openclaw`-commando globaal beschikbaar:

    ```bash
    pnpm link --global
    ```

    Je kunt de koppeling ook overslaan en commando's uitvoeren via `pnpm openclaw ...` vanuit de repo.

  ### Stap 3: Onboarding uitvoeren
    ```bash
    openclaw onboard --install-daemon
    ```



Voor uitgebreidere ontwikkelworkflows, zie [Setup](/docs/start/setup).

Overige installatiemethoden

Docker — Gecontaineriseerde of headless deployments.
Podman — Rootless container: voer eenmalig setup-podman.sh uit en gebruik daarna het startscript.
Nix — Declaratieve installatie via Nix.
Ansible — Geautomatiseerde fleet-provisioning.
Bun — Alleen CLI-gebruik via de Bun-runtime.

Na de installatie

Controleer of alles werkt:

openclaw doctor         # controleer op configuratieproblemen
openclaw status         # gateway-status
openclaw dashboard      # open de browser-UI

Als je aangepaste runtime-paden nodig hebt, gebruik dan:

OPENCLAW_HOME voor interne paden gebaseerd op de homedirectory
OPENCLAW_STATE_DIR voor de locatie van veranderlijke state
OPENCLAW_CONFIG_PATH voor de locatie van het configuratiebestand

Zie Omgevingsvariabelen voor voorrang en volledige details.

Probleemoplossing: `openclaw` niet gevonden

PATH-diagnose en oplossing

Snelle diagnose:

node -v
npm -v
npm prefix -g
echo "$PATH"

Als $(npm prefix -g)/bin (macOS/Linux) of $(npm prefix -g) (Windows) niet in je $PATH staat, kan je shell globale npm-binaries (waaronder openclaw) niet vinden.

Oplossing — voeg het toe aan je shell-opstartbestand (~/.zshrc of ~/.bashrc):

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

Op Windows voeg je de uitvoer van npm prefix -g toe aan je PATH.

Open daarna een nieuwe terminal (of rehash in zsh / hash -r in bash).

Bijwerken / verwijderen

Bijwerken — Houd OpenClaw up-to-date.
Migreren — Verplaats naar een nieuwe machine.
Verwijderen — Verwijder OpenClaw volledig.