Interne werking van het installatieprogramma

OpenClaw levert drie installatiescripts, aangeboden vanaf openclaw.ai.

Script	Platform	Wat het doet
`install.sh`	macOS / Linux / WSL	Installeert Node indien nodig, installeert OpenClaw via npm (standaard) of git, en kan onboarding uitvoeren.
`install-cli.sh`	macOS / Linux / WSL	Installeert Node + OpenClaw in een lokale prefix (`~/.openclaw`) met npm- of git-checkoutmodi. Geen root vereist.
`install.ps1`	Windows (PowerShell)	Installeert Node indien nodig, installeert OpenClaw via npm (standaard) of git, en kan onboarding uitvoeren.

Snelle opdrachten

install.sh
install-cli.sh
install.ps1

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --help

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --help

iwr -useb https://openclaw.ai/install.ps1 | iex

& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -Tag beta -NoOnboard -DryRun

Als de installatie slaagt maar openclaw niet wordt gevonden in een nieuwe terminal, zie Problemen met Node.js oplossen.

install.sh

Aanbevolen voor de meeste interactieve installaties op macOS/Linux/WSL.

Verloop (install.sh)

Detect OS

Ondersteunt macOS en Linux (inclusief WSL). Als macOS wordt gedetecteerd, wordt Homebrew geïnstalleerd als dit ontbreekt.

Ensure Node.js 24 by default

Controleert de Node-versie en installeert Node 24 indien nodig (Homebrew op macOS, NodeSource-installatiescripts op Linux apt/dnf/yum). OpenClaw ondersteunt nog steeds Node 22 LTS, momenteel 22.14+, voor compatibiliteit.

Ensure Git

Installeert Git als dit ontbreekt.

Install OpenClaw

npm-methode (standaard): globale npm-installatie
git-methode: repo klonen/bijwerken, afhankelijkheden installeren met pnpm, bouwen, en vervolgens wrapper installeren op ~/.local/bin/openclaw

Post-install tasks

Vernieuwt een geladen gateway-service op best-effortbasis (openclaw gateway install --force, daarna herstart)
Voert openclaw doctor --non-interactive uit bij upgrades en git-installaties (best effort)
Probeert onboarding wanneer dat passend is (TTY beschikbaar, onboarding niet uitgeschakeld, en bootstrap-/configuratiecontroles slagen)
Stelt standaard SHARP_IGNORE_GLOBAL_LIBVIPS=1 in

Detectie van source-checkout

Als het script wordt uitgevoerd binnen een OpenClaw-checkout (package.json + pnpm-workspace.yaml), biedt het script:

checkout gebruiken (git), of
globale installatie gebruiken (npm)

Als er geen TTY beschikbaar is en er geen installatiemethode is ingesteld, gebruikt het standaard npm en geeft het een waarschuwing. Het script sluit af met code 2 bij een ongeldige methodekeuze of ongeldige --install-method-waarden.

Voorbeelden (install.sh)

Default
Skip onboarding
Git install
GitHub main via npm
Dry run

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --no-onboard

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --version main

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --dry-run

Flags reference

Vlag	Beschrijving
`--install-method npm\|git`	Kies de installatiemethode (standaard: `npm`). Alias: `--method`
`--npm`	Snelkoppeling voor npm-methode
`--git`	Snelkoppeling voor git-methode. Alias: `--github`
`--version <version\|dist-tag\|spec>`	npm-versie, dist-tag of pakketspecificatie (standaard: `latest`)
`--beta`	Gebruik beta dist-tag indien beschikbaar, anders terugvallen op `latest`
`--git-dir <path>`	Checkoutmap (standaard: `~/openclaw`). Alias: `--dir`
`--no-git-update`	Sla `git pull` over voor bestaande checkout
`--no-prompt`	Schakel prompts uit
`--no-onboard`	Sla onboarding over
`--onboard`	Schakel onboarding in
`--dry-run`	Druk acties af zonder wijzigingen toe te passen
`--verbose`	Schakel debuguitvoer in (`set -x`, npm notice-level logs)
`--help`	Toon gebruik (`-h`)

Environment variables reference

Variabele	Beschrijving
`OPENCLAW_INSTALL_METHOD=git\|npm`	Installatiemethode
`OPENCLAW_VERSION=latest\|next\|main\|<semver>\|<spec>`	npm-versie, dist-tag of pakketspecificatie
`OPENCLAW_BETA=0\|1`	Gebruik beta indien beschikbaar
`OPENCLAW_GIT_DIR=<path>`	Checkoutmap
`OPENCLAW_GIT_UPDATE=0\|1`	Git-updates in-/uitschakelen
`OPENCLAW_NO_PROMPT=1`	Schakel prompts uit
`OPENCLAW_NO_ONBOARD=1`	Sla onboarding over
`OPENCLAW_DRY_RUN=1`	Dry-runmodus
`OPENCLAW_VERBOSE=1`	Debugmodus
`OPENCLAW_NPM_LOGLEVEL=error\|warn\|notice`	npm-logniveau
`SHARP_IGNORE_GLOBAL_LIBVIPS=0\|1`	Beheer sharp/libvips-gedrag (standaard: `1`)

