VM macOS

Impostazione predefinita consigliata (per la maggior parte degli utenti)

• Piccolo VPS Linux per un Gateway sempre attivo e a basso costo. Consulta Hosting VPS.
• Hardware dedicato (Mac mini o computer Linux) se desideri il controllo completo 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: mantieni il Gateway su un VPS economico e connetti il tuo Mac come Node quando hai bisogno dell'automazione del browser o dell'interfaccia utente. Consulta Node e Gateway remoto.

Usa una VM macOS solo quando hai specificamente bisogno di funzionalità disponibili esclusivamente su macOS, come iMessage, oppure desideri un isolamento rigoroso dal Mac che utilizzi quotidianamente.

Opzioni per le VM macOS

VM locale sul tuo Mac Apple Silicon (Lume)

Esegui OpenClaw in una VM macOS con sandbox sul tuo Mac Apple Silicon esistente utilizzando Lume. Questa soluzione offre:

• Ambiente macOS completo e isolato (il sistema host rimane pulito)
• Supporto per iMessage tramite imsg; il percorso locale predefinito non è possibile su Linux/Windows
• Ripristino immediato mediante clonazione delle VM
• Nessun costo aggiuntivo per hardware o servizi cloud

Fornitori di Mac in hosting (cloud)

Se desideri macOS nel cloud, puoi utilizzare anche fornitori di Mac in hosting:

• MacStadium (Mac in hosting)
• Sono supportati anche altri fornitori di Mac in hosting; segui la relativa documentazione su VM e SSH

Dopo aver ottenuto l'accesso SSH a una VM macOS, prosegui con Installare OpenClaw più avanti.

Procedura rapida (Lume, utenti esperti)

1. Installa Lume.
2. lume create openclaw --os macos --ipsw latest
3. Completa l'Assistente Configurazione e abilita Remote Login (SSH).
4. lume run openclaw --no-display
5. Accedi tramite SSH, installa OpenClaw e configura i canali.
6. Operazione completata.

Requisiti (Lume)

• Mac Apple Silicon (M1/M2/M3/M4)
• macOS Sequoia o versione successiva sul sistema host
• Circa 60 GB di spazio libero su disco per ogni VM
• Circa 20 minuti

1) Installare Lume

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/trycua/cua/main/libs/lume/scripts/install.sh)"

Se ~/.local/bin non è incluso nel tuo PATH:

echo 'export PATH="$PATH:$HOME/.local/bin"' >> ~/.zshrc && source ~/.zshrc

Verifica:

lume --version

Documentazione: Installazione di Lume

2) Creare la VM macOS

lume create openclaw --os macos --ipsw latest

Questo comando scarica macOS e crea la VM. Si apre automaticamente una finestra VNC.

3) Completare l'Assistente Configurazione

Nella finestra VNC:

1. Seleziona la lingua e l'area geografica.
2. Salta l'Apple ID (oppure accedi se desideri usare iMessage in seguito).
3. Crea un account utente (ricorda il nome utente e la password).
4. Salta tutte le funzionalità facoltative.

Al termine della configurazione:

1. Abilita SSH: System Settings -> General -> Sharing, quindi abilita "Remote Login".
2. Per utilizzare la VM senza interfaccia grafica, abilita l'accesso automatico: System Settings -> Users & Groups, seleziona "Automatically log in as:" e scegli l'utente della VM.

4) Ottenere l'indirizzo IP della VM

lume get openclaw

Individua l'indirizzo IP (solitamente 192.168.64.x).

5) Accedere alla VM tramite SSH

ssh youruser@192.168.64.X

Sostituisci youruser con l'account che hai creato e l'indirizzo IP con quello della VM.

6) Installare OpenClaw

All'interno della VM:

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

Segui le istruzioni della procedura iniziale per configurare il fornitore del modello (Anthropic, OpenAI e così via).

7) Configurare i canali

Modifica il file di configurazione:

nano ~/.openclaw/openclaw.json

Aggiungi i tuoi canali:

{  channels: {    telegram: {      botToken: "YOUR_BOT_TOKEN",    },    whatsapp: {      dmPolicy: "allowlist",      allowFrom: ["+15551234567"],    },  },}

Quindi accedi a WhatsApp (scansiona il codice QR):

openclaw channels login

8) Eseguire la VM senza interfaccia grafica

Arresta la VM e riavviala senza schermo:

lume stop openclawlume run openclaw --no-display

La VM viene eseguita in background; il daemon di OpenClaw mantiene in esecuzione il Gateway. Per controllare lo stato:

ssh youruser@192.168.64.X "openclaw status"

Extra: integrazione con iMessage

Questa è la funzionalità più importante dell'esecuzione su macOS. Usa iMessage con imsg per aggiungere Messaggi a OpenClaw.

All'interno della VM:

1. Accedi a Messaggi.
2. Installa imsg.
3. Concedi l'accesso completo al disco e l'autorizzazione per l'automazione al processo che esegue OpenClaw/imsg.
4. Verifica il supporto RPC con imsg rpc --help.

Aggiungi quanto segue 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. Per i dettagli completi sulla configurazione, consulta Canale iMessage.

Salvare un'immagine master

Prima di procedere con ulteriori personalizzazioni, crea un'istantanea dello stato pulito:

lume stop openclawlume clone openclaw openclaw-golden

Puoi ripristinarlo in qualsiasi momento:

lume stop openclaw && lume delete openclawlume clone openclaw-golden openclawlume run openclaw --no-display

Esecuzione 24 ore su 24, 7 giorni su 7

Mantieni la VM in esecuzione:

• Tenendo il Mac collegato all'alimentazione
• Disabilitando la sospensione in System Settings -> Energy Saver
• Utilizzando caffeinate, se necessario

Per un funzionamento realmente continuo, valuta un Mac mini dedicato o un piccolo VPS. Consulta Hosting VPS.

Risoluzione dei problemi

Documentazione correlata

• Hosting VPS
• Node
• Gateway remoto
• Canale iMessage
• Guida introduttiva di Lume
• Riferimento della CLI di Lume
• Configurazione automatica della VM (avanzata)
• Sandbox con Docker (approccio alternativo all'isolamento)