Installeren¶

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

Systeemvereisten¶

• Node 22+ (het installatiescript installeert dit indien nodig)
• macOS, Linux of Windows
• pnpm alleen als je vanaf de bron bouwt

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

Installatiemethoden¶

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

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

```
<Tabs>
  <Tab title="macOS / Linux / WSL2">
    ```bash
    curl -fsSL https://openclaw.ai/install.sh | bash
    ```
  </Tab>
  <Tab title="Windows (PowerShell)">
    ```powershell
    iwr -useb https://openclaw.ai/install.ps1 | iex
    ```
  </Tab>
</Tabs>

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

Om onboarding over te slaan en alleen het binaire bestand te installeren:

<Tabs>
  <Tab title="macOS / Linux / WSL2">
    ```bash
    curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
    ```
  </Tab>
  <Tab title="Windows (PowerShell)">
    ```powershell
    & ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard
    ```
  </Tab>
</Tabs>

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

Als je Node 22+ al hebt en de installatie zelf wilt beheren:

```
<Tabs>
  <Tab title="npm">
    ```bash
    npm install -g openclaw@latest
    openclaw onboard --install-daemon
    ```

    <Accordion title="sharp-buildfouten?">
      Als je libvips globaal hebt geïnstalleerd (gebruikelijk op macOS via Homebrew) en `sharp` faalt, forceer dan vooraf gebouwde 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.
    </Accordion>
  </Tab>
  <Tab title="pnpm">
    ```bash
    pnpm add -g openclaw@latest
    pnpm approve-builds -g        # approve openclaw, node-llama-cpp, sharp, etc.
    openclaw onboard --install-daemon
    ```

    <Note>
    pnpm vereist expliciete goedkeuring voor pakketten met build-scripts. Nadat de eerste installatie de waarschuwing "Ignored build scripts" toont, voer `pnpm approve-builds -g` uit en selecteer de vermelde pakketten.
    </Note>
  </Tab>
</Tabs>
```

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

```
<Steps>
  <Step title="Clonen en bouwen">
    Clone 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
    ```
  </Step>
  <Step title="De CLI koppelen">
    Maak het `openclaw`-commando globaal beschikbaar:

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

    Je kunt ook het koppelen overslaan en opdrachten uitvoeren via `pnpm openclaw ...` vanuit de repo.
  </Step>
  <Step title="Onboarding uitvoeren">
    ```bash
    openclaw onboard --install-daemon
    ```
  </Step>
</Steps>

Voor uitgebreidere ontwikkelworkflows, zie [Installatie](/start/setup).
```

Andere installatiemethoden¶

Gecontaineriseerde of headless deployments. Declaratieve installatie via Nix. Geautomatiseerde provisioning van fleets. Alleen-CLI-gebruik via de Bun-runtime.

Na installatie¶

Controleer of alles werkt:

openclaw doctor         # check for config issues
openclaw status         # gateway status
openclaw dashboard      # open the browser UI

Als je aangepaste runtimepaden nodig hebt, gebruik:

• OPENCLAW_HOME voor op de homemap gebaseerde interne paden
• OPENCLAW_STATE_DIR voor de locatie van wijzigbare status
• OPENCLAW_CONFIG_PATH voor de locatie van het configuratiebestand

Zie Environment vars voor voorrang en alle details.

Problemen oplossen: openclaw niet gevonden¶

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 (inclusief openclaw) niet vinden.

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

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

Voeg op Windows 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¶

Houd OpenClaw up-to-date. Verhuizen naar een nieuwe machine. OpenClaw volledig verwijderen.