Skip to main content

​
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.
Gli utenti desktop Windows possono anche installare l’app complementare nativa Windows Hub, che include configurazione, stato nell’area di notifica, chat, modalità Node e modalità MCP locale.
Per installare senza eseguire la configurazione iniziale:
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:
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:
Il programma di installazione ospitato elimina i filtri di aggiornamento di npm come min-release-age per l’installazione del pacchetto OpenClaw. Se l’installazione viene eseguita manualmente con npm, continua ad applicarsi la propria politica npm.

​
Dal codice sorgente

Per i collaboratori o per chiunque desideri eseguire OpenClaw da un checkout locale:
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

​
Container e gestori di pacchetti

Docker

Distribuzioni containerizzate o senza interfaccia grafica.

Podman

Alternativa a Docker per container senza privilegi di root.

Nix

Installazione dichiarativa tramite flake Nix.

Ansible

Provisioning automatizzato di un parco macchine.

Bun

Programma facoltativo per installare le dipendenze ed eseguire gli script dei pacchetti.

​
Verifica dell’installazione

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.

VPS

Scegliere un fornitore.

VM Docker

Passaggi condivisi per Docker.

Kubernetes

Distribuzione K8s.

​
Aggiornamento, migrazione o disinstallazione

Aggiornamento

Mantenere OpenClaw aggiornato.

Migrazione

Eseguire il passaggio a un nuovo computer.

Disinstallazione

Rimuovere completamente OpenClaw.

​
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.