​

iMessage (legacy: imsg)

Рекомендуется: Для новых настроек iMessage используйте BlueBubbles. Канал imsg является устаревшей интеграцией через внешний CLI и может быть удалён в будущих релизах.

​

Быстрая настройка (для начинающих)

1. Убедитесь, что Messages выполнен вход на этом Mac.
2. Установите imsg:
   • brew install steipete/tap/imsg
3. Настройте OpenClaw с помощью channels.imessage.cliPath и channels.imessage.dbPath.
4. Запустите шлюз и подтвердите все запросы macOS (Automation + Full Disk Access).

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

​

Что это такое

• Канал iMessage, работающий на основе imsg в macOS.
• Детерминированная маршрутизация: ответы всегда возвращаются в iMessage.
• Личные сообщения используют основной сеанс агента; группы изолированы (agent:<agentId>:imessage:group:<chat_id>).
• Если поток с несколькими участниками приходит с is_group=false, вы всё равно можете изолировать его, настроив chat_id с помощью channels.imessage.groups (см. «Псевдогрупповые потоки» ниже).

​

Запись конфига

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

​

Требования

• macOS с выполненным входом в Messages.
• Full Disk Access для OpenClaw + imsg (доступ к БД Messages).
• Разрешение Automation при отправке.
• channels.imessage.cliPath может указывать на любую команду, проксирующую stdin/stdout (например, скрипт-обёртку, который подключается по SSH к другому Mac и запускает imsg rpc).

​

Устранение неполадок macOS Privacy and Security TCC

• Full Disk Access: разрешите доступ процессу, запускающему OpenClaw (и любой shell/SSH-обёртке, которая выполняет imsg). Это требуется для чтения базы данных Messages (chat.db).
• Automation → Messages: разрешите процессу, запускающему OpenClaw (и/или вашему терминалу), управлять Messages.app для исходящей отправки.
• Состояние CLI imsg: убедитесь, что imsg установлен и поддерживает RPC (imsg rpc --help).

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

​

Настройка (быстрый путь)

1. Убедитесь, что Messages выполнен вход на этом Mac.
2. Настройте iMessage и запустите шлюз.

​

Выделенный пользователь macOS для бота (для изолированной идентичности)

1. Создайте отдельный Apple ID (пример: [email protected]).
   • Apple может потребовать номер телефона для верификации / 2FA.
2. Создайте пользователя macOS (пример: openclawhome) и войдите под ним.
3. Откройте Messages под этим пользователем macOS и войдите в iMessage, используя Apple ID бота.
4. Включите Remote Login (System Settings → General → Sharing → Remote Login).
5. Установите imsg:
   • brew install steipete/tap/imsg
6. Настройте SSH так, чтобы ssh <bot-macos-user>@localhost true работал без пароля.
7. Укажите channels.imessage.accounts.bot.cliPath на SSH-обёртку, которая запускает imsg от имени пользователя бота.

#!/usr/bin/env bash
set -euo pipefail

# Run an interactive SSH once first to accept host keys:
#   ssh <bot-macos-user>@localhost true
exec /usr/bin/ssh -o BatchMode=yes -o ConnectTimeout=5 -T <bot-macos-user>@localhost \
  "/usr/local/bin/imsg" "$@"

{
  channels: {
    imessage: {
      enabled: true,
      accounts: {
        bot: {
          name: "Bot",
          enabled: true,
          cliPath: "/path/to/imsg-bot",
          dbPath: "/Users/<bot-macos-user>/Library/Messages/chat.db",
        },
      },
    },
  },
}

​

Удалённый/SSH-вариант (необязательно)

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

{
  channels: {
    imessage: {
      cliPath: "~/imsg-ssh", // SSH wrapper to remote Mac
      remoteHost: "user@gateway-host", // for SCP file transfer
      includeAttachments: true,
    },
  },
}

​

Удалённый Mac через Tailscale (пример)

{
  channels: {
    imessage: {
      enabled: true,
      cliPath: "~/.openclaw/scripts/imsg-ssh",
      remoteHost: "[email protected]",
      includeAttachments: true,
      dbPath: "/Users/bot/Library/Messages/chat.db",
    },
  },
}

#!/usr/bin/env bash
exec ssh -T [email protected] imsg "$@"

• Убедитесь, что Mac выполнен вход в Messages и включён Remote Login.
• Используйте SSH-ключи, чтобы ssh [email protected] работал без запросов.
• remoteHost должен совпадать с SSH-целью, чтобы SCP мог получать вложения.

