Naar hoofdinhoud gaan

Documentation Index

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

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

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.
  • pnpm is alleen nodig als je vanuit 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 opties voor CI/automatisering.

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
Deze ondersteunt standaard npm-installaties, plus git-checkout-installaties binnen dezelfde prefix-flow. Volledige referentie: Interne werking van de installer. Al geïnstalleerd? 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 faalt door een globaal geïnstalleerde libvips:
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

Vanuit broncode

Voor contributors 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 vanuit GitHub main

npm install -g github:openclaw/openclaw#main

Containers en packagemanagers

Docker

Gecontaineriseerde of headless deployments.

Podman

Rootless containeralternatief voor Docker.

Nix

Declaratieve installatie via Nix flake.

Ansible

Geautomatiseerde fleet-provisioning.

Bun

Alleen-CLI-gebruik via de Bun-runtime.

De installatie verifiëren

openclaw --version      # confirm the CLI is available
openclaw doctor         # check for config issues
openclaw gateway status # verify the Gateway is running
Als je beheerde startup 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 fallback naar een login-item in de Startup-map per gebruiker als taakcreatie 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

Updating

Houd OpenClaw up-to-date.

Migrating

Verplaats naar een nieuwe machine.

Uninstall

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 het 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.