English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

Install overview

Installazione

Edit source

Requisiti di sistema

  • Node 24 (consigliato) o Node 22.16+ - lo script di installazione lo gestisce automaticamente
  • macOS, Linux o Windows - sono supportati sia Windows nativo sia WSL2; WSL2 è più stabile. 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.

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 l'onboarding:

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 CI/automazione, vedi Dettagli interni dell'installer.

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 Node a livello di sistema:

bash
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: Dettagli interni dell'installer.

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

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
Risoluzione dei problemi: errori di build di sharp (npm)

Se sharp non riesce a causa di una libvips installata globalmente:

bash
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

Dal sorgente

Per i collaboratori o chiunque voglia eseguire 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

Oppure salta il link e usa pnpm openclaw ... dall'interno del repository. Vedi Configurazione per i flussi di sviluppo completi.

Installa da GitHub main

bash
npm install -g github:openclaw/openclaw#main

Container e package manager

Docker

Distribuzioni containerizzate o headless.
Podman

Alternativa container rootless a Docker.
Nix

Installazione dichiarativa tramite Nix flake.
Ansible

Provisioning automatizzato di flotte.
Bun

Uso solo CLI tramite il runtime Bun.

Verifica l'installazione

bash
openclaw --version      # confirm the CLI is availableopenclaw doctor         # check for config issuesopenclaw 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 Scheduled Task, con fallback a un elemento di login nella cartella Startup per utente se la creazione dell'attività viene negata

Hosting e distribuzione

Distribuisci OpenClaw su un server cloud o VPS:

VPS
Docker VM
Kubernetes

OPENCLAW_DOCS_MARKER:cardOpen:IHRpdGxlPSJGbHkuaW8iIGhyZWY9Ii9pdC9pbnN0YWxsL2ZseSI Fly.io OPENCLAW_DOCS_MARKER:cardClose:

Hetzner
GCP
Azure
Railway
Render
Northflank

Aggiorna, migra o disinstalla

Aggiornamento

Mantieni OpenClaw aggiornato.
Migrazione

Sposta su una nuova macchina.
Disinstalla

Rimuovi OpenClaw completamente.

Risoluzione dei problemi: openclaw non trovato

Se l'installazione è riuscita ma openclaw non viene trovato nel terminale:

bash
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 shell (~/.zshrc o ~/.bashrc):

bash
export PATH="$(npm prefix -g)/bin:$PATH"

Poi apri un nuovo terminale. Vedi Configurazione di Node per maggiori dettagli.

Was this useful?