【最新版】BlueBubblesでiMessageにOpenClawを接続する方法

BlueBubbles連携とは（超ざっくり）

BlueBubblesはmacOS上で動くiMessageブリッジです。OpenClawはBlueBubblesサーバーのREST APIで送信し、 受信はWebhookで受け取ります。

• 送信：OpenClaw → BlueBubbles（HTTP）
• 受信：BlueBubbles → OpenClaw Gateway（Webhook）

前提（先に確認すること）

• BlueBubblesサーバー: macOSで動作（推奨/検証：macOS Sequoia 15。macOS Tahoe 26も動くが一部機能に制限がある）
• OpenClaw: Gatewayが動いていて、Control UI（openclaw dashboard）に接続できること

手順：BlueBubblesでiMessageに接続する

Step 1：BlueBubblesサーバーをインストール

まずBlueBubbles側をセットアップします（手順はBlueBubbles公式のインストールガイドに沿って進めます）。

Step 2：BlueBubblesでWeb APIを有効化し、パスワードを設定

OpenClawはBlueBubblesのAPIパスワードで認証します。ここで設定したパスワードを、OpenClaw側の channels.bluebubbles.password に入れます。

Step 3：OpenClaw側の設定（最小）

まずはオンボーディング（対話式）で追加するのが簡単です。

openclaw onboard

もしくは手動で設定する場合、最低限はこの形です。

{
  channels: {
    bluebubbles: {
      enabled: true,
      serverUrl: "http://192.168.1.100:1234",
      password: "<YOUR_PASSWORD>",
      webhookPath: "/bluebubbles-webhook",
    },
  },
}

Step 4：BlueBubblesのWebhookをGatewayへ向ける

BlueBubblesからの受信（Webhook）が通らないと「送れるけど返ってこない」になります。WebhookのURLは、Gatewayが待ち受けているエンドポイント（例：/bluebubbles-webhook）に向けます。

重要：Webhookの認証は必須です。OpenClawはパスワードが一致しないWebhookを拒否します。

アクセス制御（最初はここだけ）

最初はDMをペアリング（許可制）にして、知らない相手からのメッセージを処理しないようにするのが安全です。

承認の流れはこの2コマンドです。

openclaw pairing list bluebubbles
openclaw pairing approve bluebubbles <CODE>

よくあるつまずき（原因→直し方）

送信はできるのに、返信が返ってこない

• WebhookがGatewayに届いていない（URL/パスのミス）
• Webhookのパスワードが一致していない（認証で拒否される）

別端末/別ブラウザからControl UIに接続できない

Gatewayは初回接続でペアリング（デバイス承認）が必要になることがあります。

openclaw devices list
openclaw devices approve <requestId>

まとめ

• 本体は2つ: BlueBubblesサーバー（macOS）＋ OpenClaw Gateway
• 最小設定: serverUrl/password/webhookPath
• 詰まり所: Webhook認証とペアリング（許可）

参考

• OpenClaw: BlueBubbles
• OpenClaw: Pairing
• BlueBubbles