​

Контроль доступа (личные сообщения + группы)

• По умолчанию: channels.imessage.dmPolicy = "pairing".
• Неизвестные отправители получают код сопряжения; сообщения игнорируются до подтверждения (коды истекают через 1 час).
• Подтверждение через:
  • openclaw pairing list imessage
  • openclaw pairing approve imessage <CODE>
• Сопряжение — стандартный обмен токенами для личных сообщений iMessage. Подробности: Pairing

• channels.imessage.groupPolicy = open | allowlist | disabled.
• channels.imessage.groupAllowFrom управляет тем, кто может триггерить в группах, когда установлен allowlist.
• Ограничение по упоминаниям использует agents.list[].groupChat.mentionPatterns (или messages.groupChat.mentionPatterns), поскольку iMessage не имеет нативных метаданных упоминаний.
• Переопределение для нескольких агентов: задайте шаблоны для каждого агента в agents.list[].groupChat.mentionPatterns.

​

Как это работает (поведение)

• imsg потоково передаёт события сообщений; шлюз нормализует их в общий конверт канала.
• Ответы всегда маршрутизируются обратно в тот же идентификатор чата или handle.

​

Псевдогрупповые потоки (is_group=false)

• изоляции сеансов (отдельный ключ сеанса agent:<agentId>:imessage:group:<chat_id>)
• поведения allowlist для групп / ограничения по упоминаниям

{
  channels: {
    imessage: {
      groupPolicy: "allowlist",
      groupAllowFrom: ["+15555550123"],
      groups: {
        "42": { requireMention: false },
      },
    },
  },
}

​

Медиа + ограничения

• Необязательная загрузка вложений в контекст через channels.imessage.includeAttachments.
• Лимит медиа через channels.imessage.mediaMaxMb.

​

Ограничения

• Исходящий текст разбивается на чанки по channels.imessage.textChunkLimit (по умолчанию 4000).
• Необязательная разбивка по новым строкам: установите channels.imessage.chunkMode="newline", чтобы делить по пустым строкам (границы абзацев) перед разбивкой по длине.
• Загрузка медиа ограничена параметром channels.imessage.mediaMaxMb (по умолчанию 16).

​

Адресация / цели доставки

• chat_id:123 (предпочтительно)
• chat_guid:...
• chat_identifier:...
• прямые handle: imessage:+1555 / sms:+1555 / [email protected]

imsg chats --limit 20

​

Справочник конфигурации (iMessage)

• channels.imessage.enabled: включить/отключить запуск канала.
• channels.imessage.cliPath: путь к imsg.
• channels.imessage.dbPath: путь к базе данных Messages.
• channels.imessage.remoteHost: SSH-хост для передачи вложений по SCP, когда cliPath указывает на удалённый Mac (например, user@gateway-host). Автоопределяется из SSH-обёртки, если не задан.
• channels.imessage.service: imessage | sms | auto.
• channels.imessage.region: регион SMS.
• channels.imessage.dmPolicy: pairing | allowlist | open | disabled (по умолчанию: сопряжение).
• channels.imessage.allowFrom: allowlist для личных сообщений (handle, email, номера E.164 или chat_id:*). open требует "*". В iMessage нет имён пользователей; используйте handle или цели чатов.
• channels.imessage.groupPolicy: open | allowlist | disabled (по умолчанию: allowlist).
• channels.imessage.groupAllowFrom: allowlist отправителей для групп.
• channels.imessage.historyLimit / channels.imessage.accounts.*.historyLimit: максимальное число сообщений группы, включаемых в контекст (0 отключает).
• channels.imessage.dmHistoryLimit: лимит истории личных сообщений в пользовательских ходах. Переопределения для пользователей: channels.imessage.dms["<handle>"].historyLimit.
• channels.imessage.groups: значения по умолчанию для каждой группы + allowlist (используйте "*" для глобальных значений по умолчанию).
• channels.imessage.includeAttachments: загружать вложения в контекст.
• channels.imessage.mediaMaxMb: лимит медиа для входящих/исходящих (МБ).
• channels.imessage.textChunkLimit: размер исходящих чанков (символы).
• channels.imessage.chunkMode: length (по умолчанию) или newline для разбивки по пустым строкам (границы абзацев) перед разбивкой по длине.

• agents.list[].groupChat.mentionPatterns (или messages.groupChat.mentionPatterns).
• messages.responsePrefix.