Meccanismi interni del programma di installazione

Rilevamento del sistema operativo

Supporta macOS e Linux (incluso WSL).

Verifica di 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. Sono supportati Node 22.22.3+, Node 24.15+ e Node 25.9+; Node 23 non è supportato. Su Alpine/musl Linux, il programma di installazione usa i pacchetti apk anziché NodeSource e verifica l'effettiva versione collegata di SQLite. Gli attuali flussi di pacchetti stabili di Alpine possono fornire una versione di Node sufficientemente recente con una SQLite di sistema vulnerabile; in tal caso, utilizzare un container node:24-alpine ufficiale o un host basato su glibc.

Verifica di Git

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

Installazione di OpenClaw

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

Attività successive all'installazione

• Individua il binario openclaw appena installato per i comandi successivi
• Per un'installazione non configurata, avvia la configurazione iniziale prima dei controlli di doctor o del Gateway. Con --no-onboard o senza TTY, visualizza il comando per completare la configurazione in seguito.
• Per un'installazione configurata, aggiorna e riavvia, per quanto possibile, un servizio Gateway caricato ed esegue doctor. Gli aggiornamenti aggiornano i Plugin quando possibile oppure visualizzano il comando manuale in un'esecuzione headless con prompt abilitati.
• Quando viene eseguito --verify, controlla la versione installata e verifica l'integrità del Gateway solo dopo che la configurazione è presente.

Installazione del runtime Node locale

Scarica un archivio tar di una versione Node LTS supportata e bloccata (la versione è incorporata nello script e aggiornata indipendentemente, predefinita 24.15.0) in <prefix>/tools/node-v<version> e ne verifica il valore SHA-256. Linux ARMv7 usa Node 22.22.3 perché i binari ufficiali di Node 24+ per ARMv7 non sono disponibili. Su Alpine/musl Linux, dove Node non pubblica archivi tar compatibili con il runtime bloccato, installa nodejs e npm con apk, quindi verifica sia Node sia l'effettiva libreria SQLite collegata. Gli attuali flussi di pacchetti stabili di Alpine possono comunque collegare una SQLite vulnerabile anche con una versione di Node sufficientemente recente; quando il controllo di sicurezza rifiuta il pacchetto, usare un container node:24-alpine ufficiale o un host basato su glibc.

Verifica di Git

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

Installazione di OpenClaw nel prefisso

• Metodo npm (predefinito): esegue l'installazione nel 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

Aggiornamento del servizio Gateway caricato

Se un servizio Gateway è già caricato dallo stesso prefisso, lo script esegue openclaw gateway install --force, che attiva il servizio sostitutivo, quindi verifica, per quanto possibile, l'integrità del Gateway.

Verifica dell'ambiente PowerShell + Windows

Richiede PowerShell 5+.

Verifica di Node.js 24 per impostazione predefinita

Se non è presente, tenta l'installazione tramite winget, quindi Chocolatey e infine Scoop. Se non è disponibile alcun gestore di pacchetti, lo script scarica il file zip ufficiale di Node.js 24 per Windows in %LOCALAPPDATA%\OpenClaw\deps\portable-node e lo aggiunge al PATH del processo corrente e dell'utente. Sono supportati Node 22.22.3+, Node 24.15+ e Node 25.9+; Node 23 non è supportato.

Installazione di OpenClaw

• Metodo npm (predefinito): installazione npm globale mediante il valore -Tag selezionato, avviata da una directory temporanea scrivibile del programma di installazione, in modo che funzionino anche le shell aperte in cartelle protette come C:\
• Metodo git: clona/aggiorna il repository, esegue l'installazione/la compilazione con pnpm e installa il wrapper in %USERPROFILE%\.local\bin\openclaw.cmd. Se Git non è presente, lo script configura MinGit locale per l'utente in %LOCALAPPDATA%\OpenClaw\deps\portable-git e lo aggiunge al PATH del processo corrente e dell'utente.

Attività successive all'installazione

• Aggiunge la directory bin necessaria al PATH dell'utente quando possibile
• Aggiorna, per quanto possibile, un servizio Gateway caricato (openclaw gateway install --force, quindi riavvio)
• Esegue openclaw doctor --non-interactive durante gli aggiornamenti e le installazioni git (per quanto possibile)

Gestione degli errori

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