Interni dell'installer

Rileva il sistema operativo

Supporta macOS e Linux (incluso WSL).

Garantisce Node.js 24 per impostazione predefinita

Controlla la versione di Node e installa Node 24 se necessario (Homebrew su macOS, script di configurazione NodeSource su Linux apt/dnf/yum). Su macOS, Homebrew viene installato solo quando il programma di installazione ne ha bisogno per Node o Git. OpenClaw supporta ancora Node 22 LTS, attualmente 22.19+, per compatibilità. Su Alpine/musl Linux, il programma di installazione usa i pacchetti apk invece di NodeSource; i repository Alpine configurati devono fornire Node 22.19+ (Alpine 3.21 o successiva al momento della stesura).

Garantisce Git

Installa Git se manca usando il gestore di pacchetti rilevato, inclusi Homebrew su macOS e apk su Alpine.

Installa OpenClaw

• metodo npm (predefinito): installazione npm globale
• metodo git: clona/aggiorna il repository, installa le dipendenze con pnpm, compila, quindi installa il wrapper in ~/.local/bin/openclaw

Attività post-installazione

• Aggiorna al meglio un servizio Gateway caricato (openclaw gateway install --force, quindi riavvio)
• Esegue openclaw doctor --non-interactive durante aggiornamenti e installazioni git (al meglio)
• Tenta l'onboarding quando appropriato (TTY disponibile, onboarding non disabilitato e controlli bootstrap/config superati)

Installa il runtime Node locale

Scarica un tarball Node LTS supportato e fissato (la versione è incorporata nello script e aggiornata indipendentemente) in <prefix>/tools/node-v<version> e verifica SHA-256. Su Alpine/musl Linux, dove Node non pubblica tarball compatibili per il runtime fissato, installa nodejs e npm con apk e collega quel runtime nel percorso del wrapper del prefisso. I repository Alpine devono fornire Node 22.19+; usa Alpine 3.21 o successiva se repository più vecchi forniscono solo Node 20 o 21.

Garantisce Git

Se Git manca, tenta l'installazione tramite apt/dnf/yum/apk su Linux o Homebrew su macOS.

Installa OpenClaw sotto il prefisso

• metodo npm (predefinito): installa sotto il prefisso con npm, quindi scrive il wrapper in <prefix>/bin/openclaw
• metodo git: clona/aggiorna un checkout (predefinito ~/openclaw) e scrive comunque il wrapper in <prefix>/bin/openclaw

Aggiorna il servizio Gateway caricato

Se un servizio Gateway è già caricato dallo stesso prefisso, lo script esegue openclaw gateway install --force, quindi openclaw gateway restart, e controlla al meglio l'integrità del Gateway.

Ensure PowerShell + Windows environment

Richiede PowerShell 5+.

Ensure Node.js 24 by default

Se manca, tenta l'installazione tramite winget, poi Chocolatey, poi Scoop. Se non è disponibile alcun gestore di pacchetti, lo script scarica lo zip ufficiale di Node.js per Windows in %LOCALAPPDATA%\OpenClaw\deps\portable-node e lo aggiunge al PATH del processo corrente e dell'utente. Node 22 LTS, attualmente 22.19+, rimane supportato per compatibilità.

Install OpenClaw

• Metodo npm (predefinito): installazione npm globale usando il -Tag selezionato, avviata da una directory temporanea del programma di installazione scrivibile, così le shell aperte in cartelle protette come C:\ funzionano comunque
• Metodo git: clona/aggiorna il repo, installa/compila con pnpm e installa il wrapper in %USERPROFILE%\.local\bin\openclaw.cmd. Se Git manca, lo script esegue il bootstrap di MinGit locale per l'utente in %LOCALAPPDATA%\OpenClaw\deps\portable-git e lo aggiunge al PATH del processo corrente e dell'utente.

Post-install tasks

• Aggiunge la directory bin necessaria al PATH dell'utente quando possibile
• Aggiorna al meglio un servizio gateway caricato (openclaw gateway install --force, poi riavvio)
• Esegue openclaw doctor --non-interactive sugli aggiornamenti e sulle installazioni git (al meglio)

Handle failures

iwr ... | iex e le installazioni tramite scriptblock segnalano un errore terminante senza chiudere la sessione PowerShell corrente. Le installazioni dirette powershell -File / pwsh -File continuano a uscire con codice diverso da zero per l'automazione.