BlueBubbles

BlueBubbles Aktionen

Übersicht

BlueBubbles ist OpenClaw's Legacy-iMessage-Brücke. Verwende das message-Werkzeug mit channel: "bluebubbles" für bestehende BlueBubbles-gestützte Unterhaltungen, die Anhänge, Tapbacks, Bearbeitungen/Rücknahmen, Antworten oder Gruppenverwaltung benötigen.

Eingaben erfassen

• target (bevorzuge chat_guid:...; auch +15551234567 in E.164 oder [email protected])
• message Text zum Senden/Bearbeiten/Antworten
• messageId zum Reagieren/Bearbeiten/Rücknehmen/Antworten
• Anhang path für lokale Dateien, oder buffer + filename für Base64

Falls der Benutzer vage ist ("Schreib meiner Mutter"), frage nach dem Empfänger-Handle oder der Chat-GUID und dem genauen Nachrichteninhalt.

Aktionen

Nachricht senden

{
  "action": "send",
  "channel": "bluebubbles",
  "target": "+15551234567",
  "message": "Hallo von OpenClaw"
}

Reagieren (Tapback)

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

Reaktion entfernen

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

Eine zuvor gesendete Nachricht bearbeiten

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

Nachricht zurücknehmen

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

Auf eine bestimmte Nachricht antworten

{
  "action": "reply",
  "channel": "bluebubbles",
  "target": "+15551234567",
  "replyTo": "<message-guid>",
  "message": "Antworte darauf"
}

Anhang senden

{
  "action": "sendAttachment",
  "channel": "bluebubbles",
  "target": "+15551234567",
  "path": "/tmp/photo.jpg",
  "caption": "hier bitte"
}

Mit iMessage-Effekt senden

{
  "action": "sendWithEffect",
  "channel": "bluebubbles",
  "target": "+15551234567",
  "message": "große Neuigkeiten",
  "effect": "balloons"
}

Hinweise

• Erfordert Gateway-Konfiguration channels.bluebubbles (serverUrl/password/webhookPath).
• Bevorzuge chat_guid-Ziele, wenn vorhanden (besonders für Gruppenchats).
• BlueBubbles unterstützt umfangreiche Aktionen, aber einige sind von der macOS-Version abhängig (z. B. Bearbeitung kann unter macOS 26 Tahoe defekt sein).
• Das Gateway kann sowohl kurze als auch vollständige Nachrichten-IDs bereitstellen; vollständige IDs sind stabiler bei Neustarts.
• Entwicklerreferenz für das zugrundeliegende Plugin befindet sich in der README des BlueBubbles-Plugin-Pakets.

Ideen zum Ausprobieren

• Reagiere mit einem Tapback, um eine Anfrage zu bestätigen.
• Antworte im Thread, wenn ein Benutzer auf eine bestimmte Nachricht verweist.
• Sende einen Dateianhang mit einer kurzen Bildunterschrift.