​

iMessage（legacy: imsg）

​

クイックセットアップ

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

{
  channels: {
    imessage: {
      enabled: true,
      cliPath: "/usr/local/bin/imsg",
      dbPath: "/Users/<you>/Library/Messages/chat.db",
    },
  },
}

openclaw gateway

openclaw pairing list imessage
openclaw pairing approve imessage <CODE>

#!/usr/bin/env bash
exec ssh -T gateway-host imsg "$@"

{
  channels: {
    imessage: {
      enabled: true,
      cliPath: "~/.openclaw/scripts/imsg-ssh",
      remoteHost: "user@gateway-host", // SCP添付ファイル取得に使用
      includeAttachments: true,
      // 任意: 許可する添付ファイルルートを上書きします。
      // デフォルトには /Users/*/Library/Messages/Attachments が含まれます
      attachmentRoots: ["/Users/*/Library/Messages/Attachments"],
      remoteAttachmentRoots: ["/Users/*/Library/Messages/Attachments"],
    },
  },
}

​

要件と権限（macOS）

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

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

​

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

​

ACP会話バインディング

• DMまたは許可されたグループチャット内で/acp spawn codex --bind hereを実行します。
• 以後、同じiMessage会話内のメッセージは、生成されたACPセッションにルーティングされます。
• /newおよび/resetは、同じバインド済みACPセッションをその場でリセットします。
• /acp closeはACPセッションを閉じ、バインディングを削除します。

• +15555550123やuser@example.comのような正規化済みDMハンドル
• chat_id:<id>（安定したグループバインディングに推奨）
• chat_guid:<guid>
• chat_identifier:<identifier>

{
  agents: {
    list: [
      {
        id: "codex",
        runtime: {
          type: "acp",
          acp: { agent: "codex", backend: "acpx", mode: "persistent" },
        },
      },
    ],
  },
  bindings: [
    {
      type: "acp",
      agentId: "codex",
      match: {
        channel: "imessage",
        accountId: "default",
        peer: { kind: "group", id: "chat_id:123" },
      },
      acp: { label: "codex-group" },
    },
  ],
}

​

デプロイパターン

{
  channels: {
    imessage: {
      enabled: true,
      cliPath: "~/.openclaw/scripts/imsg-ssh",
      remoteHost: "bot@mac-mini.tailnet-1234.ts.net",
      includeAttachments: true,
      dbPath: "/Users/bot/Library/Messages/chat.db",
    },
  },
}

#!/usr/bin/env bash
exec ssh -T bot@mac-mini.tailnet-1234.ts.net imsg "$@"

​

メディア、チャンク化、配信ターゲット

imsg chats --limit 20

​

config書き込み

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

​

トラブルシューティング

imsg rpc --help
openclaw channels status --probe

imsg chats --limit 1
imsg send <handle> "test"

​

設定リファレンスへのポインター

• Configuration reference - iMessage
• Gateway configuration
• Pairing
• BlueBubbles

​

関連

• Channels Overview — サポートされているすべてのチャンネル
• Pairing — DM認証とpairingフロー
• Groups — グループチャットの動作とmentionゲーティング
• Channel Routing — メッセージのセッションルーティング
• Security — アクセスモデルとハードニング