Install overview

Installeren

Systeemvereisten

  • Node 22.19+, 23.11+ of 24+ - 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 als je OpenClaw en Node onder een lokaal voorvoegsel zoals ~/.openclaw wilt bewaren, 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, plus installaties vanuit een git-checkout binnen dezelfde voorvoegselstroom. Volledige referentie: Interne werking van het installatieprogramma.

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

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

Installeren vanuit de hoofdcheckout 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 map Opstarten 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

Dit is bijna altijd een PATH-probleem: de globale bin-map van npm staat niet in de PATH van je shell. Zie Problemen met Node.js oplossen 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 bin-map in PATH?
Was this useful?
On this page

On this page