OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Hosting

VMs do macOS

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

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) Criar a VM macOS

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

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

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

bash
lume get openclaw

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

5) Acessar a VM via SSH

bash
ssh youruser@192.168.64.X

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

6) Instalar o OpenClaw

Dentro da VM:

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

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:

bash
nano ~/.openclaw/openclaw.json

Adicione seus canais:

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

Em seguida, inicie sessão no WhatsApp (escaneie o código QR):

bash
openclaw channels login

8) Executar a VM sem interface gráfica

Pare a VM e reinicie-a sem exibição:

bash
lume stop openclawlume run openclaw --no-display

A VM é executada 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 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:

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 da configuração: Canal do iMessage.

Salvar uma imagem de referência

Antes de fazer outras personalizações, crie um snapshot do 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

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

Problema Solução
Não é possível acessar a VM por SSH Verifique se "Remote Login" está ativado em System Settings da VM
O IP da VM não aparece Aguarde a inicialização completa da VM e execute lume get openclaw novamente
Comando Lume não encontrado Adicione ~/.local/bin ao seu PATH
O QR do WhatsApp não é escaneado Verifique se você iniciou sessão na VM (e não no sistema hospedeiro) ao executar openclaw channels login

Documentação relacionada

Was this useful?
On this page

On this page