Componenti interni del programma di installazione

Rilevamento del sistema operativo

Supporta macOS e Linux (incluso WSL).

Installazione predefinita di Node.js 24

Controlla la versione di Node e installa Node 24 se necessario (Homebrew su macOS, script di configurazione NodeSource su Linux con apt/dnf/yum). Su macOS, Homebrew viene installato solo quando il programma di installazione ne ha bisogno per Node o Git. Node 22.19+ e 23.11+ rimangono supportati per compatibilità. Su Alpine/Linux musl, il programma di installazione utilizza i pacchetti apk anziché NodeSource; i repository Alpine configurati devono fornire una versione di Node supportata (Alpine 3.21 o versioni successive al momento della stesura).

Installazione di Git

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

Installazione di OpenClaw

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

Operazioni successive all'installazione

• Individua il binario openclaw appena installato per i comandi successivi
• Per un'installazione non configurata, avvia la configurazione iniziale prima delle verifiche di doctor o del Gateway. Con --no-onboard o senza TTY, stampa il comando per completare la configurazione in seguito.
• Per un'installazione configurata, aggiorna e riavvia, con la massima diligenza possibile, un servizio Gateway caricato ed esegue doctor. Quando possibile, gli aggiornamenti aggiornano i Plugin; in alternativa, durante un'esecuzione senza interfaccia con richieste interattive abilitate, stampano il comando manuale.
• Quando viene eseguito --verify, controlla la versione installata e verifica lo stato del Gateway solo dopo che è stata creata una configurazione.

Installazione del runtime Node locale

Scarica un archivio tar di una versione LTS di Node supportata e fissata (la versione è incorporata nello script e aggiornata in modo indipendente; il valore predefinito è 22.22.2) in <prefix>/tools/node-v<version> e ne verifica l'hash SHA-256. Su Alpine/Linux musl, per cui Node non pubblica archivi tar compatibili con il runtime fissato, installa nodejs e npm tramite apk e collega tale runtime al percorso del wrapper nel prefisso. I repository Alpine devono fornire una versione di Node supportata (22.19+, 23.11+ o 24+); utilizza Alpine 3.21 o versioni successive se i repository meno recenti forniscono solo Node 20 o 21.

Installazione di Git

Se Git è mancante, tenta di installarlo tramite apt/dnf/yum/apk su Linux o Homebrew su macOS.

Installazione di OpenClaw nel prefisso

• Metodo npm (predefinito): esegue l'installazione nel prefisso tramite npm, quindi scrive il wrapper in <prefix>/bin/openclaw
• Metodo git: clona o 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, quindi openclaw gateway restart e verifica lo stato del Gateway con la massima diligenza possibile.

Verificare l'ambiente PowerShell e Windows

Richiede PowerShell 5 o versione successiva.

Garantire 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. Node 22.19+ e 23.11+ rimangono supportati per compatibilità.

Installare OpenClaw

• Metodo npm (predefinito): installazione npm globale con il -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 o aggiorna il repository, installa e compila con pnpm e installa il wrapper in %USERPROFILE%\.local\bin\openclaw.cmd. Se Git non è presente, lo script configura MinGit localmente 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 al PATH dell'utente la directory dei binari necessaria, quando possibile
• Aggiorna, con il massimo impegno possibile, un servizio Gateway caricato (openclaw gateway install --force, quindi lo riavvia)
• Esegue openclaw doctor --non-interactive durante gli aggiornamenti e le installazioni git (con il massimo impegno possibile)

Gestire gli errori

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