English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisहिन्दीالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiРусскийفارسیไทย
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this pageOpen in PerplexityAsk questions about this page

Hosting

VMs macOS

Padrão recomendado (maioria dos usuários)

  • VPS Linux pequena para um Gateway sempre ativo e baixo custo. Consulte Hospedagem em VPS.
  • Hardware dedicado (Mac mini ou máquina Linux) se você quiser controle total e um IP residencial para automação de navegador. Muitos sites bloqueiam IPs de data centers, então a navegação local costuma funcionar melhor.
  • Híbrido: mantenha o Gateway em uma VPS barata e conecte seu Mac como um node quando precisar de automação de navegador/UI. Consulte Nodes e Gateway remoto.

Use uma VM macOS quando você precisar especificamente de recursos exclusivos do macOS, como iMessage, ou quiser isolamento rigoroso do seu Mac diário.

Opções de VM macOS

VM local no seu Mac Apple Silicon (Lume)

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

Isso oferece:

  • Ambiente macOS completo em isolamento (seu host permanece limpo)
  • Suporte a iMessage via imsg (o caminho local padrão é impossível no Linux/Windows)
  • Redefinição instantânea clonando VMs
  • Nenhum custo extra de hardware ou nuvem

Provedores de Mac hospedado (nuvem)

Se você quiser macOS na nuvem, provedores de Mac hospedado também funcionam:

  • MacStadium (Macs hospedados)
  • Outros fornecedores de Mac hospedado também funcionam; siga a documentação de VM + SSH deles

Depois de ter acesso SSH a uma VM macOS, continue na etapa 6 abaixo.

Caminho rápido (Lume, usuários experientes)

  1. Instale o Lume
  2. lume create openclaw --os macos --ipsw latest
  3. Conclua o Assistente de Configuração, habilite o Login Remoto (SSH)
  4. lume run openclaw --no-display
  5. Acesse via SSH, instale o OpenClaw, configure canais
  6. Pronto

O que você precisa (Lume)

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

1) Instale o Lume

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

Se ~/.local/bin não estiver no seu PATH:

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

Verifique:

bash
lume --version

Documentação: Instalação do Lume

2) Crie a VM macOS

bash
lume create openclaw --os macos --ipsw latest

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

3) Conclua o Assistente de Configuração

Na janela VNC:

  1. Selecione idioma e região
  2. Pule o Apple ID (ou faça login se quiser iMessage depois)
  3. Crie uma conta de usuário (lembre-se do nome de usuário e da senha)
  4. Pule todos os recursos opcionais

Após a configuração ser concluída:

  1. Habilite SSH: abra Ajustes do Sistema -> Geral -> Compartilhamento e habilite "Login Remoto".
  2. Para uso da VM sem interface gráfica, habilite login automático: abra Ajustes do Sistema -> Usuários e Grupos, selecione "Iniciar sessão automaticamente como:" e escolha o usuário da VM.

4) Obtenha o endereço IP da VM

bash
lume get openclaw

Procure o endereço IP (geralmente 192.168.64.x).

5) Acesse a VM via SSH

bash
ssh youruser@192.168.64.X

Substitua youruser pela conta que você criou, e o IP pelo IP da sua VM.

6) Instale o OpenClaw

Dentro da VM:

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

Siga os prompts de onboarding para configurar seu provedor de modelo (Anthropic, OpenAI etc.).

7) Configure canais

Edite o arquivo de configuração:

bash
nano ~/.openclaw/openclaw.json

Adicione seus canais:

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

Depois faça login no WhatsApp (escaneie o QR):

bash
openclaw channels login

8) Execute a VM sem interface gráfica

Pare a VM e reinicie sem display:

bash
lume stop openclawlume run openclaw --no-display

A VM roda em segundo plano. O daemon do OpenClaw mantém o Gateway em execução.

Para verificar o status:

bash
ssh youruser@192.168.64.X "openclaw status"

Bônus: integração com iMessage

Este é o principal diferencial de executar no macOS. Use iMessage com imsg para adicionar Mensagens ao OpenClaw.

Dentro da VM:

  1. Faça login no Mensagens.
  2. Instale imsg.
  3. Conceda permissões de Acesso Total ao Disco e Automação ao processo que executa OpenClaw/imsg.
  4. Verifique o suporte a RPC com imsg rpc --help.

Adicione à sua configuração do OpenClaw:

json5
{  channels: {    imessage: {      enabled: true,      cliPath: "imsg",      dbPath: "~/Library/Messages/chat.db",    },  },}

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

Detalhes completos de configuração: canal iMessage

Salve uma imagem base

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

bash
lume stop openclawlume clone openclaw openclaw-golden

Redefina a qualquer momento:

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

Executando 24/7

Mantenha a VM em execução ao:

  • Manter seu Mac conectado à energia
  • Desabilitar repouso em Ajustes do Sistema → Economizador de Energia
  • Usar caffeinate se necessário

Para operação realmente sempre ativa, considere um Mac mini dedicado ou uma VPS pequena. Consulte Hospedagem em VPS.

Solução de problemas

Problema Solução
Não consigo acessar a VM via SSH Verifique se "Login Remoto" está habilitado nos Ajustes do Sistema da VM
IP da VM não aparece Aguarde a VM inicializar completamente e execute lume get openclaw novamente
Comando Lume não encontrado Adicione ~/.local/bin ao seu PATH
QR do WhatsApp não escaneia Certifique-se de estar logado na VM (não no host) ao executar openclaw channels login

Documentação relacionada

Was this useful?
On this page

On this page