Install overview
Installeren
Systeemvereisten
- Node 24 (aanbevolen) of Node 22.14+ - het installatiescript handelt dit automatisch af
- macOS, Linux of Windows - zowel native Windows als WSL2 worden ondersteund; WSL2 is stabieler. Zie Windows.
pnpmis alleen nodig als je vanaf broncode bouwt
Aanbevolen: installatiescript
De snelste manier om te installeren. Het detecteert je besturingssysteem, installeert Node indien nodig, installeert OpenClaw en start het introductieproces.
macOS / Linux / WSL2
curl -fsSL https://openclaw.ai/install.sh | bash
Windows (PowerShell)
iwr -useb https://openclaw.ai/install.ps1 | iex
Installeren zonder het introductieproces uit te voeren:
macOS / Linux / WSL2
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
Windows (PowerShell)
& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard
Zie voor alle flags en CI-/automatiseringsopties Interne werking van het installatiescript.
Alternatieve installatiemethoden
Installer met lokale prefix (install-cli.sh)
Gebruik dit wanneer je OpenClaw en Node onder een lokale prefix zoals
~/.openclaw wilt houden, zonder afhankelijk te zijn van een systeembrede Node-installatie:
curl -fsSL https://openclaw.ai/install-cli.sh | bash
Het ondersteunt standaard npm-installaties, plus git-checkout-installaties via dezelfde prefix-werkwijze. Volledige referentie: Interne werking van het installatiescript.
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@latest
openclaw onboard --install-daemon
pnpm
pnpm add -g openclaw@latest
pnpm approve-builds -g
openclaw onboard --install-daemon
bun
bun add -g openclaw@latest
openclaw onboard --install-daemon
Probleemoplossing: buildfouten van sharp (npm)
Als sharp faalt door een globaal geïnstalleerde libvips:
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest
Vanaf broncode
Voor bijdragers of iedereen die vanuit een lokale checkout wil draaien:
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install && pnpm build && pnpm ui:build
pnpm link --global
openclaw onboard --install-daemon
Of sla de link over en gebruik pnpm openclaw ... vanuit de repo. Zie Installatie voor volledige ontwikkelwerkwijzen.
Installeren vanaf GitHub main
npm install -g github:openclaw/openclaw#main
Containers en pakketbeheerders
Gecontaineriseerde implementaties of implementaties zonder grafische interface.
Containeralternatief voor Docker zonder rootrechten.
Declaratieve installatie via Nix-flake.
Geautomatiseerde inrichting van een servervloot.
Gebruik alleen via de CLI met de Bun-runtime.
Controleer de installatie
openclaw --version # confirm the CLI is available
openclaw doctor # check for config issues
openclaw gateway status # verify the Gateway is running
Als je beheerd opstarten na installatie wilt:
- macOS: LaunchAgent via
openclaw onboard --install-daemonofopenclaw gateway install - Linux/WSL2: systemd-gebruikersservice via dezelfde opdrachten
- Native Windows: eerst een geplande taak, met een loginitem in de Opstartmap per gebruiker als terugvaloptie als het maken van de taak wordt geweigerd
Hosting en implementatie
Implementeer OpenClaw op een cloudserver of VPS:
OPENCLAW_DOCS_MARKER:cardOpen:IHRpdGxlPSJGbHkuaW8iIGhyZWY9Ii9ubC9pbnN0YWxsL2ZseSI Fly.io OPENCLAW_DOCS_MARKER:cardClose:
Bijwerken, migreren of verwijderen
Houd OpenClaw bijgewerkt.
Verhuis naar een nieuwe machine.
Verwijder OpenClaw volledig.
Probleemoplossing: openclaw niet gevonden
Als de installatie is geslaagd maar openclaw niet wordt gevonden in je terminal:
node -v # Node installed?
npm prefix -g # Where are global packages?
echo "$PATH" # Is the global bin dir in PATH?
Als $(npm prefix -g)/bin niet in je $PATH staat, voeg deze toe aan je shell-opstartbestand (~/.zshrc of ~/.bashrc):
export PATH="$(npm prefix -g)/bin:$PATH"
Open daarna een nieuwe terminal. Zie Node-installatie voor meer informatie.
Docs agent