🦞
Интеграция канала

Подключение OpenClaw к iMessage

Используйте ИИ-ассистента напрямую через Apple Messages на macOS. Поддерживает как iMessage, так и SMS.

Только macOS

Интеграция iMessage требует macOS с настроенным приложением Сообщения. Она использует CLI-инструмент imsg для чтения из локальной базы данных Сообщений.

Почему iMessage?
  • +Нативная интеграция Apple — Работает с вашим существующим приложением Сообщения
  • +iMessage + SMS — Поддержка обоих протоколов без переключений
  • +Уведомления о прочтении — Знайте, когда сообщения доставлены и прочитаны
  • +Реакции — Поддержка реакций iMessage
  • +Групповые чаты — Участие в групповых разговорах
  • +Удалённый шлюз — Может работать через SSH к удалённому Mac
Требования
  • 1.
    macOS

    С настроенным приложением Сообщения и входом в Apple ID

  • 2.
    Разрешение полного доступа к диску

    Требуется для чтения OpenClaw из ~/Library/Messages/chat.db

  • 3.
    imsg CLI

    Инструмент командной строки для взаимодействия с Сообщениями

Шаги настройки

1

Установите imsg CLI

Установите инструмент командной строки imsg, который OpenClaw использует для взаимодействия с Сообщениями:

brew install imsg

Или скачайте со страницы релизов imsg на GitHub

2

Предоставьте полный доступ к диску

OpenClaw нужно разрешение на чтение базы данных Сообщений:

  • - Откройте Системные настройки (или System Preferences)
  • - Перейдите в Конфиденциальность и безопасность > Полный доступ к диску
  • - Нажмите кнопку + и добавьте Терминал (или iTerm)
  • - Также добавьте исполняемый файл OpenClaw, если запускаете как бинарник
3

Настройте OpenClaw

Добавьте конфигурацию iMessage в ваш файл openclaw.json:

{
  "channels": {
    "imessage": {
      "enabled": true,
      "cliPath": "imsg",
      "dbPath": "~/Library/Messages/chat.db",
      "allowFrom": ["+15555550123", "user@example.com"]
    }
  }
}
4

Настройте allowFrom

Укажите, кто может взаимодействовать с вашим ботом:

  • - Номера телефонов с кодом страны: +15555550123
  • - Apple ID (email-адреса): user@example.com
5

Проверьте подключение

Убедитесь, что канал iMessage работает:

openclaw channels status imessage

Затем отправьте сообщение с разрешённого контакта для проверки интеграции.

Расширенная конфигурация

Полные параметры конфигурации для канала iMessage:

{
  "channels": {
    "imessage": {
      "enabled": true,
      "cliPath": "imsg",
      "dbPath": "~/Library/Messages/chat.db",
      "remoteHost": "user@gateway-host",
      "dmPolicy": "pairing",
      "allowFrom": ["+15555550123", "user@example.com"],
      "historyLimit": 50,
      "includeAttachments": false,
      "mediaMaxMb": 16,
      "service": "auto",
      "region": "US"
    }
  }
}
  • cliPath — Путь к исполняемому файлу imsg CLI
  • dbPath — Путь к базе данных Сообщений
  • remoteHost — SSH-хост для настройки удалённого шлюза
  • dmPolicy — Как обрабатывать личные сообщения
  • allowFrom — Номера телефонов или Apple ID, которым разрешено писать
  • historyLimit — Количество сообщений для контекста
  • includeAttachments — Включить обработку вложений
  • mediaMaxMb — Максимальный размер вложений в МБ
  • service — Принудительно iMessage или SMS, или авто
  • region — Регион для форматирования номеров телефонов
Настройка удалённого шлюза (опционально)

Если вы хотите запустить OpenClaw на сервере, но получать доступ к iMessage с Mac дома, можно использовать SSH:

{
  "channels": {
    "imessage": {
      "enabled": true,
      "remoteHost": "user@your-mac.local",
      "cliPath": "/usr/local/bin/imsg"
    }
  }
}
  • - Убедитесь, что настроена аутентификация по SSH-ключу
  • - Mac должен быть всегда включён и подключён к сети
  • - imsg и полный доступ к диску должны быть настроены на Mac
Поддерживаемые функции
ОКУведомления о прочтении
ОКРеакции iMessage
ОКГрупповые чаты
ОКПоддержка SMS
ОПЦВложения (опционально)
ОКИстория сообщений
Устранение неполадок

Отказ в доступе при чтении chat.db?

Убедитесь, что вы предоставили полный доступ к диску для Терминала/iTerm и исполняемого файла OpenClaw. Возможно, потребуется перезапустить терминал после предоставления доступа.

Бот не отвечает на сообщения?

Проверьте, что номер телефона или Apple ID в allowFrom указан точно. Номера телефонов должны содержать + и код страны.

Не удаётся найти chat.db?

Путь по умолчанию — ~/Library/Messages/chat.db. Убедитесь, что приложение Сообщения было открыто хотя бы раз и вы вошли в систему.

Команда imsg не найдена?

Убедитесь, что imsg установлен и находится в PATH. Вы можете указать полный путь в cliPath.

Удалённый шлюз не подключается?

Проверьте, что аутентификация по SSH-ключу работает с ssh user@host и что на удалённом Mac установлен imsg с полным доступом к диску.

iMessage подключён!

Добавьте другие каналы или настройте навыки для персонализации ИИ-ассистента.

Добавить WhatsAppИзучить навыки