OpenClaw no iMessage

O OpenClaw fala com o iMessage pelo imsg, uma ponte de linha de comando que o Gateway inicia e com a qual conversa via JSON-RPC pela entrada e saída padrão: nada de daemon, nada de porta. Ele precisa rodar em um Mac com sessão iniciada no Mensagens e, se o Gateway ficar em outro lugar, ele alcança esse Mac por meio de um wrapper SSH. O suporte ao BlueBubbles foi removido; o imsg agora é o único caminho. Veja a configuração, as permissões, os dois modos e os padrões de implantação que a documentação recomenda.

Configuração no Mac

• Instale o plugin oficial do iMessage no host do Gateway e, depois, o imsg pelo Homebrew, a partir do tap dele; o assistente de configuração pode oferecer essa instalação, ou uma atualização, quando encontra um imsg ausente ou gerenciado pelo Homebrew.
• Aponte o canal para o binário imsg e para o banco de dados do Mensagens na pasta Library do usuário, inicie o Gateway e aprove o primeiro pareamento por DM: as solicitações expiram depois de uma hora.
• Conceda Acesso Total ao Disco e Automação ao contexto que executa o imsg; pedidos de permissão perdidos são uma entrada listada na solução de problemas, assim como mensagens que são enviadas enquanto nada chega.

Modo básico e modo de API privada

O modo básico é o que uma instalação nova oferece: texto e mídia de saída, monitoramento e histórico de entrada, a lista de conversas e nenhuma alteração no sistema. O modo de API privada injeta um helper no Mensagens para alcançar as funções internas dele, o que libera reações, edições, cancelamento de envio, respostas em thread, efeitos, enquetes nativas, gerenciamento de grupos, indicadores de digitação e confirmações de leitura. Ele exige a Proteção da Integridade do Sistema desativada e a validação de bibliotecas relaxada, e a injeção se recusa a rodar enquanto o SIP estiver ativado.

Desativar o SIP é um trade-off de segurança real.

A documentação é direta sobre esse trade-off: o SIP é uma das proteções centrais do macOS, desativá-lo no Apple Silicon também remove a capacidade de rodar apps de iOS no Mac, e a recomendação é um Mac dedicado ou um usuário dedicado ao bot para a ponte. Se o seu modelo de ameaça não tolera o SIP desativado em lugar nenhum, o canal fica só no modo básico. O guia de boas práticas de segurança do OpenClaw é a checklist mais ampla.

Onde o Gateway fica

• Mesmo Mac: a implantação habitual, com o Gateway e o imsg juntos no host com sessão iniciada no Mensagens.
• Mac remoto via SSH ou Tailscale: o Gateway no Linux ou em uma VM, o imsg em um Mac na tailnet, um wrapper SSH transparente como caminho da CLI e uma configuração de host remoto para os anexos. O wrapper precisa repassar os bytes à medida que chegam; um wrapper que faz buffer parece exatamente uma queda do iMessage.
• Usuário do macOS dedicado ao bot: um ID Apple e um usuário separados, para que o tráfego do bot nunca toque o seu perfil pessoal do Mensagens; a primeira execução exige as aprovações de Automação e de Acesso Total ao Disco na sessão desse usuário.

A recuperação de entrada é automática: depois de um reinício da ponte ou do Gateway, o canal reproduz o que foi perdido e suprime o acúmulo que a Apple pode despejar após uma recuperação de push, sem despachar nada duas vezes. O guia para quando o OpenClaw não responde cobre a escada geral para canais silenciosos.

O que isso significa na prática

O iMessage é o único canal que não pode sair do hardware da Apple. Um Gateway em qualquer lugar pode atendê-lo, mas só com um Mac do seu lado rodando o imsg, com sessão iniciada, acordado e acessível, e esse Mac passa a fazer parte do trabalho de operação: as atualizações dele, as permissões dele, a decisão dele sobre o SIP.

Na Diali

Na Diali, o iMessage está no roadmap, e não na lista de canais para conectar, porque o Mac com o Mensagens precisa ser seu, e o pareamento entre ele e um Gateway hospedado merece uma página própria. Até lá, o OpenClaw no Telegram é o canal por onde a maioria das pessoas começa; o OpenClaw hospedado na Diali é o assistente.

• imsg em um Mac com sessão iniciada, Acesso Total ao Disco e Automação, pareamento para DMs.
• O modo básico mantém o SIP ativado; a API privada exige desativá-lo, de preferência em um Mac ou usuário dedicado.
• O Gateway pode ficar em qualquer lugar; o Mac, não.