Vai al contenuto principale

​
Requisiti di sistema

  • Node 24 (consigliato) o Node 22.19+ - lo script di installazione lo gestisce automaticamente
  • macOS, Linux o Windows - gli utenti Windows possono iniziare con l’app nativa Windows Hub, il programma di installazione CLI PowerShell o un Gateway WSL2. Vedi Windows.
  • pnpm è necessario solo se compili dal sorgente

​
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.
Gli utenti desktop Windows possono anche installare l’app companion nativa Windows Hub, che include configurazione, stato nella tray, chat, modalità node e modalità MCP locale.
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 tutti i flag e le opzioni di CI/automazione, vedi Interni del programma di installazione.

​
Metodi di installazione alternativi

​
Programma di installazione 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 installazioni npm per impostazione predefinita, oltre a installazioni da checkout git nello stesso flusso con prefisso. Riferimento completo: Interni del programma di installazione. Già installato? Passa tra installazioni da pacchetto e da git con openclaw update --channel dev e openclaw update --channel stable. Vedi Aggiornamento.

​
npm, pnpm o bun

Se gestisci già Node autonomamente: 
npm install -g openclaw@latest
openclaw onboard --install-daemon
Il programma di installazione ospitato disattiva i filtri di freschezza npm come min-release-age per l’installazione del pacchetto OpenClaw. Se installi manualmente con npm, si applica comunque la tua policy npm.

​
Dal sorgente

Per i contributori o 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 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

Docker

Distribuzioni containerizzate o headless.

Podman

Alternativa a Docker con container rootless.

Nix

Installazione dichiarativa tramite flake Nix.

Ansible

Provisioning automatizzato di flotte.

Bun

Uso solo CLI tramite il runtime Bun.

​
Verifica l’installazione

openclaw --version      # confirm the CLI is available
openclaw doctor         # check for config issues
openclaw gateway status # verify the Gateway is running
Se vuoi 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 Attività pianificata, con fallback a un elemento di login nella cartella Esecuzione automatica per utente se la creazione dell’attività viene negata

​
Hosting e distribuzione

Distribuisci OpenClaw su un server cloud o VPS:

VPS

Qualsiasi VPS Linux.

Docker VM

Passaggi Docker condivisi.

Kubernetes

Distribuzione K8s.

Fly.io

Distribuisci su Fly.io.

Hetzner

Distribuzione Hetzner.

GCP

Distribuzione Google Cloud.

Azure

Distribuzione Azure.

Railway

Distribuzione Railway.

Render

Distribuzione Render.

Northflank

Distribuzione Northflank.

​
Aggiorna, migra o disinstalla

Updating

Mantieni OpenClaw aggiornato.

Migrating

Sposta su una nuova macchina.

Uninstall

Rimuovi completamente OpenClaw.

​
Risoluzione dei problemi: openclaw non trovato

Se l’installazione è riuscita ma openclaw non viene trovato nel tuo terminale: 
node -v           # Node installed?
npm prefix -g     # Where are global packages?
echo "$PATH"      # Is the global bin dir in PATH?
Se $(npm prefix -g)/bin non è nel tuo $PATH, aggiungilo al file di avvio della tua shell (~/.zshrc o ~/.bashrc): 
export PATH="$(npm prefix -g)/bin:$PATH"
Poi apri un nuovo terminale. Vedi Configurazione di Node per maggiori dettagli.