bluebubbles

BlueBubbles アクション

概要

BlueBubbles は OpenClaw のレガシーな iMessage ブリッジです。添付ファイル、Tapback、編集／送信取り消し、返信、またはグループ管理が必要な、既存の BlueBubbles 経由の会話では、channel: "bluebubbles" を指定して message ツールを使用してください。

収集する入力

• target（chat_guid:... を推奨します。E.164 形式の +15551234567 または [email protected] も指定できます）
• 送信／編集／返信する message テキスト
• リアクション／編集／送信取り消し／返信に使用する messageId
• ローカルファイルの場合は添付ファイルの path、または base64 の場合は buffer と filename

ユーザーの依頼が曖昧な場合（「お母さんにメッセージして」など）は、宛先のハンドルまたは chat guid と、正確なメッセージ内容を尋ねてください。

アクション

メッセージを送信する

{
  "action": "send",
  "channel": "bluebubbles",
  "target": "+15551234567",
  "message": "hello from OpenClaw"
}

リアクションを付ける（Tapback）

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

リアクションを削除する

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

送信済みメッセージを編集する

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

メッセージの送信を取り消す

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

特定のメッセージに返信する

{
  "action": "reply",
  "channel": "bluebubbles",
  "target": "+15551234567",
  "replyTo": "<message-guid>",
  "message": "replying to that"
}

添付ファイルを送信する

{
  "action": "sendAttachment",
  "channel": "bluebubbles",
  "target": "+15551234567",
  "path": "/tmp/photo.jpg",
  "caption": "here you go"
}

iMessage エフェクトを付けて送信する

{
  "action": "sendWithEffect",
  "channel": "bluebubbles",
  "target": "+15551234567",
  "message": "big news",
  "effect": "balloons"
}

注意事項

• ゲートウェイの設定 channels.bluebubbles（serverUrl/password/webhookPath）が必要です。
• chat_guid がある場合は、宛先として指定することを推奨します（特にグループチャットの場合）。
• BlueBubbles はさまざまなアクションに対応していますが、一部は macOS のバージョンに依存します（たとえば、macOS 26 Tahoe では編集が機能しない場合があります）。
• ゲートウェイから短いメッセージ ID と完全なメッセージ ID の両方が公開されることがあります。完全な ID のほうが再起動後も有効です。
• 基盤となるプラグインの開発者向けリファレンスは、BlueBubbles プラグインパッケージの README にあります。

試してみること

• Tapback でリアクションを付けて、依頼を確認したことを伝えます。
• ユーザーが特定のメッセージに言及した場合は、スレッド内で返信します。
• 短いキャプションを添えてファイルを送信します。