Remoção do BlueBubbles e o caminho do iMessage via imsg

O OpenClaw não inclui mais o canal BlueBubbles. O suporte ao iMessage funciona por meio do plugin imessage incluído: o Gateway inicia o imsg como um processo filho, localmente ou por meio de um wrapper SSH, e se comunica via JSON-RPC pela entrada/saída padrão. Sem servidor, sem webhook, sem porta.

Se a sua configuração ainda contiver channels.bluebubbles, migre-a para channels.imessage. A URL legada da documentação /channels/bluebubbles redireciona para Migração do BlueBubbles, que contém a tabela completa de conversão da configuração e a lista de verificação para a transição.

O que mudou

• O caminho compatível com o iMessage não tem servidor HTTP do BlueBubbles, rota de webhook, senha REST nem ambiente de execução do plugin BlueBubbles.
• O OpenClaw lê e monitora o Mensagens por meio do imsg no Mac em que há uma sessão iniciada no Messages.app.
• O envio, o recebimento, o histórico e as mídias básicos usam as interfaces normais do imsg e as permissões do macOS.
• Ações avançadas (respostas em threads, reações, edição, cancelamento de envio, efeitos, confirmações de leitura, indicadores de digitação e gerenciamento de grupos) exigem a ponte de API privada: execute imsg launch, o que requer que o SIP esteja desativado.
• Gateways Linux e Windows ainda podem usar o iMessage apontando channels.imessage.cliPath para um wrapper SSH que execute o imsg no Mac com a sessão iniciada.

O que fazer

1. Instale e verifique o imsg no Mac que executa o Mensagens:

   brew install steipete/tap/imsgimsg --versionimsg chats --limit 3imsg rpc --help

2. Conceda permissões de Acesso Total ao Disco e Automação ao contexto de processo que executa o imsg e o OpenClaw.

3. Converta a configuração antiga:

   {  channels: {    imessage: {      enabled: true,      cliPath: "/opt/homebrew/bin/imsg",      dmPolicy: "pairing",      allowFrom: ["+15555550123"],      groupPolicy: "allowlist",      groupAllowFrom: ["+15555550123"],      groups: {        "*": { requireMention: true },      },      includeAttachments: true,    },  },}

4. Reinicie o Gateway e verifique:

   openclaw channels status --probe

5. Teste mensagens diretas, grupos, anexos e todas as ações da API privada das quais você depende antes de excluir o servidor BlueBubbles antigo.

Observações sobre a migração

• channels.bluebubbles.serverUrl e channels.bluebubbles.password não têm equivalente no iMessage; não há servidor para acessar ou no qual se autenticar.
• allowFrom, groupAllowFrom, groups, includeAttachments, attachmentRoots, mediaMaxMb, textChunkLimit e actions.* mantêm seus significados em channels.imessage.
• channels.imessage.includeAttachments continua desativado por padrão. Defina-o explicitamente se quiser que fotos, memorandos de voz, vídeos ou arquivos recebidos cheguem ao agente.
• Com groupPolicy: "allowlist", copie o bloco groups antigo, incluindo qualquer entrada curinga "*". As listas de remetentes permitidos de grupos e o registro de grupos são verificações separadas; um bloco groups com entradas, mas sem um chat_id correspondente (ou sem "*") descarta a mensagem durante a execução, e um bloco groups vazio registra um aviso na inicialização, embora a filtragem de remetentes ainda permita a passagem das mensagens.
• As vinculações ACP com match.channel: "bluebubbles" devem ser alteradas para "imessage".
• As chaves de sessão antigas do BlueBubbles não se tornam chaves de sessão do iMessage. As aprovações de pareamento usam os identificadores dos remetentes como chave; portanto, as entradas allowFrom copiadas continuam funcionando, mas o histórico de conversas associado às chaves de sessão do BlueBubbles não é transferido.

Veja também

• Migração do BlueBubbles
• iMessage
• Referência de configuração — iMessage