Questo articolo fornisce istruzioni dettagliate per distribuire OpenClaw (precedentemente noto come Clawdbot o Moltbot) su una Virtual Machine (VM) di Spaceship. OpenClaw viene distribuito come servizio Gateway a lunga esecuzione sulla VM e amministrato tramite la openclaw CLI e la Control UI
Parleremo dei seguenti argomenti:
Provisioning di una VM
Accesso alla VM
Installazione dei prerequisiti (Node.js 22+)
Installazione di OpenClaw (installer consigliato)
Esecuzione della procedura guidata di onboarding e installazione del servizio Gateway
Accesso remoto sicuro alla Control UI tramite port forwarding SSH
Prima di iniziare a distribuire OpenClaw, assicurati di aver configurato quanto segue:
Un account Spaceship - puoi farlo su spaceship.com
Una Virtual Machine predisposta
Ultime versioni dei sistemi operativi Ubuntu o Debian LTS
Node.js versione 22 o successiva
OAuth o chiavi API come credenziali LLM - assicurati che siano supportate dalla procedura guidata per una configurazione più fluida
Credenziali del canale - dettagli di accesso per canali di messaggistica come Slack, Telegram, Discord ecc.
Se non l’hai ancora fatto, puoi acquistare una VM dal nostro sito web. La configurazione è relativamente rapida e richiede solo pochi passaggi:
Seleziona un piano - per prestazioni affidabili, consigliamo il piano Standard 2 o superiore.
Seleziona un sistema operativo - le ultime versioni di Ubuntu o Debian LTS sono ufficialmente supportate da OpenClaw e consigliate per i loro ambienti stabili e prevedibili.
Imposta una password root complessa
Aggiungi una chiave SSH (facoltativo)
Assegna un nome alla tua VM
Per ulteriori indicazioni, leggi la nostra guida all’acquisto e all’accesso alle VM.
Una volta completati l’acquisto e la configurazione, potrai accedere a VPS Manager, dove potrai gestire e modificare la tua VM, nonché distribuire OpenClaw
Ottieni una prova gratuita di 7 giorni con le VM prepagate di Spaceship.
Ora apri una sessione remota sicura a riga di comando sulla tua VM. Questo ti aiuterà a installare e configurare OpenClaw direttamente sul server. Connettiti tramite SSH sulla porta 22022 usando il client SSH che preferisci (ad esempio Terminal, PuTTY).
Usa il seguente comando per verificare e installare eventuali aggiornamenti software:apt update && apt upgrade -y
OpenClaw richiede Node.js versione 22 o superiore. Tuttavia, Ubuntu/Debian non include Node.js per impostazione predefinita. Dovrai prima aggiungere NodeSource. Ecco una spiegazione passo dopo passo:
Usa il comando seguente per installare gli strumenti necessari a scaricare file da internet in modo sicuro:apt install -y ca-certificates curl
Aggiungi NodeSource all’elenco delle fonti attendibili del tuo sistema:curl -fsSL https://deb.nodesource.com/setup_22.x | bash —
Installa Node.js e npm eseguendo il seguente comando: apt install -y nodejs
Verifica che Node.js e npm siano stati installati correttamente: node -vnpm -v
È importante mantenere le configurazioni, il campo auth e gli spazi di lavoro di OpenClaw separati da root. Puoi farlo aggiungendo OpenClaw come utente dedicato. Questo aiuterà a ridurre l’impatto se OpenClaw ha un bug, è configurato in modo errato o viene ingannato da input dannosi.
Per creare un utente dedicato, usa il seguente comando:
adduser {UserName}
Quindi aggiungi quell’utente al gruppo sudo:
usermod -aG sudo {UserName}
Infine, passa a quell’utente:
su - {UserName}
Ti consigliamo di trattare il tuo workspace OpenClaw come un repository git: mantienilo usa e getta e ripristinabile, così potrai tornare indietro se l’agente apprende un contesto errato o compromesso, ad esempio tramite prompt injection. Ove possibile, evita di memorizzare credenziali altamente sensibili sulla macchina.
Nota: I comandi mostrati in questa guida sono forniti così come sono e corrispondono allo stato del progetto al momento della stesura. A causa dei recenti aggiornamenti dei nomi e dello sviluppo continuo, i nomi dei comandi e le opzioni potrebbero cambiare. Per l’elenco più aggiornato e autorevole dei comandi, fai riferimento alla fonte.
Ora che abbiamo preparato il terreno, è il momento di installare OpenClaw.
La documentazione di OpenClaw consiglia di usare l’installer, a meno che tu non abbia un motivo specifico per non farlo. L’installer installa la CLI globalmente tramite npm ed esegue l’onboarding per impostazione predefinita.
Per eseguire lo script di installazione e installare automaticamente OpenClaw, usa il seguente comando:
curl -fsSL https://openclaw.bot/install.sh | bash
OpenClaw consiglia di usare la procedura guidata di onboarding per la configurazione. Tra le altre cose, configura modello/auth, impostazioni del gateway, canali, impostazioni predefinite di pairing, bootstrap del workspace e un servizio in background (facoltativo).
L’onboarding dovrebbe avviarsi automaticamente dopo l’installazione. Se ciò non accade, o se lo hai saltato, rieseguilo con:
openclaw onboard --install-daemon
Durante l’onboarding, sceglierai:
Gateway locale o remoto - scegli Local per la distribuzione su VM
Metodo di autenticazione - OAuth o chiavi API
Credenziali del canale - accesso tramite QR di WhatsApp, token Telegram/Discord, ecc. Consigliamo di usare un numero usa e getta per WhatsApp per aumentare la sicurezza.
Installazione del daemon/servizio - launchd/systemd a seconda della piattaforma
Node è consigliato e richiesto per un funzionamento affidabile di WhatsApp/Telegram; Bun non è consigliato per il Gateway in questi casi.
Durante l’onboarding, tieni presenti queste best practice di sicurezza:
Concedi a OpenClaw accesso solo alle risorse che ti sentiresti a tuo agio ad affidare a un nuovo collaboratore il primo giorno.
Non concedere a OpenClaw accesso ad account personali di alto valore come email principale, conti bancari o conti di intermediazione.
Usa un indirizzo email dedicato per qualsiasi posta a cui OpenClaw può accedere, invece della tua casella di posta principale.
Le installazioni Linux usano un servizio utente systemd, che per impostazione predefinita si arresta quando un utente esce dalla sessione, interrompendo il gateway. Pertanto, devi abilitare il lingering, che mantiene in esecuzione il servizio in background di OpenClaw quando l’utente non è connesso.
L’onboarding tenta di abilitare il lingering per te e potrebbe richiedere sudo. Tuttavia, se ciò non accade, puoi abilitarlo eseguendo:
sudo loginctl enable-linger “$USER”
Per impostazione predefinita, il Gateway di OpenClaw è configurato per associarsi all’interfaccia loopback ed essere accessibile da remoto tramite un tunnel SSH o tailnet/VPN, anziché esporre una porta pubblica.
In VPS Manager, apri la scheda Virtual Machine e fai clic su Manage per visualizzare i dettagli VPS/rete, incluso l’indirizzo IP.
Evita di esporre la Control UI a internet usando il tunneling SSH per ridurre la superficie di attacco. Dal tuo laptop/workstation (non dalla VM), esegui:
ssh -N -L 18789:127.0.0.1:18789 <username>@<vm-ip> -p 22022
Dove <vm-ip> è l’IP pubblico della tua VM e <username> è l’utente dedicato che hai creato nel passaggio 4.
Per accedere alla Control UI privata di OpenClaw, esegui il seguente comando sulla tua VM:
openclaw dashboard
Questo genererà un URL di accesso (ad esempio http://localhost:18789/?token=1234789) che potrai inserire nel browser per accedere alla Control UI e completare l’onboarding.
Una volta terminato, potrai iniziare a interagire con OpenClaw nel canale di messaggistica.
L’ultimo passaggio consiste nell’assicurarsi che OpenClaw funzioni end-to-end. Per inviare un messaggio di prova, esegui:
openclaw message send --target +15555550123 --message "Hello from OpenClaw"
Se si verificano problemi, esegui openclaw doctor e controlla eventuali avvisi prima di procedere. Prima di abilitare qualsiasi azione distruttiva (ad esempio eliminare o sovrascrivere file, modificare i permessi utente), controlla il comportamento e gli output del bot per assicurarti che si comporti come previsto.