Naar hoofdinhoud gaan

Documentation Index

Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Systeemvereisten

  • Node 24 (aanbevolen) of Node 22.16+ - het installatiescript regelt dit automatisch
  • macOS, Linux of Windows - zowel native Windows als WSL2 worden ondersteund; WSL2 is stabieler. Zie Windows.
  • pnpm is alleen nodig als je vanuit de broncode bouwt

Aanbevolen: installatiescript

De snelste manier om te installeren. Het detecteert je OS, installeert Node indien nodig, installeert OpenClaw en start de onboarding.
curl -fsSL https://openclaw.ai/install.sh | bash
Installeren zonder onboarding uit te voeren:
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
Zie Interne werking van de installer voor alle vlaggen en CI-/automatiseringsopties.

Alternatieve installatiemethoden

Lokale prefix-installer (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
Standaard worden npm-installaties ondersteund, plus git-checkout-installaties onder dezelfde prefix-flow. Volledige referentie: Interne werking van de installer. Al geinstalleerd? Wissel tussen package- 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 install -g openclaw@latest
openclaw onboard --install-daemon
Als sharp mislukt door een globaal geinstalleerde libvips:
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

Vanuit 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 Setup voor volledige ontwikkelworkflows.

Installeren vanaf GitHub main

npm install -g github:openclaw/openclaw#main

Containers en packagemanagers

Docker

Gecontaineriseerde of headless deployments.

Podman

Containeralternatief zonder rootrechten voor Docker.

Nix

Declaratieve installatie via Nix flake.

Ansible

Geautomatiseerde fleet-provisioning.

Bun

Alleen CLI-gebruik via de Bun-runtime.

De installatie verifieren

openclaw --version      # confirm the CLI is available
openclaw doctor         # check for config issues
openclaw gateway status # verify the Gateway is running
Als je beheerde opstart na installatie wilt:
  • macOS: LaunchAgent via openclaw onboard --install-daemon of openclaw gateway install
  • Linux/WSL2: systemd-gebruikersservice via dezelfde opdrachten
  • Native Windows: eerst Scheduled Task, met een login-item in de Startup-map per gebruiker als fallback als het maken van de taak wordt geweigerd

Hosting en deployment

Deploy OpenClaw op een cloudserver of VPS:

VPS

Elke Linux-VPS

Docker-VM

Gedeelde Docker-stappen

Kubernetes

K8s

Fly.io

Fly.io

Hetzner

Hetzner

GCP

Google Cloud

Azure

Azure

Railway

Railway

Render

Render

Northflank

Northflank

Bijwerken, migreren of verwijderen

Bijwerken

Houd OpenClaw up-to-date.

Migreren

Verplaats naar een nieuwe machine.

Verwijderen

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 dit dan toe aan je shell-startupbestand (~/.zshrc of ~/.bashrc):
export PATH="$(npm prefix -g)/bin:$PATH"
Open daarna een nieuwe terminal. Zie Node-setup voor meer details.