Installa

Requisiti di sistema

• Node 22.22.3+, 24.15+ o 25.9+ - Node 24 è la versione di destinazione predefinita; lo script di installazione la gestisce automaticamente.
• macOS, Linux o Windows - Gli utenti Windows possono iniziare con l'app nativa Windows Hub, il programma di installazione della CLI per PowerShell o un Gateway WSL2. Consultare Windows.
• pnpm è necessario solo per la compilazione dal codice sorgente.

Metodo consigliato: script di installazione

È il modo più rapido per eseguire l'installazione. Rileva il sistema operativo, installa Node se necessario, installa OpenClaw e avvia la configurazione iniziale.

curl -fsSL https://openclaw.ai/install.sh | bash

iwr -useb https://openclaw.ai/install.ps1 | iex

Per installare senza eseguire la configurazione iniziale:

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard

& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard

Per tutti i flag e le opzioni di CI/automazione, consultare Dettagli interni del programma di installazione.

Metodi di installazione alternativi

Programma di installazione con prefisso locale (install-cli.sh)

Utilizzare questo metodo per mantenere OpenClaw e Node in un prefisso locale come ~/.openclaw, senza dipendere da un'installazione di Node a livello di sistema:

curl -fsSL https://openclaw.ai/install-cli.sh | bash

Supporta per impostazione predefinita le installazioni npm, oltre alle installazioni da checkout git nello stesso flusso basato sul prefisso. Riferimento completo: Dettagli interni del programma di installazione.

OpenClaw è già installato? È possibile passare dalle installazioni tramite pacchetto a quelle tramite git e viceversa con openclaw update --channel dev e openclaw update --channel stable. Consultare Aggiornamento.

npm, pnpm o bun

Se Node è già gestito autonomamente:

npm install -g openclaw@latestopenclaw onboard --install-daemon

pnpm add -g openclaw@latestpnpm approve-builds -gopenclaw onboard --install-daemon

bun add -g openclaw@latestopenclaw onboard --install-daemon

Dal codice sorgente

Per i collaboratori o per chiunque desideri eseguire OpenClaw da un checkout locale:

git clone https://github.com/openclaw/openclaw.gitcd openclawpnpm install && pnpm build && pnpm ui:buildpnpm link --globalopenclaw onboard --install-daemon

In alternativa, è possibile ignorare il collegamento e utilizzare pnpm openclaw ... dall'interno del repository. Consultare Configurazione per i flussi di sviluppo completi.

Installazione dal checkout main di GitHub

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git --version main

Container e gestori di pacchetti

Verifica dell'installazione

openclaw --version      # conferma che la CLI sia disponibileopenclaw doctor         # verifica la presenza di problemi di configurazioneopenclaw gateway status # verifica che il Gateway sia in esecuzione

Per configurare l'avvio gestito dopo l'installazione:

• macOS: LaunchAgent tramite openclaw onboard --install-daemon o openclaw gateway install
• Linux/WSL2: servizio utente systemd tramite gli stessi comandi
• Windows nativo: prima un'attività pianificata, con un elemento di accesso per utente nella cartella Esecuzione automatica come soluzione di riserva se la creazione dell'attività viene negata

Hosting e distribuzione

È possibile distribuire OpenClaw su un server cloud o VPS. Consultare Server Linux per il selettore completo dei fornitori (DigitalOcean, Hetzner, Hostinger, Fly.io, GCP, Azure, Railway, Northflank, Oracle Cloud, Raspberry Pi e altri) oppure eseguire una distribuzione dichiarativa su Render.

Aggiornamento, migrazione o disinstallazione

Risoluzione dei problemi: openclaw non trovato

Si tratta quasi sempre di un problema relativo a PATH: la directory globale dei file binari di npm non è inclusa in PATH della shell. Consultare Risoluzione dei problemi di Node.js per la soluzione completa, incluso il percorso di Windows.

node -v           # Node è installato?npm prefix -g     # Dove si trovano i pacchetti globali?echo "$PATH"      # La directory globale dei file binari è inclusa in PATH?