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.
pnpmis 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
curl -fsSL https://openclaw.ai/install.sh | bashWindows (PowerShell)
iwr -useb https://openclaw.ai/install.ps1 | iexInstalleren zonder de configuratie 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 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:
curl -fsSL https://openclaw.ai/install-cli.sh | bashHet 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
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-daemonVanuit de broncode
Voor bijdragers of iedereen die vanuit een lokale checkout wil werken:
git clone https://github.com/openclaw/openclaw.gitcd openclawpnpm install && pnpm build && pnpm ui:buildpnpm link --globalopenclaw onboard --install-daemonJe kunt de koppeling ook overslaan en pnpm openclaw ... vanuit de repository gebruiken. Zie Configuratie voor volledige ontwikkelwerkstromen.
Installeren vanuit de hoofdcheckout op GitHub
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git --version mainContainers en pakketbeheerders
Implementaties in containers of zonder grafische omgeving.
Rootless containeralternatief voor Docker.
Declaratieve installatie via een Nix-flake.
Geautomatiseerde inrichting van een machinepark.
Gebruik van alleen de CLI via de Bun-runtime.
De installatie verifiëren
openclaw --version # bevestig dat de CLI beschikbaar isopenclaw doctor # controleer op configuratieproblemenopenclaw gateway status # controleer of de Gateway actief isAls je na de installatie beheerd opstarten wilt:
- macOS: LaunchAgent via
openclaw onboard --install-daemonofopenclaw 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
Houd OpenClaw actueel.
Verplaats naar een nieuwe machine.
Verwijder OpenClaw volledig.
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.
node -v # Is Node geïnstalleerd?npm prefix -g # Waar staan globale pakketten?echo "$PATH" # Staat de globale bin-map in PATH?