メインコンテンツへスキップ

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
BlueBubbles の削除と imsg iMessage パス

OpenClaw は BlueBubbles チャンネルを同梱しなくなりました。iMessage サポートは現在、同梱の imessage plugin を通じて実行されます。この plugin は imsg をローカルまたは SSH ラッパー経由で起動し、stdin/stdout 上の JSON-RPC で通信します。 設定にまだ channels.bluebubbles が含まれている場合は、channels.imessage に移行してください。従来の /channels/bluebubbles ドキュメント URL は BlueBubbles からの移行 にリダイレクトされます。そこには完全な設定変換表と切り替えチェックリストがあります。

​
変更点

  • サポート対象の OpenClaw iMessage パスには、BlueBubbles HTTP サーバー、webhook ルート、REST パスワード、BlueBubbles plugin ランタイムはありません。
  • OpenClaw は、Messages.app にサインインしている Mac 上の imsg を通じて Messages を読み取り、監視します。
  • 基本的な送信、受信、履歴、メディアは通常の imsg サーフェスと macOS 権限を使用します。
  • スレッド返信、tapback、編集、送信取り消し、エフェクト、既読通知、入力インジケーター、グループ管理などの高度なアクションには、プライベート API ブリッジが利用可能な状態での imsg launch が必要です。
  • Linux および Windows Gateway でも、サインイン済みの Mac で imsg を実行する SSH ラッパーを channels.imessage.cliPath に設定することで、引き続き iMessage を使用できます。

​
対応方法

  1. Messages Mac に imsg をインストールして検証します。 
    brew install steipete/tap/imsg
imsg --version
imsg chats --limit 3
imsg rpc --help
  2. imsg と OpenClaw を実行するプロセスコンテキストにフルディスクアクセスと Automation 権限を付与します。
  3. 古い設定を変換します。 
    {
  channels: {
    imessage: {
      enabled: true,
      cliPath: "/opt/homebrew/bin/imsg",
      dmPolicy: "pairing",
      allowFrom: ["+15555550123"],
      groupPolicy: "allowlist",
      groupAllowFrom: ["+15555550123"],
      groups: {
        "*": { requireMention: true },
      },
      includeAttachments: true,
    },
  },
}
  4. Gateway を再起動して検証します。 
    openclaw channels status --probe
  5. 古い BlueBubbles サーバーを削除する前に、DM、グループ、添付ファイル、および依存しているプライベート API アクションをテストします。

​
移行メモ

  • channels.bluebubbles.serverUrl と channels.bluebubbles.password に相当する iMessage の設定はありません。
  • channels.bluebubbles.allowFrom、groupAllowFrom、groups、includeAttachments、添付ファイルルート、メディアサイズ制限、チャンク化、アクション切り替えには iMessage 相当の設定があります。
  • channels.imessage.includeAttachments は引き続きデフォルトでオフです。受信した写真、音声メモ、動画、ファイルがエージェントに届くことを期待する場合は、明示的に設定してください。
  • groupPolicy: "allowlist" では、"*" ワイルドカードエントリを含め、古い groups ブロックをコピーしてください。グループ送信者 allowlist とグループレジストリは別々のゲートです。
  • channel: "bluebubbles" に一致していた ACP バインディングは、channel: "imessage" に変更する必要があります。
  • 古い BlueBubbles セッションキーは iMessage セッションキーにはなりません。ペアリング承認はハンドル単位で引き継がれますが、BlueBubbles セッションキー配下の会話履歴は引き継がれません。

​
関連項目