iMessageでOpenClawを使う

OpenClawはimsgを通じてiMessageとやり取りします。imsgはコマンドラインのブリッジで、Gatewayがそれを起動し、標準入出力上のJSON-RPCで通信します。デーモンもポートもありません。imsgはメッセージアプリにサインインしているMac上で動かす必要があり、Gatewayが別の場所にある場合は、SSHラッパーを通じてそのMacに到達します。BlueBubblesのサポートは削除され、現在はimsgが唯一の経路です。以下では、セットアップ、権限、2つのモード、そしてドキュメントが推奨するデプロイのパターンを説明します。

Macでのセットアップ

• Gatewayホストに公式のiMessageプラグインをインストールし、続いてHomebrewでimsgをそのtapからインストールします。セットアップウィザードは、imsgが見つからない場合や、Homebrewで管理されたimsgを見つけた場合に、そのインストールや更新を提案できます。
• チャネルの設定でimsgのバイナリと、ユーザーのLibraryフォルダ配下にあるメッセージのデータベースを指定し、Gatewayを起動して、最初のDMのペアリングを承認します。リクエストは1時間で期限切れになります。
• imsgを実行するコンテキストに、フルディスクアクセスとオートメーションを許可します。権限のプロンプトを見逃した場合はトラブルシューティングの項目として載っており、送信はできるのに何も届かない場合も同様です。

基本モードとプライベートAPIモード

基本モードは新規インストールで得られるモードで、テキストとメディアの送信、受信の監視と履歴、チャット一覧を利用でき、システムには何の変更も加えません。プライベートAPIモードは、メッセージアプリの内部機能にアクセスするためにヘルパーを注入し、リアクション、編集、送信取り消し、スレッド返信、エフェクト、ネイティブの投票、グループ管理、入力中インジケーター、既読通知が使えるようになります。これにはSystem Integrity Protectionをオフにし、ライブラリ検証を緩める必要があり、SIPがオンの間は注入が実行を拒否します。

SIPを無効にすることは、セキュリティ上の本物のトレードオフです。

ドキュメントはこのトレードオフについて率直です。SIPはmacOSの中核的な保護機能の1つであり、Apple Siliconでオフにすると、MacでiOSアプリを実行する機能も失われます。推奨されるのは、ブリッジ専用のMacか専用のボットユーザーです。脅威モデル上、どこであってもSIPのオフを許容できないなら、このチャネルは基本モードのみになります。より幅広いチェックリストはOpenClawのセキュリティのベストプラクティスにあります。

Gatewayをどこに置くか

• 同じMac：一般的なデプロイで、Gatewayとimsgを、メッセージアプリにサインイン済みの同じホストで一緒に動かします。
• SSHまたはTailscale経由のリモートMac：GatewayはLinuxやVM上に、imsgはtailnet内のMac上に置き、CLIのパスとして透過的なSSHラッパーを、添付ファイル用にリモートホストの設定を使います。ラッパーはバイトを受け取ったそばから転送しなければなりません。バッファリングするラッパーは、iMessageの障害とまったく同じように見えます。
• ボット専用のmacOSユーザー：別のApple IDとユーザーを用意し、ボットのトラフィックが個人のメッセージのプロファイルに一切触れないようにします。初回実行時には、そのユーザーのセッションでオートメーションとフルディスクアクセスの承認が必要です。

受信の復旧は自動です。ブリッジやGatewayの再起動後、チャネルは見逃したメッセージを再生し、プッシュの復旧後にAppleが一気に流し込むことがある未処理分を抑制します。何かを二重に処理することはありません。無反応なチャネル全般の診断手順は、OpenClawが応答しない場合のガイドで説明しています。

実際のところ何を意味するか

iMessageは、Appleのハードウェアから切り離せない唯一のチャネルです。Gatewayはどこにあっても対応できますが、それはあなたの側に、imsgを実行し、サインインしていて、スリープせず、到達可能なMacがある場合に限られます。そしてそのMacは運用業務の一部になります。そのアップデート、その権限、そのSIPに関する判断も含めてです。

Dialiでは

Dialiでは、iMessageは接続できるチャネルの一覧ではなく、ロードマップ上にあります。メッセージアプリのMacはお客様のものである必要があり、そのMacとホスト型Gatewayとのペアリングには、それだけで1ページを割く価値があるからです。それまでは、ほとんどの人がTelegram上のOpenClawから始めます。アシスタントについてはDialiのマネージドOpenClawホスティングをご覧ください。

• サインイン済みのMac上のimsg、フルディスクアクセスとオートメーション、DMのペアリング。
• 基本モードではSIPはオンのまま。プライベートAPIにはオフが必要で、できれば専用のMacかユーザーで使います。
• Gatewayはどこにでも置けますが、Macはそうはいきません。