Installa

Requisiti di sistema

• Node 22.19+, 23.11+ o 24+ - Node 24 è la versione di destinazione predefinita; lo script di installazione se ne occupa 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. Consulta Windows.
• pnpm è necessario solo se compili 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, consulta Dettagli interni del programma di installazione.

Metodi di installazione alternativi

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

Usa questo metodo quando vuoi 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

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

Hai già eseguito l'installazione? Passa dalle installazioni tramite pacchetto a quelle tramite git e viceversa con openclaw update --channel dev e openclaw update --channel stable. Consulta Aggiornamento.

npm, pnpm o bun

Se gestisci già autonomamente Node:

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, salta il collegamento e usa pnpm openclaw ... dall'interno del repository. Consulta Configurazione per i flussi di lavoro 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      # verifica che la CLI sia disponibileopenclaw doctor         # controlla eventuali problemi di configurazioneopenclaw gateway status # verifica che il Gateway sia in esecuzione

Se desideri un 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 nella cartella Esecuzione automatica per singolo utente come soluzione alternativa se la creazione dell'attività viene negata

Hosting e distribuzione

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

Aggiornamento, migrazione o disinstallazione

Risoluzione dei problemi: openclaw non trovato

Quasi sempre si tratta di un problema relativo a PATH: la directory globale dei binari di npm non è inclusa nel PATH della shell. Consulta Risoluzione dei problemi di Node.js per la soluzione completa, incluso il percorso per Windows.

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