Requisiti di sistema OpenClaw

Assicurati che il tuo ambiente soddisfi i requisiti di base prima di installare.

Risposta breve

OpenClaw richiede Node.js 22 o versioni successive e supporta macOS, Linux e Windows tramite WSL2. Per la maggior parte degli utenti, un laptop moderno è sufficiente a meno che non si eseguano modelli locali o automazioni pesanti.

Perché è richiesto Node.js 22+

Il runtime dipende dalle moderne funzionalità di Node e dalle dipendenze aggiornate. L'utilizzo di una versione di Node precedente spesso porta a errori di installazione o a un processo gateway che si blocca sotto carico.

Sistemi operativi supportati

macOS e Linux sono supportati nativamente. Gli utenti Windows dovrebbero eseguire OpenClaw tramite WSL2 per un ambiente stabile simile a Unix. Se si ospita su un server, Linux è l'opzione più prevedibile.

Guida all'hardware per caso d'uso

Se si utilizzano solo modelli cloud, i requisiti di CPU e memoria rimangono modesti. Se si prevede di eseguire modelli locali o più canali contemporaneamente, più RAM e spazio di archiviazione aiutano. Conserva spazio su disco sufficiente per log, cache e dati delle skill.

Minimo vs consigliato

Un laptop moderno con 8 GB di RAM è solitamente sufficiente per modelli cloud e automazione leggera. Per carichi di lavoro più pesanti, 16 GB o più sono una base più sicura. Lo storage SSD è fortemente consigliato per un accesso più rapido a log, cache e download di modelli.

Considerazioni sulla rete

OpenClaw può essere eseguito interamente in locale, ma molti utenti si connettono a API di modelli esterni. Assicurati che l'accesso HTTPS in uscita sia consentito e stabile. Se la tua rete è bloccata, pianifica le impostazioni del proxy e conferma che le porte del gateway non siano esposte pubblicamente.

Permessi utente e modalità daemon

Installa ed esegui OpenClaw sotto un normale account utente, non un account di sistema privilegiato. Se utilizzi la modalità daemon, verifica che il servizio si avvii all'avvio e che la sua directory di lavoro sia leggibile e scrivibile. Permessi errati sono una causa comune di errori silenziosi.

Controlli rapidi dell'ambiente

Check your Node version first, then run openclaw doctor after install. Fixing missing dependencies early saves hours of debugging later.

Riferimento ufficiale

Use the official install requirements as the authoritative source: Install requirements .