BlueBubbles

Ações do BlueBubbles

Visão Geral

BlueBubbles é a ponte legada do iMessage do OpenClaw. Use a ferramenta message com channel: "bluebubbles" para conversas existentes apoiadas pelo BlueBubbles que precisam de anexos, tapbacks, edição/desfazer envio, respostas ou gerenciamento de grupos.

Entradas a coletar

• target (prefira chat_guid:...; também +15551234567 no formato E.164 ou [email protected])
• message texto para enviar/editar/responder
• messageId para reagir/editar/desfazer envio/responder
• Anexo path para arquivos locais, ou buffer + filename para base64

Se o usuário for vago ("mande uma mensagem para minha mãe"), pergunte pelo identificador do destinatário ou chat guid e pelo conteúdo exato da mensagem.

Ações

Enviar uma mensagem

{
  "action": "send",
  "channel": "bluebubbles",
  "target": "+15551234567",
  "message": "olá do OpenClaw"
}

Reagir (tapback)

{
  "action": "react",
  "channel": "bluebubbles",
  "target": "+15551234567",
  "messageId": "<message-guid>",
  "emoji": "❤️"
}

Remover uma reação

{
  "action": "react",
  "channel": "bluebubbles",
  "target": "+15551234567",
  "messageId": "<message-guid>",
  "emoji": "❤️",
  "remove": true
}

Editar uma mensagem enviada anteriormente

{
  "action": "edit",
  "channel": "bluebubbles",
  "target": "+15551234567",
  "messageId": "<message-guid>",
  "message": "texto atualizado"
}

Desfazer envio de uma mensagem

{
  "action": "unsend",
  "channel": "bluebubbles",
  "target": "+15551234567",
  "messageId": "<message-guid>"
}

Responder a uma mensagem específica

{
  "action": "reply",
  "channel": "bluebubbles",
  "target": "+15551234567",
  "replyTo": "<message-guid>",
  "message": "respondendo a isso"
}

Enviar um anexo

{
  "action": "sendAttachment",
  "channel": "bluebubbles",
  "target": "+15551234567",
  "path": "/tmp/photo.jpg",
  "caption": "aqui está"
}

Enviar com efeito do iMessage

{
  "action": "sendWithEffect",
  "channel": "bluebubbles",
  "target": "+15551234567",
  "message": "grande notícia",
  "effect": "balloons"
}

Notas

• Requer configuração de gateway channels.bluebubbles (serverUrl/password/webhookPath).
• Prefira destinos chat_guid quando disponíveis (especialmente para chats em grupo).
• O BlueBubbles suporta ações ricas, mas algumas dependem da versão do macOS (por exemplo, edição pode estar quebrada no macOS 26 Tahoe).
• O gateway pode expor tanto IDs de mensagem curtos quanto completos; IDs completos são mais persistentes entre reinicializações.
• A referência do desenvolvedor para o plugin subjacente está no README do pacote do plugin BlueBubbles.

Ideias para testar

• Reaja com um tapback para confirmar uma solicitação.
• Responda dentro do tópico quando um usuário mencionar uma mensagem específica.
• Envie um anexo de arquivo com uma legenda curta.