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.
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 wanneer je OpenClaw en Node onder een lokaal voorvoegsel wilt bewaren, zoals
~/.openclaw, zonder afhankelijk te zijn van een systeembrede Node-installatie:
curl -fsSL https://openclaw.ai/install-cli.sh | bashHet 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
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 ontwikkelworkflows.
Installeren vanuit de main-checkout 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 interface.
Rootloos containeralternatief voor Docker.
Declaratieve installatie via een Nix-flake.
Geautomatiseerde inrichting van een machinepark.
Optioneel installatieprogramma voor afhankelijkheden en uitvoerder van pakketscripts.
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 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
Houd OpenClaw actueel.
Verplaats naar een nieuwe machine.
Verwijder OpenClaw volledig.
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.
node -v # Is Node geïnstalleerd?npm prefix -g # Waar staan globale pakketten?echo "$PATH" # Staat de globale binaire map in PATH?