Vai al contenuto principale

​
Installazione

​
Consigliato: script di installazione

Il modo più rapido per installare. Rileva il tuo sistema operativo, installa Node se necessario, installa OpenClaw e avvia l’onboarding. 
curl -fsSL https://openclaw.ai/install.sh | bash
Per installare senza eseguire l’onboarding: 
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
Per tutte le flag e le opzioni CI/automazione, vedi Dettagli interni dell’installer.

​
Requisiti di sistema

  • Node 24 (consigliato) oppure Node 22.14+ — lo script di installazione gestisce tutto automaticamente
  • macOS, Linux o Windows — sono supportati sia Windows nativo sia WSL2; WSL2 è più stabile. Vedi Windows.
  • pnpm è necessario solo se compili dai sorgenti

​
Metodi di installazione alternativi

​
Installer con prefisso locale (install-cli.sh)

Usalo quando vuoi mantenere OpenClaw e Node sotto 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 con prefisso. Riferimento completo: Dettagli interni dell’installer.

​
npm, pnpm o bun

Se gestisci già Node in autonomia: 
npm install -g openclaw@latest
openclaw onboard --install-daemon
Se sharp fallisce a causa di una versione di libvips installata globalmente:
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

​
Dai sorgenti

Per i contributor o per chiunque voglia eseguire da un checkout locale: 
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install && pnpm build && pnpm ui:build
pnpm link --global
openclaw onboard --install-daemon
Oppure salta il link e usa pnpm openclaw ... dall’interno del repo. Vedi Configurazione per i flussi di sviluppo completi.

​
Installa da GitHub main

npm install -g github:openclaw/openclaw#main

​
Container e gestori di pacchetti

Docker

Distribuzioni containerizzate o headless.

Podman

Alternativa ai container rootless a Docker.

Nix

Installazione dichiarativa tramite flake Nix.

Ansible

Provisioning automatizzato su larga scala.

Bun

Uso solo CLI tramite il runtime Bun.

​
Verifica l’installazione

openclaw --version      # conferma che la CLI sia disponibile
openclaw doctor         # controlla eventuali problemi di configurazione
openclaw gateway status # verifica che il Gateway sia in esecuzione
Se vuoi l’avvio gestito dopo l’installazione:
  • macOS: LaunchAgent tramite openclaw onboard --install-daemon oppure openclaw gateway install
  • Linux/WSL2: servizio utente systemd tramite gli stessi comandi
  • Windows nativo: prima Scheduled Task, con fallback a un elemento di accesso nella cartella Startup per utente se la creazione del task viene negata

​
Hosting e distribuzione

Distribuisci OpenClaw su un server cloud o VPS:

VPS

Qualsiasi VPS Linux

Docker VM

Passaggi Docker condivisi

Kubernetes

K8s

Fly.io

Fly.io

Hetzner

Hetzner

GCP

Google Cloud

Azure

Azure

Railway

Railway

Render

Render

Northflank

Northflank

​
Aggiorna, migra o disinstalla

Aggiornamento

Mantieni OpenClaw aggiornato.

Migrazione

Sposta tutto su una nuova macchina.

Disinstallazione

Rimuovi completamente OpenClaw.

​
Risoluzione dei problemi: openclaw non trovato

Se l’installazione è riuscita ma openclaw non viene trovato nel terminale: 
node -v           # Node è installato?
npm prefix -g     # Dove si trovano i pacchetti globali?
echo "$PATH"      # La directory bin globale è in PATH?
Se $(npm prefix -g)/bin non è nel tuo $PATH, aggiungilo al file di avvio della shell (~/.zshrc o ~/.bashrc): 
export PATH="$(npm prefix -g)/bin:$PATH"
Poi apri un nuovo terminale. Vedi Configurazione di Node per maggiori dettagli.