Skip to main content

Padrão recomendado (maioria dos usuários)

  • VPS Linux pequeno para um Gateway sempre ativo e de 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 do navegador. Muitos sites bloqueiam IPs de data centers, portanto a navegação local geralmente funciona melhor.
  • Híbrido: mantenha o Gateway em um VPS barato e conecte seu Mac como um Node quando precisar de automação do navegador/interface. Consulte Nodes e Gateway remoto.
Use uma VM macOS somente quando precisar especificamente de recursos exclusivos do macOS, como iMessage, ou quiser isolamento rigoroso do seu Mac de uso diário.

Opções de VM macOS

VM local no seu Mac com Apple Silicon (Lume)

Execute o OpenClaw em uma VM macOS isolada no seu Mac com Apple Silicon existente usando o Lume. Isso oferece:
  • Ambiente macOS completo e isolado (seu sistema hospedeiro permanece limpo)
  • Suporte ao iMessage via imsg; o caminho local padrão é impossível no Linux/Windows
  • Redefinição instantânea por meio da clonagem de VMs
  • Nenhum custo adicional com hardware ou nuvem

Provedores de Mac hospedado (nuvem)

Se você quiser o 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 deles sobre VM e SSH
Quando tiver acesso SSH a uma VM macOS, prossiga para Instalar o OpenClaw 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 e ative Remote Login (SSH).
  4. lume run openclaw --no-display
  5. Acesse via SSH, instale o OpenClaw e configure os canais.
  6. Pronto.

O que você precisa (Lume)

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

1) Instalar o Lume

Se ~/.local/bin não estiver no seu PATH:
Verifique:
Documentação: Instalação do Lume

2) Criar a VM macOS

Isso baixa o macOS e cria a VM. Uma janela VNC é aberta automaticamente.
O download pode demorar, dependendo da sua conexão.

3) Concluir o Assistente de Configuração

Na janela VNC:
  1. Selecione o idioma e a região.
  2. Ignore o Apple ID (ou inicie sessão se quiser usar o iMessage posteriormente).
  3. Crie uma conta de usuário (lembre-se do nome de usuário e da senha).
  4. Ignore todos os recursos opcionais.
Após concluir a configuração:
  1. Ative o SSH: System Settings -> General -> Sharing e ative “Remote Login”.
  2. Para usar a VM sem interface gráfica, ative o início de sessão automático: System Settings -> Users & Groups, selecione “Automatically log in as:” e escolha o usuário da VM.

4) Obter o endereço IP da VM

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

5) Acessar a VM via SSH

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

6) Instalar o OpenClaw

Dentro da VM:
Siga as instruções de integração para configurar o provedor do seu modelo (Anthropic, OpenAI etc.).

7) Configurar os canais

Edite o arquivo de configuração:
Adicione seus canais:
Em seguida, inicie sessão no WhatsApp (escaneie o código QR):

8) Executar a VM sem interface gráfica

Pare a VM e reinicie-a sem exibição:
A VM é executada em segundo plano; o daemon do OpenClaw mantém o Gateway em execução. Para verificar o status:

Bônus: integração com o iMessage

Este é o principal diferencial de executar no macOS. Use o iMessage com imsg para adicionar o Mensagens ao OpenClaw. Dentro da VM:
  1. Inicie sessão no Mensagens.
  2. Instale o imsg.
  3. Conceda acesso total ao disco e permissão de automação ao processo que executa o OpenClaw/imsg.
  4. Verifique o suporte a RPC com imsg rpc --help.
Adicione à configuração do OpenClaw:
Reinicie o Gateway. Agora seu agente pode enviar e receber iMessages. Detalhes completos da configuração: Canal do iMessage.

Salvar uma imagem de referência

Antes de fazer outras personalizações, crie um snapshot do estado limpo:
Redefina a qualquer momento:

Execução 24 horas por dia, 7 dias por semana

Mantenha a VM em execução:
  • Mantendo seu Mac conectado à energia
  • Desativando o repouso em System Settings -> Energy Saver
  • Usando caffeinate, se necessário
Para uma operação realmente contínua, considere um Mac mini dedicado ou um VPS pequeno. Consulte Hospedagem em VPS.

Solução de problemas

Documentação relacionada