OpenClaw em VMs macOS (Sandboxing)

Padrao recomendado (maioria dos usuarios)

• VPS Linux pequeno para um Gateway sempre ativo e baixo custo. Consulte Hospedagem VPS.
• Hardware dedicado (Mac mini ou maquina Linux) se voce quer controle total e um IP residencial para automacao de navegador. Muitos sites bloqueiam IPs de data center, entao navegacao local frequentemente funciona melhor.
• Hibrido: mantenha o Gateway em um VPS barato e conecte seu Mac como node quando precisar de automacao de navegador/UI. Consulte Nodes e Gateway remoto.

Use uma VM macOS quando precisar especificamente de recursos exclusivos do macOS (iMessage/BlueBubbles) ou quiser isolamento estrito do seu Mac do dia a dia.

Opcoes de VM macOS

VM local no seu Mac Apple Silicon (Lume)

Execute o OpenClaw em uma VM macOS sandboxed no seu Mac Apple Silicon existente usando Lume.

Isso oferece:

• Ambiente macOS completo em isolamento (seu host permanece limpo)
• Suporte a iMessage via BlueBubbles (impossivel no Linux/Windows)
• Reset instantaneo por clonagem de VMs
• Sem hardware extra ou custos de cloud

Provedores Mac hospedados (cloud)

Se voce quer macOS na nuvem, provedores Mac hospedados tambem funcionam:

• MacStadium (Macs hospedados)
• Outros fornecedores de Mac hospedado tambem funcionam; siga a documentacao de VM + SSH deles

Quando tiver acesso SSH a uma VM macOS, continue no passo 6 abaixo.

Caminho rapido (Lume, usuarios experientes)

1. Instalar Lume
2. lume create openclaw --os macos --ipsw latest
3. Completar o Assistente de Configuracao, habilitar Login Remoto (SSH)
4. lume run openclaw --no-display
5. SSH, instalar OpenClaw, configurar canais
6. Pronto

O que voce precisa (Lume)

• Mac Apple Silicon (M1/M2/M3/M4)
• macOS Sequoia ou posterior no host
• ~60 GB de espaco em disco livre por VM
• ~20 minutos

1) Instalar Lume

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

Se ~/.local/bin nao esta no seu PATH:

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

Verifique:

lume --version

Docs: Instalacao do Lume

2) Criar a VM macOS

lume create openclaw --os macos --ipsw latest

Isso baixa o macOS e cria a VM. Uma janela VNC abre automaticamente.

Observacao: O download pode demorar dependendo da sua conexao.

3) Completar o Assistente de Configuracao

Na janela VNC:

1. Selecione idioma e regiao
2. Pule o Apple ID (ou faca login se quiser iMessage depois)
3. Crie uma conta de usuario (lembre do nome de usuario e senha)
4. Pule todos os recursos opcionais

Apos a configuracao, habilite SSH:

1. Abra Ajustes do Sistema → Geral → Compartilhamento
2. Habilite “Login Remoto”

4) Obter o endereco IP da VM

lume get openclaw

Procure o endereco IP (geralmente 192.168.64.x).

5) SSH na VM

ssh [email protected]

Substitua youruser pela conta que voce criou e o IP pelo IP da sua VM.

6) Instalar o OpenClaw

Dentro da VM:

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

Siga as instrucoes de onboarding para configurar seu provedor de modelos (Anthropic, OpenAI, etc.).

7) Configurar canais

Edite o arquivo de configuracao:

nano ~/.openclaw/openclaw.json

Adicione seus canais:

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

Depois faca login no WhatsApp (scan QR):

openclaw channels login

8) Executar a VM em modo headless

Pare a VM e reinicie sem display:

lume stop openclaw
lume run openclaw --no-display

A VM roda em segundo plano. O daemon do OpenClaw mantem o gateway funcionando.

Para verificar o status:

ssh [email protected] "openclaw status"

Bonus: integracao iMessage

Este e o recurso matador de rodar no macOS. Use BlueBubbles para adicionar iMessage ao OpenClaw.

Dentro da VM:

1. Baixe BlueBubbles de bluebubbles.app
2. Faca login com seu Apple ID
3. Habilite a Web API e defina uma senha
4. Aponte os webhooks do BlueBubbles para seu gateway (exemplo: https://your-gateway-host:3000/bluebubbles-webhook?password=<password>)

Adicione a sua configuracao OpenClaw:

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

Reinicie o gateway. Agora seu agente pode enviar e receber iMessages.

Detalhes completos: Canal BlueBubbles

Salvar uma imagem golden

Antes de personalizar mais, faca um snapshot do seu estado limpo:

lume stop openclaw
lume clone openclaw openclaw-golden

Reset a qualquer momento:

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

Rodando 24/7

Mantenha a VM rodando:

• Mantendo seu Mac conectado a energia
• Desabilitando o modo sleep em Ajustes do Sistema → Economizador de Energia
• Usando caffeinate se necessario

Para funcionamento verdadeiramente continuo, considere um Mac mini dedicado ou um VPS pequeno. Consulte Hospedagem VPS.

Solucao de problemas

Documentacao relacionada

• Hospedagem VPS
• Nodes
• Gateway remoto
• Canal BlueBubbles
• Quickstart Lume
• Referencia CLI Lume
• Configuracao de VM Unattended (avancado)
• Sandboxing Docker (abordagem alternativa de isolamento)