Install overview

Installeren

Systeemvereisten

  • Node 24 (aanbevolen) of Node 22.14+ - het installatiescript handelt dit automatisch af
  • macOS, Linux of Windows - zowel native Windows als WSL2 worden ondersteund; WSL2 is stabieler. Zie Windows.
  • pnpm is alleen nodig als je vanaf broncode bouwt

Aanbevolen: installatiescript

De snelste manier om te installeren. Het detecteert je besturingssysteem, installeert Node indien nodig, installeert OpenClaw en start het introductieproces.

macOS / Linux / WSL2

curl -fsSL https://openclaw.ai/install.sh | bash

Windows (PowerShell)

iwr -useb https://openclaw.ai/install.ps1 | iex

Installeren zonder het introductieproces uit te voeren:

macOS / Linux / WSL2

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard

Windows (PowerShell)

& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard

Zie voor alle flags en CI-/automatiseringsopties Interne werking van het installatiescript.

Alternatieve installatiemethoden

Installer met lokale prefix (install-cli.sh)

Gebruik dit wanneer je OpenClaw en Node onder een lokale prefix zoals ~/.openclaw wilt houden, zonder afhankelijk te zijn van een systeembrede Node-installatie:

curl -fsSL https://openclaw.ai/install-cli.sh | bash

Het ondersteunt standaard npm-installaties, plus git-checkout-installaties via dezelfde prefix-werkwijze. Volledige referentie: Interne werking van het installatiescript.

Al geïnstalleerd? Schakel tussen pakket- en git-installaties met openclaw update --channel dev en openclaw update --channel stable. Zie Bijwerken.

npm, pnpm of bun

Als je Node al zelf beheert:

npm

npm install -g openclaw@latest
openclaw onboard --install-daemon

pnpm

pnpm add -g openclaw@latest
pnpm approve-builds -g
openclaw onboard --install-daemon

bun

bun add -g openclaw@latest
openclaw onboard --install-daemon
Probleemoplossing: buildfouten van sharp (npm)

Als sharp faalt door een globaal geïnstalleerde libvips:

SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

Vanaf broncode

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

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install && pnpm build && pnpm ui:build
pnpm link --global
openclaw onboard --install-daemon

Of sla de link over en gebruik pnpm openclaw ... vanuit de repo. Zie Installatie voor volledige ontwikkelwerkwijzen.

Installeren vanaf GitHub main

npm install -g github:openclaw/openclaw#main

Containers en pakketbeheerders

Controleer de installatie

openclaw --version      # confirm the CLI is available
openclaw doctor         # check for config issues
openclaw gateway status # verify the Gateway is running

Als je beheerd opstarten na installatie wilt:

  • macOS: LaunchAgent via openclaw onboard --install-daemon of openclaw gateway install
  • Linux/WSL2: systemd-gebruikersservice via dezelfde opdrachten
  • Native Windows: eerst een geplande taak, met een loginitem in de Opstartmap per gebruiker als terugvaloptie als het maken van de taak wordt geweigerd

Hosting en implementatie

Implementeer OpenClaw op een cloudserver of VPS:

VPS
Docker VM
Kubernetes

OPENCLAW_DOCS_MARKER:cardOpen:IHRpdGxlPSJGbHkuaW8iIGhyZWY9Ii9ubC9pbnN0YWxsL2ZseSI Fly.io OPENCLAW_DOCS_MARKER:cardClose:

Hetzner
GCP
Azure
Railway
Render
Northflank

Bijwerken, migreren of verwijderen

Probleemoplossing: openclaw niet gevonden

Als de installatie is geslaagd maar openclaw niet wordt gevonden in je terminal:

node -v           # Node installed?
npm prefix -g     # Where are global packages?
echo "$PATH"      # Is the global bin dir in PATH?

Als $(npm prefix -g)/bin niet in je $PATH staat, voeg deze toe aan je shell-opstartbestand (~/.zshrc of ~/.bashrc):

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

Open daarna een nieuwe terminal. Zie Node-installatie voor meer informatie.