Dettagli interni dell’installer

OpenClaw fornisce tre script di installazione, serviti da openclaw.ai.

Comandi rapidi

install.sh

```bash
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash
```

```bash
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --help
```

install-cli.sh

```bash
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash
```

```bash
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --help
```

install.ps1

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

```powershell
& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -Tag beta -NoOnboard -DryRun
```

Nota: Se l’installazione riesce ma openclaw non viene trovato in un nuovo terminale, vedi Risoluzione problemi Node.js.

install.sh

Suggerimento: Consigliato per la maggior parte delle installazioni interattive su macOS/Linux/WSL.

Flusso (install.sh)

Passo 1: Rileva il sistema operativo

Supporta macOS e Linux (incluso WSL). Se rileva macOS, installa Homebrew se mancante.

Passo 2: Garantisci Node.js 24 di default

Controlla la versione di Node e installa Node 24 se necessario (Homebrew su macOS, script di setup NodeSource su Linux apt/dnf/yum). OpenClaw supporta ancora Node 22 LTS, attualmente `22.16+`, per compatibilita.

Passo 3: Garantisci Git

Installa Git se mancante.

Passo 4: Installa OpenClaw

- Metodo `npm` (default): installazione globale npm
- Metodo `git`: clona/aggiorna il repo, installa le dipendenze con pnpm, compila, poi installa il wrapper in `~/.local/bin/openclaw`

Passo 5: Operazioni post-installazione

- Esegue `openclaw doctor --non-interactive` su aggiornamenti e installazioni git (best effort)
- Tenta l'onboarding quando appropriato (TTY disponibile, onboarding non disabilitato, e i controlli bootstrap/config passano)
- Imposta `SHARP_IGNORE_GLOBAL_LIBVIPS=1` di default

Esempi (install.sh)

Default

```bash
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash
```

Salta l’onboarding

```bash
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --no-onboard
```

Installazione Git

```bash
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git
```

Simulazione

```bash
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --dry-run
```

install-cli.sh

Nota: Progettato per ambienti dove vuoi tutto sotto un prefisso locale (default ~/.openclaw) e nessuna dipendenza Node di sistema.

Flusso (install-cli.sh)

Passo 1: Installa il runtime Node locale

Scarica un tarball Node con versione fissata (attualmente default `22.22.0`) in `<prefix>/tools/node-v<version>` e verifica SHA-256.

Passo 2: Garantisci Git

Se Git e mancante, tenta l'installazione via apt/dnf/yum su Linux o Homebrew su macOS.

Passo 3: Installa OpenClaw sotto il prefisso

Installa con npm usando `--prefix <prefix>`, poi scrive il wrapper in `<prefix>/bin/openclaw`.

Esempi (install-cli.sh)

Default

```bash
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash
```

Prefisso personalizzato + versione

```bash
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --prefix /opt/openclaw --version latest
```

Output JSON per automazione

```bash
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --json --prefix /opt/openclaw
```

install.ps1

Flusso (install.ps1)

Passo 1: Verifica PowerShell + ambiente Windows

Richiede PowerShell 5+.

Passo 2: Garantisci Node.js 24 di default

Se mancante, tenta l'installazione via winget, poi Chocolatey, poi Scoop. Node 22 LTS, attualmente `22.16+`, resta supportato per compatibilita.

Passo 3: Installa OpenClaw

- Metodo `npm` (default): installazione globale npm usando il `-Tag` selezionato
- Metodo `git`: clona/aggiorna il repo, installa/compila con pnpm, e installa il wrapper in `%USERPROFILE%\.local\bin\openclaw.cmd`

Passo 4: Operazioni post-installazione

Aggiunge la directory bin necessaria al PATH utente quando possibile, poi esegue `openclaw doctor --non-interactive` su aggiornamenti e installazioni git (best effort).

Esempi (install.ps1)

Default

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

Installazione Git

```powershell
& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -InstallMethod git
```

Simulazione

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

CI e automazione

Usa flag/variabili d’ambiente non interattive per esecuzioni prevedibili.

install.sh (npm non interattivo)

```bash
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --no-prompt --no-onboard
```

install.sh (git non interattivo)

```bash
OPENCLAW_INSTALL_METHOD=git OPENCLAW_NO_PROMPT=1 \
  curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash
```

install.ps1 (salta onboarding)

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

Risoluzione problemi

Git e richiesto per il metodo di installazione `git`. Per le installazioni `npm`, Git viene comunque controllato/installato per evitare errori `spawn git ENOENT` quando le dipendenze usano URL git.

Alcune configurazioni Linux puntano il prefisso globale npm a percorsi di proprieta di root. `install.sh` puo cambiare il prefisso a `~/.npm-global` e aggiungere esportazioni PATH ai file rc della shell (quando questi file esistono).

Gli script impostano `SHARP_IGNORE_GLOBAL_LIBVIPS=1` di default per evitare che sharp compili contro il libvips di sistema. Per sovrascrivere:

```bash
SHARP_IGNORE_GLOBAL_LIBVIPS=0 curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash
```

Di solito un problema di PATH. Vedi [Risoluzione problemi Node.js](/docs/install/node#troubleshooting).