Naar hoofdinhoud gaan

​
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.
Windows-desktopgebruikers kunnen ook de native Windows Hub companion-app installeren, met setup, traystatus, chat, node-modus en lokale MCP-modus.
curl -fsSL https://openclaw.ai/install.sh | bash
Installeren zonder onboarding uit te voeren: 
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
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@latest
openclaw onboard --install-daemon
De gehoste installer wist npm-versheidsfilters zoals min-release-age voor de installatie van het OpenClaw-package. Als je handmatig met npm installeert, blijft je eigen npm-beleid van toepassing.

​
Vanaf broncode

Voor contributors 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 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

Docker

Gecontaineriseerde of headless deployments.

Podman

Rootless containeralternatief voor Docker.

Nix

Declaratieve installatie via Nix flake.

Ansible

Geautomatiseerde fleet-provisioning.

Bun

Alleen CLI-gebruik via de Bun-runtime.

​
De installatie verifiëren

openclaw --version      # confirm the CLI is available
openclaw doctor         # check for config issues
openclaw 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:

VPS

Elke Linux-VPS.

Docker VM

Gedeelde Docker-stappen.

Kubernetes

K8s-deployment.

Fly.io

Deploy op Fly.io.

Hetzner

Hetzner-deployment.

GCP

Google Cloud-deployment.

Azure

Azure-deployment.

Railway

Railway-deployment.

Render

Render-deployment.

Northflank

Northflank-deployment.

​
Bijwerken, migreren of verwijderen

Updating

Houd OpenClaw up-to-date.

Migrating

Verplaats naar een nieuwe machine.

Uninstall

Verwijder OpenClaw volledig.

​
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.