BlueBubblesを使ったOpenClawとiMessageの接続

BlueBubbles を選ぶ理由

以前 OpenClaw のネイティブ iMessage 統合（AppleScript ブリッジベース）を使用していた場合、ポーリング遅延、リッチメディアの送信不可、macOS システムアップデートへの脆弱性など、その制限に気づいていたかもしれません。OpenClaw の最新バージョンから、従来の iMessage 統合は正式に非推奨となり、BlueBubbles が iMessage 接続の公式推奨代替手段となりました。

BlueBubbles は macOS 上でサーバーを動作させるオープンソースプロジェクトで、REST API を通じて iMessage のフル機能を公開します。OpenClaw はこの API を通じて iMessage とやり取りし、従来のアプローチに比べて大きな利点があります：

REST API アーキテクチャ：安定して信頼性が高く、脆弱な AppleScript ブリッジに依存しない
フル機能サポート：テキスト、画像、添付ファイル、Tapback リアクションなどの送受信に対応
リアルタイムメッセージ配信：WebSocket による即時通知、ポーリング遅延を排除
ネイティブ統合：OpenClaw に BlueBubbles チャンネルサポートが組み込まれており、追加のプラグインは不要
活発なメンテナンス：BlueBubbles コミュニティは活発で、macOS のアップデートにも迅速に対応

前提条件

開始前に以下を確認してください：

要件	詳細
macOS デバイス	BlueBubbles サーバーとして使用する Mac（Mac mini を推奨）
macOS バージョン	macOS 11 Big Sur 以降
Apple ID	iMessage にサインイン済みの Apple ID
OpenClaw	インストール済みで動作中（Mac と同じマシンでなくてもよい）
ネットワーク	BlueBubbles サーバーに OpenClaw からアクセスできること

従来のアプローチとは異なり、OpenClaw 自体を macOS 上で実行する必要はありません。Linux VPS 上で OpenClaw を実行し、Mac mini を BlueBubbles サーバーとして使用できます。この分離アーキテクチャにより、柔軟性が大幅に向上します。

ステップ1：BlueBubbles サーバーのインストールと設定

1.1 BlueBubbles のダウンロード

BlueBubbles の公式サイトから macOS サーバーアプリケーションをダウンロードするか、Homebrew でインストールします：

brew install --cask bluebubbles

1.2 初期セットアップ

BlueBubbles を初めて起動した後、セットアップウィザードに従います：

BlueBubbles にフルディスクアクセスを付与（システム設定 > プライバシーとセキュリティ > フルディスクアクセス）
メッセージアプリが Apple ID でサインインしていることを確認
BlueBubbles でサーバーパスワードを設定（後で OpenClaw の設定に入力する必要があります）

1.3 REST API アドレスの取得

BlueBubbles が動作を開始すると、メニューバーにサーバーのローカルアドレスが表示されます。通常は以下のとおりです：

http://localhost:1234

OpenClaw が別のマシンで動作している場合、このポートにリモートからアクセスできるようにする必要があります。以下の方法で実現できます：

LAN 直接接続：両方のマシンが同じネットワーク上にあることを確認し、Mac の LAN IP を使用
リバースプロキシ：Nginx または Cloudflare Tunnel を使用して API を公開
BlueBubbles の組み込み Ngrok/Dynamic DNS 機能

ステップ2：OpenClaw から BlueBubbles への接続設定

2.1 チャンネルの追加

以下のコマンドを実行して BlueBubbles チャンネルを追加します：

openclaw channel add bluebubbles

ウィザードが BlueBubbles サーバーのアドレスとパスワードの入力をガイドします。

2.2 手動設定

~/.config/openclaw/openclaw.json5 を直接編集することもできます：

