Come installare OpenClaw

Utilizza l'installer ufficiale e completa la procedura guidata di onboarding per una configurazione più rapida e sicura.

Risposta breve

Confirm system requirements (Node.js 22+, macOS or Linux or Windows via WSL2), run the official install script, then complete openclaw onboard to connect channels and models.

Passaggio 1: Controlla prima i requisiti

OpenClaw dipende dalle moderne funzionalità di Node, quindi è richiesto Node.js 22 o versioni successive. Su Windows, il percorso supportato è WSL2. L'installazione su versioni precedenti di Node è la causa più comune di errori.

Passaggio 2: Utilizza lo script di installazione ufficiale

Il metodo consigliato installa la CLI e prepara il runtime:

curl -fsSL https://openclaw.bot/install.sh | bash
openclaw onboard --install-daemon

Passaggio 3: Completa l'onboarding

La procedura guidata ti accompagna nell'accoppiamento di un canale di messaggistica, nella selezione di un provider di modelli e nell'abilitazione delle skill. Qui imposti le autorizzazioni iniziali e confermi a cosa OpenClaw può accedere.

Comandi utili dopo l'installazione

Use openclaw doctor to validate dependencies, openclaw status or openclaw health to check the gateway, and openclaw update to stay current.

Verifica l'installazione prima dell'uso in produzione

Dopo l'onboarding, esegui un piccolo test che utilizza una skill a basso rischio, come la creazione di un file in una cartella temporanea o la sintesi di un file di testo locale. Questo conferma che il tuo canale, modello e le skill sono correttamente collegati. Se stai distribuendo su un server, verifica che siano aperte solo le porte richieste e che l'accoppiamento amministrativo sia applicato.

Insidie comuni di installazione

Most failures come from an outdated Node version, missing build tools, or running the script under the wrong user account. Another frequent issue is partial installs caused by network errors during package download. If the CLI behaves inconsistently, re-run the install script and check logs with openclaw doctor .

Promemoria di sicurezza

Non esporre gli endpoint amministrativi a Internet pubblico ed evita di installare skill non attendibili. Se esegui OpenClaw su un server, blocca le porte e utilizza l'accesso con privilegi minimi.

Riferimenti ufficiali

For exact instructions, see the official install and wizard pages: Install and Onboard .