Vai al contenuto principale

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
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. 
curl -fsSL https://openclaw.ai/install.sh | bash
Per installare senza eseguire l’onboarding: 
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
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: 
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 install -g openclaw@latest
openclaw onboard --install-daemon
Se sharp non riesce a causa di una libvips installata globalmente:
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

​
Dal sorgente

Per i collaboratori 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
Oppure salta il link e usa pnpm openclaw ... dall’interno del repository. Vedi Configurazione per i flussi di sviluppo completi.

​
Installa da GitHub main

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

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

Qualsiasi VPS Linux

Docker VM

Passaggi Docker condivisi

Kubernetes

K8s

Fly.io

Fly.io

Hetzner

Hetzner

GCP

Google Cloud

Azure

Azure

Railway

Railway

Render

Render

Northflank

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: 
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): 
export PATH="$(npm prefix -g)/bin:$PATH"
Poi apri un nuovo terminale. Vedi Configurazione di Node per maggiori dettagli.