Skip to main content

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.
Gebruikers van Windows-desktop kunnen ook de systeemeigen begeleidende app Windows Hub installeren. Deze bevat configuratie, systeemvakstatus, chat, Node-modus en lokale MCP-modus.
Installeren zonder de configuratie uit te voeren:
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:
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:
Het gehoste installatieprogramma wist npm-filters voor actualiteit, zoals min-release-age, voor de installatie van het OpenClaw-pakket. Als je handmatig met npm installeert, blijft je eigen npm-beleid van toepassing.

Vanuit de broncode

Voor bijdragers of iedereen die vanuit een lokale checkout wil werken:
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

Containers en pakketbeheerders

Docker

Implementaties in containers of zonder grafische interface.

Podman

Rootloos containeralternatief voor Docker.

Nix

Declaratieve installatie via een Nix-flake.

Ansible

Geautomatiseerde inrichting van een machinepark.

Bun

Optioneel installatieprogramma voor afhankelijkheden en uitvoerder van pakketscripts.

De installatie verifiëren

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.

VPS

Kies een provider.

Docker-VM

Gedeelde Docker-stappen.

Kubernetes

K8s-implementatie.

Bijwerken, migreren of verwijderen

Bijwerken

Houd OpenClaw actueel.

Migreren

Verplaats naar een nieuwe machine.

Verwijderen

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.