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

Install overview

Installazione

Requisiti di sistema

  • Node 24 (consigliato) oppure Node 22.14+ - lo script di installazione gestisce automaticamente questo aspetto
  • 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 OS, installa Node se necessario, installa OpenClaw e avvia l'onboarding.

macOS / Linux / WSL2

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

Windows (PowerShell)

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

Per installare senza eseguire l'onboarding:

macOS / Linux / WSL2

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

Windows (PowerShell)

& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard

Per tutti i flag e le opzioni di 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 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 git checkout 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

npm install -g openclaw@latest
openclaw onboard --install-daemon

pnpm

pnpm add -g openclaw@latest
pnpm approve-builds -g
openclaw onboard --install-daemon

bun

bun add -g openclaw@latest
openclaw onboard --install-daemon
Risoluzione dei problemi: errori di build di sharp (npm)

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

SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

Dal sorgente

Per contributor 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

In alternativa, salta il collegamento e usa pnpm openclaw ... dall'interno del repo. Vedi configurazione per i flussi di sviluppo completi.

Installare da GitHub main

npm install -g github:openclaw/openclaw#main

Container e gestori di pacchetti

Docker

Distribuzioni containerizzate o headless.
Podman

Alternativa rootless a Docker per i container.
Nix

Installazione dichiarativa tramite Nix flake.
Ansible

Provisioning automatizzato del parco macchine.
Bun

Uso solo CLI tramite il runtime Bun.

Verificare 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 Scheduled Task, con fallback a un elemento di accesso nella cartella Startup per utente se la creazione dell'attività viene negata

Hosting e deployment

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

Aggiornare, migrare o disinstallare

Aggiornamento

Mantieni OpenClaw aggiornato.
Migrazione

Sposta su una nuova macchina.
Disinstalla

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.