Interne werking van het installatieprogramma

Besturingssysteem detecteren

Ondersteunt macOS en Linux (inclusief WSL).

Standaard Node.js 24 garanderen

Controleert de Node-versie en installeert indien nodig Node 24 (Homebrew op macOS, NodeSource-configuratiescripts 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.19+ en 23.11+ blijven voor compatibiliteit ondersteund. Op Alpine/musl Linux gebruikt het installatieprogramma apk-pakketten in plaats van NodeSource; de geconfigureerde Alpine-pakketbronnen moeten een ondersteunde Node-versie aanbieden (op het moment van schrijven Alpine 3.21 of nieuwer).

Git garanderen

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

OpenClaw installeren

• npm-methode (standaard): globale npm-installatie
• git-methode: kloont of werkt de repository bij, installeert afhankelijkheden met pnpm, bouwt het project en installeert vervolgens de wrapper in ~/.local/bin/openclaw

Taken na installatie

• Bepaalt het zojuist geïnstalleerde binaire bestand openclaw voor vervolgopdrachten
• Voor een niet-geconfigureerde installatie wordt de configuratie gestart vóór doctor- of Gateway-controles. Met --no-onboard of zonder TTY wordt de opdracht weergegeven waarmee de configuratie later kan worden voltooid.
• Voor een geconfigureerde installatie wordt een geladen Gateway-service naar beste vermogen vernieuwd en opnieuw gestart en wordt doctor uitgevoerd. Bij upgrades worden Plugins waar mogelijk bijgewerkt, of wordt bij een headless uitvoering met prompts de handmatige opdracht weergegeven.
• Wanneer --verify wordt uitgevoerd, controleert dit de geïnstalleerde versie en alleen als er een configuratie bestaat ook de status van de Gateway.

Lokale Node-runtime installeren

Downloadt een vastgezette, ondersteunde Node LTS-tarball (de versie is in het script opgenomen en wordt onafhankelijk bijgewerkt, standaard 22.22.2) naar <prefix>/tools/node-v<version> en verifieert SHA-256. Op Alpine/musl Linux, waarvoor Node geen compatibele tarballs voor de vastgezette runtime publiceert, worden nodejs en npm met apk geïnstalleerd en wordt die runtime gekoppeld aan het wrapperpad in het voorvoegsel. De Alpine-pakketbronnen moeten een ondersteunde Node-versie aanbieden (22.19+, 23.11+ of 24+); gebruik Alpine 3.21 of nieuwer als oudere pakketbronnen alleen Node 20 of 21 aanbieden.

Git garanderen

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

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 of werkt een checkout bij (standaard ~/openclaw) en schrijft de wrapper eveneens 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 en vervolgens openclaw gateway restart uit, waarna het naar beste vermogen de status van de Gateway controleert.

PowerShell- en Windows-omgeving controleren

Vereist PowerShell 5+.

Standaard Node.js 24 beschikbaar maken

Als dit ontbreekt, wordt installatie geprobeerd via winget, 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.19+ en 23.11+ blijven voor compatibiliteit 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 een wrapper installeren op %USERPROFILE%\.local\bin\openclaw.cmd. Als Git ontbreekt, initialiseert het script een gebruikerslokale MinGit onder %LOCALAPPDATA%\OpenClaw\deps\portable-git en voegt het deze 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 naar beste vermogen een geladen Gateway-service (openclaw gateway install --force, daarna opnieuw starten)
• Voert bij upgrades en git-installaties openclaw doctor --non-interactive uit (naar beste vermogen)

Fouten afhandelen

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