Pular para o conteúdo principal

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Padrão recomendado (maioria dos usuários)

  • VPS Linux pequena para um Gateway sempre ativo e baixo custo. Consulte hospedagem VPS.
  • Hardware dedicado (Mac mini ou máquina Linux) se você quer 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
  • Sem hardware extra ou custos de nuvem

​
Provedores de Mac hospedado (nuvem)

Se você quer 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 os canais
  6. Concluído

​
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

/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: 
echo 'export PATH="$PATH:$HOME/.local/bin"' >> ~/.zshrc && source ~/.zshrc
Verifique: 
lume --version
Documentação: Instalação do Lume

​
2) Crie a VM macOS

lume create openclaw --os macos --ipsw latest
Isso baixa o macOS e cria a VM. Uma janela VNC é aberta automaticamente.
O download pode levar algum tempo, dependendo da sua conexão.

​
3) Conclua o Assistente de Configuração

Na janela VNC:
  1. Selecione idioma e região
  2. Pule o Apple ID (ou entre se quiser usar 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
Depois que a configuração for concluída, habilite SSH:
  1. Abra Ajustes do Sistema → Geral → Compartilhamento
  2. Habilite “Login Remoto”

​
4) Obtenha o endereço IP da VM

lume get openclaw
Procure o endereço IP (geralmente 192.168.64.x).

​
5) Acesse a VM via SSH

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: 
npm install -g openclaw@latest
openclaw onboard --install-daemon
Siga os prompts de integração para configurar seu provedor de modelo (Anthropic, OpenAI etc.).

​
7) Configure canais

Edite o arquivo de configuração: 
nano ~/.openclaw/openclaw.json
Adicione seus canais: 
{
  channels: {
    whatsapp: {
      dmPolicy: "allowlist",
      allowFrom: ["+15551234567"],
    },
    telegram: {
      botToken: "YOUR_BOT_TOKEN",
    },
  },
}
Depois faça login no WhatsApp (escaneie o QR): 
openclaw channels login

​
8) Execute a VM sem interface gráfica

Pare a VM e reinicie sem tela: 
lume stop openclaw
lume 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: 
ssh youruser@192.168.64.X "openclaw status"

​
Bônus: integração com iMessage

Este é o recurso matador de executar no macOS. Use iMessage com imsg para adicionar o Mensagens ao OpenClaw. Dentro da VM:
  1. Entre no Mensagens.
  2. Instale imsg.
  3. Conceda Acesso Total ao Disco e permissão de Automação para o processo que executa OpenClaw/imsg.
  4. Verifique o suporte a RPC com imsg rpc --help.
Adicione à sua configuração do OpenClaw: 
{
  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 dourada

Antes de personalizar mais, faça um snapshot do seu estado limpo: 
lume stop openclaw
lume clone openclaw openclaw-golden
Redefina a qualquer momento: 
lume stop openclaw && lume delete openclaw
lume clone openclaw-golden openclaw
lume run openclaw --no-display

​
Execução 24/7

Mantenha a VM em execução:
  • Mantendo seu Mac conectado à tomada
  • Desabilitando o repouso em Ajustes do Sistema → Economizador de Energia
  • Usando caffeinate se necessário
Para operação realmente sempre ativa, considere um Mac mini dedicado ou uma VPS pequena. Consulte hospedagem VPS.

​
Solução de problemas

ProblemaSolução
Não consegue acessar a VM via SSHVerifique se “Login Remoto” está habilitado nos Ajustes do Sistema da VM
IP da VM não apareceAguarde a VM inicializar completamente, execute lume get openclaw novamente
Comando Lume não encontradoAdicione ~/.local/bin ao seu PATH
QR do WhatsApp não escaneiaCertifique-se de estar logado na VM (não no host) ao executar openclaw channels login

​
Documentação relacionada