BlueBubbles アクション
概要
BlueBubblesは、OpenClawのレガシーiMessageブリッジです。添付ファイル、タップバック、編集/送信取消、返信、グループ管理が必要な既存のBlueBubbles対応会話では、channel: "bluebubbles"を指定してmessageツールを使用してください。
収集する入力
target（chat_guid:...を推奨。E.164形式の+15551234567や[email protected]も可）- 送信/編集/返信用の
messageテキスト - リアクション/編集/送信取消/返信用の
messageId - ローカルファイル用の添付ファイル
path、またはbase64用のbuffer+filename
ユーザーがあいまいな場合（「母にテキストして」など）、受信者のハンドルまたはチャットGUIDと、正確なメッセージ内容を確認してください。
アクション
メッセージを送信
{
"action": "send",
"channel": "bluebubbles",
"target": "+15551234567",
"message": "hello from OpenClaw"
}
リアクション（タップバック）
{
"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にあります。
試してみるアイデア
- タップバックでリアクションしてリクエストを承認する。
- ユーザーが特定のメッセージを参照した場合、スレッド内で返信する。
- 短いキャプション付きでファイル添付を送信する。