{
  channels: {
    bluebubbles: {
      enabled: true,

      // BlueBubbles サーバーアドレス
      serverUrl: "http://192.168.1.100:1234",

      // BlueBubbles サーバーパスワード
      password: "your-server-password",

      // セキュリティ設定
      security: {
        allowedIdentifiers: [
          "+8613800138000",
          "[email protected]"
        ],
        groupChatEnabled: false,
        allowUnknown: false
      },

      // トリガー設定
      trigger: {
        autoReply: true,
        keywords: [],
        groupTrigger: "keyword",
        groupKeywords: ["@AI", "/ask"]
      },

      // メッセージ設定
      message: {
        maxLength: 10000,
        sendTypingIndicator: true,
        sendReadReceipts: true,
        supportAttachments: true
      }
    }
  }
}

2.3 起動と確認

openclaw restart

# BlueBubbles チャンネルのログを表示
openclaw logs -f --component channel:bluebubbles

接続が成功すると、以下のように表示されます：

[INFO] [channel:bluebubbles] BlueBubbles connection established
[INFO] [channel:bluebubbles] Server version: 1.x.x
[INFO] [channel:bluebubbles] WebSocket connected, waiting for real-time messages...
[INFO] [channel:bluebubbles] Allowed contacts: 2

従来の iMessage 統合からの移行

以前の AppleScript ベースのアプローチを使用していた場合、移行は簡単です：

OpenClaw サービスを停止：openclaw stop
設定ファイルの channels.imessage.enabled を false に設定
上記の手順に従って BlueBubbles チャンネルを設定
再起動：openclaw up

従来の imessage チャンネル設定は設定ファイルに残しても構いません。enabled が false に設定されていることを確認するだけです。起動時に従来の iMessage チャンネルがまだ有効であることを検出すると、OpenClaw は非推奨の警告を出力し、BlueBubbles への切り替えを提案します。

メッセージタイプ対応の比較

BlueBubbles のアプローチは従来の統合から大幅に改善されています：

メッセージタイプ	従来の iMessage	BlueBubbles
プレーンテキスト	対応	対応
画像の受信	一部対応	完全対応
画像の送信	非対応	対応
添付ファイル	非対応	対応
Tapback リアクション	非対応	対応
既読確認	非対応	対応
入力インジケータ	非対応	対応
グループ管理	非対応	対応
リアルタイムプッシュ	非対応（ポーリング）	対応（WebSocket）

よくある問題のトラブルシューティング

BlueBubbles サーバーに接続できない

# ネットワーク接続をテスト
curl http://192.168.1.100:1234/api/v1/server/info -H "Authorization: Bearer your-password"

サーバー情報の JSON が返されれば、ネットワークと認証は正常です。そうでない場合は、ファイアウォールの設定を確認し、パスワードが正しいことを確認してください。

Mac のスリープによる切断

サーバーとして使用する Mac はスリープモードにならないようにする必要があります。システム設定で自動スリープを無効にしてください：

システム設定 > エネルギー > 自動スリープを防止

Mac mini の場合、ディスプレイを接続するか HDMI ダミープラグを使用して、ディスプレイがないことによるシステムのパフォーマンス低下を防ぐことを推奨します。

BlueBubbles アップデート後の接続問題

BlueBubbles のアップデートにより API の動作が変わる場合があります。この場合、OpenClaw も最新バージョンに更新してください：

openclaw update
openclaw restart

まとめ

BlueBubbles は OpenClaw の公式推奨 iMessage 接続ソリューションであり、非推奨となった従来の AppleScript 統合を完全に置き換えます。REST API と WebSocket を通じて、安定した機能豊富な iMessage 体験を提供します。主なポイント：

今すぐ移行：従来の iMessage 統合は非推奨であり、将来のバージョンで削除される可能性があります
柔軟なアーキテクチャ：OpenClaw と BlueBubbles サーバーは別々にデプロイ可能
フル機能：画像、添付ファイル、Tapback、既読確認などに対応
ホワイトリストの設定：すべてのチャンネルと同様に、プライバシーと API クォータを保護するため連絡先ホワイトリストの設定を推奨
Mac の稼働を維持：BlueBubbles を実行する Mac がスリープやシャットダウンしないようにする