OpenClawDocs
In questa pagina

In questa pagina

View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Install overview

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.

macOS / Linux / WSL2

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

Windows (PowerShell)

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

Per installare senza eseguire la configurazione iniziale:

macOS / Linux / WSL2

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

Windows (PowerShell)

powershell
& ([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:

bash
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

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

pnpm

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

bun

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

Dal codice sorgente

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

bash
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

bash
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 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

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

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.

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