Installazione

Hai gia seguito Primi Passi? Sei a posto — questa pagina copre i metodi di installazione alternativi, le istruzioni specifiche per piattaforma e la manutenzione.

Requisiti di sistema

Node 24 (raccomandato) (Node 22 LTS, attualmente 22.16+, e ancora supportato per compatibilita; lo script di installazione installera Node 24 se assente)
macOS, Linux o Windows
pnpm solo se compili da sorgente

Nota: Su Windows, raccomandiamo fortemente di eseguire OpenClaw sotto WSL2.

Metodi di installazione

Suggerimento: Lo script di installazione e il modo raccomandato per installare OpenClaw. Gestisce il rilevamento di Node, l’installazione e l’onboarding in un unico passaggio.

Attenzione: Per VPS/host cloud, evita se possibile le immagini marketplace di terze parti “1-click”. Preferisci un’immagine SO base pulita (ad esempio Ubuntu LTS), poi installa OpenClaw tu stesso con lo script di installazione.

Script di installazione

Scarica il CLI, lo installa globalmente via npm e lancia la procedura guidata di onboarding.

  #### macOS / Linux / WSL2
    ```bash
    curl -fsSL https://openclaw.ai/install.sh | bash
    ```

  #### Windows (PowerShell)
    ```powershell
    iwr -useb https://openclaw.ai/install.ps1 | iex
    ```

Fatto — lo script gestisce il rilevamento di Node, l'installazione e l'onboarding.

Per saltare l'onboarding e installare solo il binario:

  #### 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, variabili d'ambiente e opzioni CI/automazione, consulta [Dettagli dell'installer](/docs/install/installer).

npm / pnpm

Se gestisci gia Node da solo, raccomandiamo Node 24. OpenClaw supporta ancora Node 22 LTS, attualmente `22.16+`, per compatibilita:

  #### npm
    ```bash
    npm install -g openclaw@latest
    openclaw onboard --install-daemon
    ```

    <details>

Errori di build di sharp?

      Se hai libvips installato globalmente (comune su macOS via Homebrew) e `sharp` fallisce, forza i binari precompilati:

      ```bash
      SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest
      ```
    </details>

  #### pnpm
    ```bash
    pnpm add -g openclaw@latest
    pnpm approve-builds -g        # approva openclaw, node-llama-cpp, sharp, ecc.
    openclaw onboard --install-daemon
    ```

    > **Nota:** pnpm richiede approvazione esplicita per i pacchetti con script di build. Dopo la prima installazione che mostra l'avviso "Ignored build scripts", esegui `pnpm approve-builds -g` e seleziona i pacchetti elencati.

Da sorgente

Per i contributori o chiunque voglia eseguire da un checkout locale.

  ### Passo 1: Clona e compila
    Clona il [repo OpenClaw](https://github.com/openclaw/openclaw) e compila:

    ```bash
    git clone https://github.com/openclaw/openclaw.git
    cd openclaw
    pnpm install
    pnpm ui:build
    pnpm build
    ```

  ### Passo 2: Collega il CLI
    Rendi il comando `openclaw` disponibile globalmente:

    ```bash
    pnpm link --global
    ```

    In alternativa, salta il collegamento ed esegui i comandi via `pnpm openclaw ...` dal repo.

  ### Passo 3: Esegui l'onboarding
    ```bash
    openclaw onboard --install-daemon
    ```

Per workflow di sviluppo piu avanzati, consulta [Setup](/docs/start/setup).

Altri metodi di installazione

Docker — Deploy containerizzati o headless.
Podman — Container rootless: esegui setup-podman.sh una volta, poi lo script di avvio.
Nix — Installazione dichiarativa via Nix.
Ansible — Provisioning automatizzato di flotte.
Bun — Uso solo CLI via il runtime Bun.

Dopo l’installazione

Verifica che tutto funzioni:

openclaw doctor         # controlla problemi di configurazione
openclaw status         # stato del gateway
openclaw dashboard      # apri l'interfaccia web

Se hai bisogno di percorsi di esecuzione personalizzati, usa:

OPENCLAW_HOME per i percorsi interni basati sulla home directory
OPENCLAW_STATE_DIR per la posizione dello stato mutabile
OPENCLAW_CONFIG_PATH per la posizione del file di configurazione

Consulta Variabili d’ambiente per la precedenza e tutti i dettagli.

Risoluzione problemi: `openclaw` non trovato

Diagnosi e correzione del PATH

Diagnosi rapida:

node -v
npm -v
npm prefix -g
echo "$PATH"

Se $(npm prefix -g)/bin (macOS/Linux) o $(npm prefix -g) (Windows) non e nel tuo $PATH, la tua shell non riesce a trovare i binari npm globali (incluso openclaw).

Correzione — aggiungi al tuo file di avvio della shell (~/.zshrc o ~/.bashrc):

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

Su Windows, aggiungi l’output di npm prefix -g al tuo PATH.

Poi apri un nuovo terminale (o rehash in zsh / hash -r in bash).

Aggiornamento / disinstallazione

Aggiornamento — Mantieni OpenClaw aggiornato.
Migrazione — Trasferisciti su una nuova macchina.
Disinstallazione — Rimuovi OpenClaw completamente.