install-cli.sh

Ontworpen voor omgevingen waarin je alles onder een lokale prefix (standaard ~/.openclaw) wilt hebben en geen systeemafhankelijkheid van Node wilt. Ondersteunt standaard npm-installaties, plus git-checkoutinstallaties binnen dezelfde prefix-flow.

Verloop (install-cli.sh)

Install local Node runtime

Downloadt een vastgepinde ondersteunde Node LTS-tarball (de versie is ingesloten in het script en wordt onafhankelijk bijgewerkt) naar <prefix>/tools/node-v<version> en verifieert SHA-256.

Ensure Git

Als Git ontbreekt, probeert het installatie via apt/dnf/yum op Linux of Homebrew op macOS.

Install OpenClaw under prefix

npm-methode (standaard): installeert onder de prefix met npm en schrijft vervolgens de wrapper naar <prefix>/bin/openclaw
git-methode: kloont/bijwerkt een checkout (standaard ~/openclaw) en schrijft nog steeds de wrapper naar <prefix>/bin/openclaw

Refresh loaded gateway service

Als er al een gateway-service vanaf dezelfde prefix is geladen, voert het script openclaw gateway install --force uit, daarna openclaw gateway restart, en controleert het de gateway-gezondheid op best-effortbasis.

Voorbeelden (install-cli.sh)

Default
Custom prefix + version
Git install
Automation JSON output
Run onboarding

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --prefix /opt/openclaw --version latest

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --install-method git --git-dir ~/openclaw

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --json --prefix /opt/openclaw

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --onboard

Flags reference

Vlag	Beschrijving
`--prefix <path>`	Installatieprefix (standaard: `~/.openclaw`)
`--install-method npm\|git`	Kies de installatiemethode (standaard: `npm`). Alias: `--method`
`--npm`	Snelkoppeling voor npm-methode
`--git`, `--github`	Snelkoppeling voor git-methode
`--git-dir <path>`	Git-checkoutmap (standaard: `~/openclaw`). Alias: `--dir`
`--version <ver>`	OpenClaw-versie of dist-tag (standaard: `latest`)
`--node-version <ver>`	Node-versie (standaard: `22.22.0`)
`--json`	Geef NDJSON-events uit
`--onboard`	Voer `openclaw onboard` uit na installatie
`--no-onboard`	Sla onboarding over (standaard)
`--set-npm-prefix`	Forceer op Linux de npm-prefix naar `~/.npm-global` als de huidige prefix niet schrijfbaar is
`--help`	Toon gebruik (`-h`)

Environment variables reference

Variable	Beschrijving
`OPENCLAW_PREFIX=<path>`	Installatievoorvoegsel
`OPENCLAW_INSTALL_METHOD=git\|npm`	Installatiemethode
`OPENCLAW_VERSION=<ver>`	OpenClaw-versie of dist-tag
`OPENCLAW_NODE_VERSION=<ver>`	Node-versie
`OPENCLAW_GIT_DIR=<path>`	Git-checkoutmap voor git-installaties
`OPENCLAW_GIT_UPDATE=0\|1`	Git-updates in- of uitschakelen voor bestaande checkouts
`OPENCLAW_NO_ONBOARD=1`	Onboarding overslaan
`OPENCLAW_NPM_LOGLEVEL=error\|warn\|notice`	npm-logniveau
`SHARP_IGNORE_GLOBAL_LIBVIPS=0\|1`	sharp/libvips-gedrag beheren (standaard: `1`)

install.ps1

Flow (install.ps1)

PowerShell + Windows-omgeving garanderen

Vereist PowerShell 5+.

Standaard Node.js 24 garanderen

Als dit ontbreekt, wordt geprobeerd te installeren via winget, daarna Chocolatey en daarna Scoop. Node 22 LTS, momenteel 22.14+, blijft ondersteund voor compatibiliteit.

OpenClaw installeren

npm-methode (standaard): globale npm-installatie met de geselecteerde -Tag
git-methode: repo klonen/bijwerken, installeren/bouwen met pnpm en wrapper installeren op %USERPROFILE%\.local\bin\openclaw.cmd

Taken na installatie

Voegt waar mogelijk de benodigde bin-map toe aan het gebruikers-PATH
Vernieuwt naar beste kunnen een geladen Gateway-service (openclaw gateway install --force, daarna herstarten)
Voert openclaw doctor --non-interactive uit bij upgrades en git-installaties (naar beste kunnen)

Fouten afhandelen

iwr ... | iex en scriptblock-installaties melden een afsluitende fout zonder de huidige PowerShell-sessie te sluiten. Directe powershell -File- / pwsh -File-installaties sluiten nog steeds af met een niet-nulstatus voor automatisering.

Voorbeelden (install.ps1)

iwr -useb https://openclaw.ai/install.ps1 | iex

& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -InstallMethod git

& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -Tag main

& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -InstallMethod git -GitDir "C:\openclaw"

& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -DryRun

# install.ps1 has no dedicated -Verbose flag yet.
Set-PSDebug -Trace 1
& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard
Set-PSDebug -Trace 0

Referentie voor flags

Flag	Beschrijving
`-InstallMethod npm\|git`	Installatiemethode (standaard: `npm`)
`-Tag <tag\|version\|spec>`	npm-dist-tag, versie of pakketspecificatie (standaard: `latest`)
`-GitDir <path>`	Checkoutmap (standaard: `%USERPROFILE%\openclaw`)
`-NoOnboard`	Onboarding overslaan
`-NoGitUpdate`	`git pull` overslaan
`-DryRun`	Alleen acties afdrukken

Referentie voor omgevingsvariabelen

Variable	Beschrijving
`OPENCLAW_INSTALL_METHOD=git\|npm`	Installatiemethode
`OPENCLAW_GIT_DIR=<path>`	Checkoutmap
`OPENCLAW_NO_ONBOARD=1`	Onboarding overslaan
`OPENCLAW_GIT_UPDATE=0`	git pull uitschakelen
`OPENCLAW_DRY_RUN=1`	Dry-runmodus

Als -InstallMethod git wordt gebruikt en Git ontbreekt, sluit het script af en drukt het de link naar Git for Windows af.

CI en automatisering

Gebruik niet-interactieve flags/omgevingsvariabelen voor voorspelbare runs.

install.sh (niet-interactieve npm)
install.sh (niet-interactieve git)
install-cli.sh (JSON)
install.ps1 (onboarding overslaan)

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --no-prompt --no-onboard

OPENCLAW_INSTALL_METHOD=git OPENCLAW_NO_PROMPT=1 \
  curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --json --prefix /opt/openclaw

& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard

Probleemoplossing

Waarom is Git vereist?

Git is vereist voor de git-installatiemethode. Voor npm-installaties wordt Git nog steeds gecontroleerd/geïnstalleerd om spawn git ENOENT-fouten te voorkomen wanneer afhankelijkheden git-URL’s gebruiken.

Waarom krijgt npm EACCES op Linux?

Sommige Linux-configuraties laten de globale npm-prefix naar paden wijzen die eigendom zijn van root. install.sh kan de prefix wijzigen naar ~/.npm-global en PATH-exports toevoegen aan shell-rc-bestanden (wanneer die bestanden bestaan).

sharp/libvips-problemen

De scripts gebruiken standaard SHARP_IGNORE_GLOBAL_LIBVIPS=1 om te voorkomen dat sharp wordt gebouwd tegen de systeemversie van libvips. Overschrijven kan zo:

SHARP_IGNORE_GLOBAL_LIBVIPS=0 curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash

Windows: "npm error spawn git / ENOENT"

Installeer Git for Windows, open PowerShell opnieuw en voer het installatieprogramma opnieuw uit.

Windows: "openclaw is not recognized"

Voer npm config get prefix uit en voeg die map toe aan je gebruikers-PATH (geen \bin-achtervoegsel nodig op Windows), en open PowerShell daarna opnieuw.

Windows: uitgebreide uitvoer van het installatieprogramma krijgen

install.ps1 biedt momenteel geen -Verbose-schakeloptie. Gebruik PowerShell-tracing voor diagnostiek op scriptniveau:

Set-PSDebug -Trace 1
& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard
Set-PSDebug -Trace 0

openclaw niet gevonden na installatie

Meestal is dit een PATH-probleem. Zie Node.js-probleemoplossing.

Install overview

Maintenance

Containers

Hosting

Advanced setup

Interne werking van het installatieprogramma

Snelle opdrachten

install.sh

Verloop (install.sh)

Detectie van source-checkout

Voorbeelden (install.sh)

install-cli.sh

Verloop (install-cli.sh)

Voorbeelden (install-cli.sh)

install.ps1

Flow (install.ps1)

Voorbeelden (install.ps1)

CI en automatisering

Probleemoplossing

Gerelateerd

Install overview

Maintenance

Containers

Hosting

Advanced setup

Documentation Index

​Snelle opdrachten

​install.sh

​Verloop (install.sh)

​Detectie van source-checkout

​Voorbeelden (install.sh)

​install-cli.sh

​Verloop (install-cli.sh)

​Voorbeelden (install-cli.sh)

​install.ps1

​Flow (install.ps1)

​Voorbeelden (install.ps1)

​CI en automatisering

​Probleemoplossing

​Gerelateerd

Snelle opdrachten

install.sh

Verloop (install.sh)

Detectie van source-checkout

Voorbeelden (install.sh)

install-cli.sh

Verloop (install-cli.sh)

Voorbeelden (install-cli.sh)

install.ps1

Flow (install.ps1)

Voorbeelden (install.ps1)

CI en automatisering

Probleemoplossing

Gerelateerd