メッセージングプラットフォーム

iMessage

⚠️ 新しいiMessageデプロイメントには、BlueBubblesを使用してください。imsg統合はレガシーであり、将来のリリースで削除される可能性があります。

ステータス: レガシー外部CLI統合。ゲートウェイはimsg rpcを生成し、stdio上のJSON-RPCを介して通信します（別個のデーモン/ポートは不要）。

BlueBubbles (推奨)

新しいセットアップにおける推奨iMessageパス。

ペアリング

iMessageダイレクトメッセージはデフォルトでペアリングモードになります。

設定リファレンス

iMessageフィールドの完全なリファレンス。

クイックセットアップ

brew install steipete/tap/imsg
imsg rpc --help

要件と権限 (macOS)

  • imsgを実行するMac上で、メッセージアプリにサインインしている必要があります。
  • OpenClaw/imsgを実行するプロセスコンテキストに対して、フルディスクアクセスが必要です（メッセージDBへのアクセス）。
  • Messages.app経由でメッセージを送信するには、自動化の権限が必要です。

💡 権限はプロセスコンテキストごとに付与されます。ゲートウェイがヘッドレス（LaunchAgent/SSH）で実行される場合、同じコンテキストで一度だけ対話型コマンドを実行してプロンプトをトリガーします：

コピー

imsg chats --limit 1
# または
imsg send <handle> "test"

アクセス制御とルーティング

channels.imessage.dmPolicyはダイレクトメッセージを制御します：

  • pairing (デフォルト)
  • allowlist
  • open (allowFromに"*"を含む必要があります)
  • disabled

許可リストフィールド：channels.imessage.allowFrom。許可リストエントリは、ハンドルまたはチャットターゲット（chat_id:*, chat_guid:*, chat_identifier:*）にすることができます。

デプロイメントパターン

メディア、チャンキング、配信ターゲット

設定書き込み

iMessageはデフォルトでチャネル開始の設定書き込みを許可します（commands.config: trueの場合の/config set|unset用）。無効化：

{
  channels: {
    imessage: {
      configWrites: false,
    },
  },
}

トラブルシューティング

設定リファレンスポインタ

Google ChatIRC