Перейти к основному содержанию

​
Удаление BlueBubbles и путь imsg для iMessage

OpenClaw больше не поставляет канал BlueBubbles. Поддержка iMessage теперь работает через встроенный plugin imessage, который запускает imsg локально или через SSH-обертку и обменивается JSON-RPC через stdin/stdout. Если ваша конфигурация все еще содержит channels.bluebubbles, перенесите ее в channels.imessage. Устаревший URL документации /channels/bluebubbles перенаправляет на Переход с BlueBubbles, где есть полная таблица переноса конфигурации и контрольный список перехода.

​
Что изменилось

  • В поддерживаемом пути OpenClaw для iMessage нет HTTP-сервера BlueBubbles, маршрута webhook, пароля REST или runtime plugin BlueBubbles.
  • OpenClaw читает и отслеживает сообщения через imsg на Mac, где выполнен вход в Messages.app.
  • Базовая отправка, получение, история и медиа используют обычные интерфейсы imsg и разрешения macOS.
  • Расширенные действия, такие как ответы в ветках, tapbacks, редактирование, отмена отправки, эффекты, уведомления о прочтении, индикаторы набора текста и управление группами, требуют imsg launch с доступным мостом private API.
  • Шлюзы Linux и Windows все еще могут использовать iMessage, задав channels.imessage.cliPath как SSH-обертку, которая запускает imsg на Mac с выполненным входом.

​
Что сделать

  1. Установите и проверьте imsg на Mac с Messages: 
    brew install steipete/tap/imsg
imsg --version
imsg chats --limit 3
imsg rpc --help
  2. Предоставьте разрешения Full Disk Access и Automation контексту процесса, который запускает imsg и OpenClaw.
  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. Протестируйте личные сообщения, группы, вложения и любые действия private API, от которых вы зависите, прежде чем удалять старый сервер BlueBubbles.

​
Примечания по миграции

  • У channels.bluebubbles.serverUrl и channels.bluebubbles.password нет эквивалента в iMessage.
  • У channels.bluebubbles.allowFrom, groupAllowFrom, groups, includeAttachments, корней вложений, ограничений размера медиа, разбиения на части и переключателей действий есть эквиваленты в iMessage.
  • channels.imessage.includeAttachments по умолчанию все еще отключен. Задайте его явно, если ожидаете, что входящие фотографии, голосовые заметки, видео или файлы будут доходить до агента.
  • С groupPolicy: "allowlist" скопируйте старый блок groups, включая любую wildcard-запись "*". Списки разрешенных отправителей групп и реестр групп являются отдельными проверками.
  • Привязки ACP, которые совпадали с channel: "bluebubbles", нужно изменить на channel: "imessage".
  • Старые ключи сеансов BlueBubbles не становятся ключами сеансов iMessage. Одобрения pairing переносятся по handle, но история разговоров под ключами сеансов BlueBubbles не переносится.

​
См. также