OpenClaw su VM macOS (Sandboxing)

Opzione predefinita consigliata (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 box Linux) se vuoi il controllo totale e un IP residenziale per l’automazione browser. Molti siti bloccano gli IP dei datacenter, quindi la navigazione locale spesso funziona meglio.
• Ibrido: tieni il Gateway su un VPS economico e connetti il tuo Mac come nodo quando ti serve l’automazione browser/UI. Vedi Nodi e Gateway remoto.

Usa una VM macOS quando hai bisogno specificamente di funzionalita esclusive di macOS (iMessage/BlueBubbles) o vuoi un isolamento rigoroso dal tuo Mac di tutti i giorni.

Opzioni per le VM macOS

VM locale sul tuo Apple Silicon Mac (Lume)

Esegui OpenClaw in una VM macOS sandboxed sul tuo Apple Silicon Mac esistente usando Lume.

Ottieni:

• Ambiente macOS completo in isolamento (il tuo host resta pulito)
• Supporto iMessage tramite BlueBubbles (impossibile su Linux/Windows)
• Reset istantaneo clonando le VM
• Nessun hardware aggiuntivo o costo cloud

Provider Mac in hosting (cloud)

Se vuoi macOS nel cloud, i provider Mac in hosting funzionano ugualmente:

• MacStadium (Mac in hosting)
• Anche altri vendor di Mac in hosting funzionano; segui la loro documentazione su VM + SSH

Una volta ottenuto l’accesso SSH a una VM macOS, prosegui dal passaggio 6 qui sotto.

Percorso rapido (Lume, utenti esperti)

1. Installa Lume
2. lume create openclaw --os macos --ipsw latest
3. Completa l’Assistente di Setup, abilita Login Remoto (SSH)
4. lume run openclaw --no-display
5. Entra 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 disco libero 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 e 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.

Nota: il download puo richiedere tempo a seconda della connessione.

3) Completa l’Assistente di Setup

Nella finestra VNC:

1. Seleziona lingua e regione
2. Salta l’Apple ID (oppure accedi se vuoi iMessage in seguito)
3. Crea un account utente (ricorda nome utente e password)
4. Salta tutte le funzionalita opzionali

Al termine del setup, abilita SSH:

1. Apri Impostazioni di Sistema → Generali → Condivisione
2. Abilita “Login Remoto”

4) Ottieni l’indirizzo IP della VM

lume get openclaw

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

5) Connettiti alla VM via SSH

ssh [email protected]

Sostituisci youruser con l’account che hai creato, e l’IP con quello della tua VM.

6) Installa OpenClaw

Dentro la VM:

npm install -g openclaw@latest
openclaw onboard --install-daemon

Segui i prompt dell’onboarding per configurare il tuo provider di modelli (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 in modalita headless

Ferma la VM e riavviala senza display:

lume stop openclaw
lume run openclaw --no-display

La VM gira in background. Il daemon di OpenClaw mantiene il gateway attivo.

Per controllare lo stato:

ssh [email protected] "openclaw status"

Bonus: integrazione iMessage

Questa e la funzionalita killer dell’esecuzione su macOS. Usa BlueBubbles per aggiungere iMessage a OpenClaw.

Dentro la VM:

1. Scarica BlueBubbles da bluebubbles.app
2. Accedi con il tuo Apple ID
3. Abilita la Web API e imposta una password
4. Punta i webhook di BlueBubbles verso il tuo gateway (esempio: https://your-gateway-host:3000/bluebubbles-webhook?password=<password>)

Aggiungi alla configurazione di OpenClaw:

{
  "channels": {
    "bluebubbles": {
      "serverUrl": "http://localhost:1234",
      "password": "your-api-password",
      "webhookPath": "/bluebubbles-webhook"
    }
  }
}

Riavvia il gateway. Ora il tuo agent puo inviare e ricevere iMessage.

Dettagli completi del setup: Canale BlueBubbles

Salva un’immagine golden

Prima di personalizzare ulteriormente, salva uno snapshot del tuo stato pulito:

lume stop openclaw
lume clone openclaw openclaw-golden

Resetta 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 alla corrente
• Disabilitando la sospensione in Impostazioni di Sistema → Risparmio Energia
• Usando caffeinate se necessario

Per un funzionamento veramente continuativo, considera un Mac mini dedicato o un piccolo VPS. Vedi Hosting VPS.

Risoluzione problemi

Documentazione correlata

• Hosting VPS
• Nodi
• Gateway remoto
• Canale BlueBubbles
• Guida rapida Lume
• Riferimento CLI Lume
• Setup VM senza supervisione (avanzato)
• Sandboxing Docker (approccio di isolamento alternativo)