Interne werking van het installatieprogramma

Besturingssysteem detecteren

Ondersteunt macOS en Linux (inclusief WSL).

Standaard Node.js 24 beschikbaar maken

Controleert de Node-versie en installeert indien nodig Node 24 (Homebrew op macOS, NodeSource-installatiescripts op Linux met apt/dnf/yum). Op macOS wordt Homebrew alleen geïnstalleerd wanneer het installatieprogramma dit nodig heeft voor Node of Git. Node 22.22.3+, Node 24.15+ en Node 25.9+ worden ondersteund; Node 23 wordt niet ondersteund. Op Alpine/musl Linux gebruikt het installatieprogramma apk-pakketten in plaats van NodeSource en verifieert het de daadwerkelijk gekoppelde SQLite-versie. De huidige stabiele pakketstromen van Alpine kunnen een voldoende nieuwe Node leveren met een kwetsbare systeemversie van SQLite; gebruik in dat geval een officiële node:24-alpine-container of een op glibc gebaseerde host.

Git beschikbaar maken

Installeert Git als dit ontbreekt met de gedetecteerde pakketbeheerder, waaronder Homebrew op macOS en apk op Alpine.

OpenClaw installeren

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

Taken na de installatie

• Zoekt het zojuist geïnstalleerde binaire bestand openclaw op voor vervolgcommando's
• Start voor een niet-geconfigureerde installatie de onboarding vóór doctor- of Gateway-controles. Met --no-onboard of zonder TTY wordt het commando weergegeven waarmee de configuratie later kan worden voltooid.
• Vernieuwt en herstart voor een geconfigureerde installatie zo goed mogelijk een geladen Gateway-service en voert doctor uit. Bij upgrades worden waar mogelijk plugins bijgewerkt, of wordt het handmatige commando weergegeven bij een headless uitvoering waarbij prompts zijn ingeschakeld.
• Wanneer --verify wordt uitgevoerd, controleert dit de geïnstalleerde versie en alleen de status van de Gateway nadat er een configuratie bestaat.

Lokale Node-runtime installeren

Downloadt een vastgezette, ondersteunde Node LTS-tarball (de versie is in het script opgenomen en wordt onafhankelijk bijgewerkt, standaard 24.15.0) naar <prefix>/tools/node-v<version> en verifieert SHA-256. Linux ARMv7 gebruikt Node 22.22.3, omdat officiële binaire bestanden van Node 24+ voor ARMv7 niet beschikbaar zijn. Op Alpine/musl Linux, waarvoor Node geen compatibele tarballs voor de vastgezette runtime publiceert, worden nodejs en npm geïnstalleerd met apk, waarna zowel Node als de daadwerkelijk gekoppelde SQLite-bibliotheek worden geverifieerd. De huidige stabiele pakketstromen van Alpine kunnen zelfs met een voldoende nieuwe Node nog steeds een kwetsbare SQLite-versie koppelen; gebruik een officiële node:24-alpine-container of een op glibc gebaseerde host wanneer het pakket door de veiligheidscontrole wordt afgewezen.

Git beschikbaar maken

Als Git ontbreekt, wordt geprobeerd dit te installeren via apt/dnf/yum/apk op Linux of Homebrew op macOS.

OpenClaw onder het voorvoegsel installeren

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

Geladen Gateway-service vernieuwen

Als er al een Gateway-service vanuit hetzelfde voorvoegsel is geladen, voert het script openclaw gateway install --force uit, waarmee de vervangende service wordt geactiveerd, en controleert het vervolgens zo goed mogelijk de status van de Gateway.

PowerShell- en Windows-omgeving garanderen

Vereist PowerShell 5+.

Standaard Node.js 24 garanderen

Als deze ontbreekt, wordt eerst installatie via winget geprobeerd, daarna Chocolatey en vervolgens Scoop. Als er geen pakketbeheerder beschikbaar is, downloadt het script het officiële Windows-zipbestand van Node.js 24 naar %LOCALAPPDATA%\OpenClaw\deps\portable-node en voegt het dit toe aan het PATH van het huidige proces en de gebruiker. Node 22.22.3+, Node 24.15+ en Node 25.9+ worden ondersteund; Node 23 wordt niet ondersteund.

OpenClaw installeren

• npm-methode (standaard): globale npm-installatie met de geselecteerde -Tag, gestart vanuit een beschrijfbare tijdelijke installatiemap zodat shells die in beveiligde mappen zoals C:\ zijn geopend, blijven werken
• git-methode: repository klonen/bijwerken, installeren/bouwen met pnpm en wrapper installeren in %USERPROFILE%\.local\bin\openclaw.cmd. Als Git ontbreekt, initialiseert het script gebruikerslokale MinGit onder %LOCALAPPDATA%\OpenClaw\deps\portable-git en voegt het dit toe aan het PATH van het huidige proces en de gebruiker.

Taken na installatie

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

Fouten afhandelen

iwr ... | iex- en scriptblock-installaties melden een beëindigende fout zonder de huidige PowerShell-sessie te sluiten. Directe installaties via powershell -File / pwsh -File worden voor automatisering nog steeds afgesloten met een niet-nulstatus.