Installeren

Systeemvereisten

• Node 24 (aanbevolen) of Node 22.19+ - het installatiescript handelt dit automatisch af
• macOS, Linux of Windows - Windows-gebruikers kunnen beginnen met de native Windows Hub-app, de PowerShell CLI-installer of een WSL2 Gateway. Zie Windows.
• pnpm is alleen nodig als je vanaf broncode bouwt

Aanbevolen: installatiescript

De snelste manier om te installeren. Het detecteert je OS, installeert Node indien nodig, installeert OpenClaw en start onboarding.

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

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

Installeren zonder onboarding uit te voeren:

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

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

Zie Interne werking van de installer voor alle flags en opties voor CI/automatisering.

Alternatieve installatiemethoden

Lokale prefix-installer (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

Deze ondersteunt standaard npm-installaties, plus git-checkout-installaties binnen dezelfde prefix-flow. Volledige referentie: Interne werking van de installer.

Al geinstalleerd? Wissel tussen package- 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 install -g openclaw@latestopenclaw onboard --install-daemon

pnpm add -g openclaw@latestpnpm approve-builds -gopenclaw onboard --install-daemon

bun add -g openclaw@latestopenclaw onboard --install-daemon

Vanaf broncode

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

git clone https://github.com/openclaw/openclaw.gitcd openclawpnpm install && pnpm build && pnpm ui:buildpnpm link --globalopenclaw onboard --install-daemon

Of sla de link over en gebruik pnpm openclaw ... vanuit de repo. Zie Setup voor volledige ontwikkelworkflows.

Installeren vanaf de GitHub main-checkout

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git --version main

Containers en packagebeheerders

De installatie verifiëren

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

Als je beheerde opstart na installatie wilt:

• macOS: LaunchAgent via openclaw onboard --install-daemon of openclaw gateway install
• Linux/WSL2: systemd-gebruikersservice via dezelfde opdrachten
• Native Windows: eerst Scheduled Task, met een per-gebruiker login-item in de Startup-map als fallback als taakaanmaak wordt geweigerd

Hosting en deployment

Deploy OpenClaw op een cloudserver of VPS:

Bijwerken, migreren of verwijderen

Probleemoplossing: openclaw niet gevonden

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

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 dit toe aan het opstartbestand van je shell (~/.zshrc of ~/.bashrc):

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

Open daarna een nieuwe terminal. Zie Node-setup voor meer details.