Install overview
Installeren
Systeemvereisten
- Node 24 (aanbevolen) of Node 22.16+ - het installatiescript regelt dit automatisch
- macOS, Linux of Windows - zowel native Windows als WSL2 worden ondersteund; WSL2 is stabieler. Zie Windows.
pnpmis alleen nodig als je vanuit de broncode bouwt
Aanbevolen: installatiescript
De snelste manier om te installeren. Het detecteert je OS, installeert Node indien nodig, installeert OpenClaw en start de onboarding.
macOS / Linux / WSL2
curl -fsSL https://openclaw.ai/install.sh | bashWindows (PowerShell)
iwr -useb https://openclaw.ai/install.ps1 | iexInstalleren zonder onboarding uit te voeren:
macOS / Linux / WSL2
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboardWindows (PowerShell)
& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboardZie Interne werking van de installer voor alle vlaggen en CI-/automatiseringsopties.
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 | bashStandaard worden npm-installaties ondersteund, plus git-checkout-installaties onder 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
npm install -g openclaw@latestopenclaw onboard --install-daemonpnpm
pnpm add -g openclaw@latestpnpm approve-builds -gopenclaw onboard --install-daemonbun
bun add -g openclaw@latestopenclaw onboard --install-daemonProbleemoplossing: sharp-buildfouten (npm)
Als sharp mislukt door een globaal geinstalleerde libvips:
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latestVanuit broncode
Voor bijdragers 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-daemonOf sla de link over en gebruik pnpm openclaw ... vanuit de repo. Zie Setup voor volledige ontwikkelworkflows.
Installeren vanaf GitHub main
npm install -g github:openclaw/openclaw#mainContainers en packagemanagers
Gecontaineriseerde of headless deployments.
Containeralternatief zonder rootrechten voor Docker.
Declaratieve installatie via Nix flake.
Geautomatiseerde fleet-provisioning.
Alleen CLI-gebruik via de Bun-runtime.
De installatie verifieren
openclaw --version # confirm the CLI is availableopenclaw doctor # check for config issuesopenclaw gateway status # verify the Gateway is runningAls je beheerde opstart na installatie wilt:
- macOS: LaunchAgent via
openclaw onboard --install-daemonofopenclaw gateway install - Linux/WSL2: systemd-gebruikersservice via dezelfde opdrachten
- Native Windows: eerst Scheduled Task, met een login-item in de Startup-map per gebruiker als fallback als het maken van de taak wordt geweigerd
Hosting en deployment
Deploy OpenClaw op een cloudserver of VPS:
Bijwerken, migreren of verwijderen
Houd OpenClaw up-to-date.
Verplaats naar een nieuwe machine.
Verwijder OpenClaw volledig.
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 dit dan toe aan je shell-startupbestand (~/.zshrc of ~/.bashrc):
export PATH="$(npm prefix -g)/bin:$PATH"Open daarna een nieuwe terminal. Zie Node-setup voor meer details.