OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Overview

BlueBubbles の削除と imsg iMessage パス

BlueBubbles の削除と imsg iMessage パス

OpenClaw には BlueBubbles チャネルが同梱されなくなりました。iMessage サポートは、同梱の imessage Plugin を通じて動作します。Gateway はローカルまたは SSH ラッパー経由で imsg を子プロセスとして起動し、stdin/stdout 上の JSON-RPC で通信します。サーバー、Webhook、ポートはありません。

設定にまだ channels.bluebubbles が含まれている場合は、channels.imessage に移行してください。従来の /channels/bluebubbles ドキュメント URL は、完全な設定変換表と切り替えチェックリストが記載された BlueBubbles からの移行 にリダイレクトされます。

変更点

  • サポートされる iMessage パスには、BlueBubbles HTTP サーバー、Webhook ルート、REST パスワード、BlueBubbles Plugin ランタイムはありません。
  • OpenClaw は、Messages.app にサインインしている Mac 上の imsg を通じて Messages を読み取り、監視します。
  • 基本的な送信、受信、履歴、メディアには、通常の imsg サーフェスと macOS の権限を使用します。
  • 高度なアクション（スレッド返信、Tapback、編集、送信取り消し、エフェクト、開封確認、入力中インジケーター、グループ管理）にはプライベート API ブリッジが必要です。SIP を無効にする必要がある imsg launch を実行してください。
  • Linux および Windows の Gateway でも、channels.imessage.cliPath を、サインイン済みの Mac 上で imsg を実行する SSH ラッパーに指定することで、引き続き iMessage を使用できます。

対応手順

  1. Messages を使用する Mac に imsg をインストールして確認します。

    bash
    brew install steipete/tap/imsgimsg --versionimsg chats --limit 3imsg rpc --help

  2. imsg と OpenClaw を実行するプロセスコンテキストに、フルディスクアクセスとオートメーションの権限を付与します。

  3. 古い設定を変換します。

    json5
    {  channels: {    imessage: {      enabled: true,      cliPath: "/opt/homebrew/bin/imsg",      dmPolicy: "pairing",      allowFrom: ["+15555550123"],      groupPolicy: "allowlist",      groupAllowFrom: ["+15555550123"],      groups: {        "*": { requireMention: true },      },      includeAttachments: true,    },  },}

  4. Gateway を再起動して確認します。

    bash
    openclaw channels status --probe

  5. 古い BlueBubbles サーバーを削除する前に、DM、グループ、添付ファイル、および利用しているすべてのプライベート API アクションをテストします。

移行に関する注意事項

  • channels.bluebubbles.serverUrl と channels.bluebubbles.password に相当する iMessage の設定はありません。接続先や認証対象となるサーバーが存在しないためです。
  • allowFrom、groupAllowFrom、groups、includeAttachments、attachmentRoots、mediaMaxMb、textChunkLimit、actions.* は、channels.imessage でも同じ意味を持ちます。
  • channels.imessage.includeAttachments は引き続きデフォルトで無効です。受信した写真、ボイスメモ、動画、またはファイルをエージェントに届ける必要がある場合は、明示的に設定してください。
  • groupPolicy: "allowlist" では、"*" のワイルドカードエントリを含め、古い groups ブロックをコピーしてください。グループ送信者の許可リストとグループレジストリは別々のゲートです。エントリを含む groups ブロックがあっても、一致する chat_id がない（または "*" がない）場合、実行時にメッセージが破棄されます。また、空の groups ブロックがある場合、送信者フィルタリングではメッセージが引き続き通過するものの、起動時に警告が記録されます。
  • match.channel: "bluebubbles" を使用する ACP バインディングは、"imessage" に変更する必要があります。
  • 古い BlueBubbles セッションキーは、iMessage セッションキーには変換されません。ペアリングの承認は送信者ハンドルをキーとするため、コピーした allowFrom エントリは引き続き機能しますが、BlueBubbles セッションキーに紐づく会話履歴は引き継がれません。

関連項目

Was this useful?
On this page

On this page