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.

​
Impostazione predefinita consigliata (per la maggior parte degli utenti)

  • Piccolo VPS Linux per un Gateway sempre attivo e a basso costo. Vedi hosting VPS.
  • Hardware dedicato (Mac mini o macchina Linux) se vuoi il pieno controllo e un IP residenziale per l’automazione del browser. Molti siti bloccano gli IP dei data center, quindi la navigazione locale spesso funziona meglio.
  • Ibrido: tieni il Gateway su un VPS economico e collega il tuo Mac come nodo quando hai bisogno di automazione browser/UI. Vedi Nodi e Gateway remoto.
Usa una VM macOS quando ti servono specificamente funzionalità disponibili solo su macOS, come iMessage, o vuoi un isolamento rigoroso dal tuo Mac quotidiano.

​
Opzioni per VM macOS

​
VM locale sul tuo Mac Apple Silicon (Lume)

Esegui OpenClaw in una VM macOS sandboxed sul tuo Mac Apple Silicon esistente usando Lume. Questo ti offre:
  • Ambiente macOS completo in isolamento (l’host resta pulito)
  • Supporto iMessage tramite imsg (il percorso locale predefinito è impossibile su Linux/Windows)
  • Ripristino istantaneo clonando le VM
  • Nessun costo extra per hardware o cloud

​
Provider Mac ospitati (cloud)

Se vuoi macOS nel cloud, funzionano anche i provider Mac ospitati:
  • MacStadium (Mac ospitati)
  • Funzionano anche altri vendor Mac ospitati; segui la loro documentazione VM + SSH
Dopo avere accesso SSH a una VM macOS, continua dal passaggio 6 qui sotto.

​
Percorso rapido (Lume, utenti esperti)

  1. Installa Lume
  2. lume create openclaw --os macos --ipsw latest
  3. Completa Setup Assistant, abilita Remote Login (SSH)
  4. lume run openclaw --no-display
  5. Accedi via SSH, installa OpenClaw, configura i canali
  6. Fatto

​
Cosa ti serve (Lume)

  • Mac Apple Silicon (M1/M2/M3/M4)
  • macOS Sequoia o successivo sull’host
  • ~60 GB di spazio libero su disco per VM
  • ~20 minuti

​
1) Installa Lume

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/trycua/cua/main/libs/lume/scripts/install.sh)"
Se ~/.local/bin non è nel tuo PATH: 
echo 'export PATH="$PATH:$HOME/.local/bin"' >> ~/.zshrc && source ~/.zshrc
Verifica: 
lume --version
Documentazione: Installazione di Lume

​
2) Crea la VM macOS

lume create openclaw --os macos --ipsw latest
Questo scarica macOS e crea la VM. Una finestra VNC si apre automaticamente.
Il download può richiedere un po’ di tempo a seconda della connessione.

​
3) Completa Setup Assistant

Nella finestra VNC:
  1. Seleziona lingua e regione
  2. Salta Apple ID (oppure accedi se vuoi usare iMessage in seguito)
  3. Crea un account utente (ricorda nome utente e password)
  4. Salta tutte le funzionalità opzionali
Dopo il completamento della configurazione, abilita SSH:
  1. Apri System Settings → General → Sharing
  2. Abilita “Remote Login”

​
4) Ottieni l’indirizzo IP della VM

lume get openclaw
Cerca l’indirizzo IP (di solito 192.168.64.x).

​
5) Accedi alla VM via SSH

ssh youruser@192.168.64.X
Sostituisci youruser con l’account che hai creato e l’IP con l’IP della tua VM.

​
6) Installa OpenClaw

Dentro la VM: 
npm install -g openclaw@latest
openclaw onboard --install-daemon
Segui i prompt di onboarding per configurare il provider del modello (Anthropic, OpenAI, ecc.).

​
7) Configura i canali

Modifica il file di configurazione: 
nano ~/.openclaw/openclaw.json
Aggiungi i tuoi canali: 
{
  channels: {
    whatsapp: {
      dmPolicy: "allowlist",
      allowFrom: ["+15551234567"],
    },
    telegram: {
      botToken: "YOUR_BOT_TOKEN",
    },
  },
}
Poi accedi a WhatsApp (scansiona il QR): 
openclaw channels login

​
8) Esegui la VM senza interfaccia grafica

Arresta la VM e riavviala senza display: 
lume stop openclaw
lume run openclaw --no-display
La VM viene eseguita in background. Il daemon di OpenClaw mantiene il gateway in esecuzione. Per controllare lo stato: 
ssh youruser@192.168.64.X "openclaw status"

​
Bonus: integrazione iMessage

Questa è la funzionalità principale dell’esecuzione su macOS. Usa iMessage con imsg per aggiungere Messaggi a OpenClaw. Dentro la VM:
  1. Accedi a Messaggi.
  2. Installa imsg.
  3. Concedi Full Disk Access e l’autorizzazione Automation al processo che esegue OpenClaw/imsg.
  4. Verifica il supporto RPC con imsg rpc --help.
Aggiungi alla configurazione di OpenClaw: 
{
  channels: {
    imessage: {
      enabled: true,
      cliPath: "imsg",
      dbPath: "~/Library/Messages/chat.db",
    },
  },
}
Riavvia il gateway. Ora il tuo agente può inviare e ricevere iMessage. Dettagli completi di configurazione: canale iMessage

​
Salva un’immagine golden

Prima di procedere con ulteriori personalizzazioni, crea uno snapshot dello stato pulito: 
lume stop openclaw
lume clone openclaw openclaw-golden
Ripristina in qualsiasi momento: 
lume stop openclaw && lume delete openclaw
lume clone openclaw-golden openclaw
lume run openclaw --no-display

​
Esecuzione 24/7

Mantieni la VM in esecuzione:
  • Tenendo il Mac collegato all’alimentazione
  • Disabilitando lo stop in System Settings → Energy Saver
  • Usando caffeinate se necessario
Per un vero always-on, considera un Mac mini dedicato o un piccolo VPS. Vedi hosting VPS.

​
Risoluzione dei problemi

ProblemaSoluzione
Impossibile accedere alla VM via SSHControlla che “Remote Login” sia abilitato in System Settings della VM
L’IP della VM non viene mostratoAttendi che la VM completi l’avvio, poi esegui di nuovo lume get openclaw
Comando Lume non trovatoAggiungi ~/.local/bin al tuo PATH
Il QR di WhatsApp non viene scansionatoAssicurati di aver effettuato l’accesso alla VM (non all’host) quando esegui openclaw channels login

​
Documentazione correlata