Install overview

Installeren

Systeemvereisten

  • Node 22.22.3+, 24.15+ of 25.9+ - Node 24 is het standaarddoel; het installatiescript regelt dit automatisch.
  • macOS, Linux of Windows - Windows-gebruikers kunnen beginnen met de systeemeigen Windows Hub-app, het PowerShell-installatieprogramma voor de CLI of een WSL2-Gateway. Zie Windows.
  • pnpm is alleen nodig als je vanuit de broncode bouwt.

Aanbevolen: installatiescript

De snelste installatiemethode. Het detecteert je besturingssysteem, installeert indien nodig Node, installeert OpenClaw en start de configuratie.

macOS / Linux / WSL2

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

Windows (PowerShell)

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

Installeren zonder de configuratie uit te voeren:

macOS / Linux / WSL2

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

Windows (PowerShell)

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

Zie Interne werking van het installatieprogramma voor alle vlaggen en opties voor CI/automatisering.

Alternatieve installatiemethoden

Installatieprogramma met lokaal voorvoegsel (install-cli.sh)

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

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

Het ondersteunt standaard installaties via npm en daarnaast installaties vanuit een git-checkout binnen dezelfde voorvoegselstroom. Volledige naslag: Interne werking van het installatieprogramma.

Al geïnstalleerd? Wissel 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

bash
npm install -g openclaw@latestopenclaw onboard --install-daemon

pnpm

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

bun

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

Vanuit de broncode

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

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

Je kunt de koppeling ook overslaan en pnpm openclaw ... vanuit de repository gebruiken. Zie Configuratie voor volledige ontwikkelworkflows.

Installeren vanuit de main-checkout op GitHub

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

Containers en pakketbeheerders

De installatie verifiëren

bash
openclaw --version      # bevestig dat de CLI beschikbaar isopenclaw doctor         # controleer op configuratieproblemenopenclaw gateway status # controleer of de Gateway actief is

Als je na de installatie beheerd opstarten wilt:

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

Hosting en implementatie

Implementeer OpenClaw op een cloudserver of VPS. Zie Linux-server voor de volledige providerkeuze (DigitalOcean, Hetzner, Hostinger, Fly.io, GCP, Azure, Railway, Northflank, Oracle Cloud, Raspberry Pi en meer), of implementeer declaratief op Render.

Bijwerken, migreren of verwijderen

Probleemoplossing: openclaw niet gevonden

Bijna altijd een PATH-probleem: de globale binaire map van npm staat niet in PATH van je shell. Zie Probleemoplossing voor Node.js voor de volledige oplossing, inclusief het Windows-pad.

bash
node -v           # Is Node geïnstalleerd?npm prefix -g     # Waar staan globale pakketten?echo "$PATH"      # Staat de globale binaire map in PATH?
Was this useful?
On this page

On this page