Как подключить HappyCapy к iMessage: полноценный AI-агент в Apple Messages

Apple никогда не выпускала API для iMessage. Ни в 2015 году. Ни в 2020 году. Ни сегодня. Годами создание AI-агента, живущего в ваших iMessage, требовало либо джейлбрейка, либо корпоративного плана за $200/месяц, либо глубокого понимания недокументированных протоколов. В июне 2026 года наконец появился бесплатный путь с открытым исходным кодом, который работает надёжно — и это та же архитектура, которую использует в продакшене проект Hermes Agent с 188 000 звёзд.

---

Почему iMessage — самая сложная платформа (и почему это важно)

У большинства мессенджеров есть API. Telegram опубликовал свой в 2015 году. У Slack вебхуки были с самого первого дня. WhatsApp открыл свой Business API в 2018 году. У iMessage нет ничего из этого, и это не упущение.

Протокол iMessage от Apple использует сквозное шифрование, привязанное непосредственно к Apple ID и ключам, специфичным для устройства. Эти ключи генерируются на аппаратном обеспечении Apple и никогда его не покидают. Каждое сообщение шифруется и расшифровывается на физическом устройстве Apple. Серверного API не существует, потому что нет сервера, который хранил бы расшифрованный контент. Это жёсткое криптографическое ограничение — а не политическое решение, которое Apple могла бы отменить пресс-релизом.

Практическое следствие: ни один Linux-процесс, ни один Docker-контейнер, ни одна облачная VM не может нативно отправлять или получать iMessages. Ни с root-доступом. Ни с действующим Apple ID. Протокол просто не работает за пределами аппаратного обеспечения Apple.

Для разработчиков AI-агентов это значит, что интеграция с iMessage всегда требует Mac в цепочке. Это честный ответ, и он определяет всё остальное в этой статье.

Обратная сторона также верна: для пользователей Apple эта архитектура означает, что бот живёт внутри самого Messages.app. Не нужно устанавливать сторонние приложения. Не нужно создавать новый аккаунт. AI отвечает через тот же интерфейс, который уже используют ваши семья и коллеги. Когда ваши контакты пишут вам, они не замечают, что что-то изменилось — они видят ответы от вашего Apple ID, оформленные как обычные iMessages, с отметками о прочтении.

Именно эта комбинация — нулевое трение для получателя, криптографическая приватность, платформа, которой пользователи Apple уже доверяют — делает iMessage достойным дополнительной сложности.

---

Как это на самом деле работает

Бесплатное решение с открытым исходным кодом — это BlueBubbles. Это Mac-серверное приложение под лицензией MIT, которое работает на вашем Mac, регистрируется с вашим Apple ID и предоставляет локальный REST API. BlueBubbles действует как мост между протоколом iMessage (который требует macOS) и любым внешним сервисом, способным делать HTTP-запросы.

capy-bridge от HappyCapy подключается к этому REST API. Когда сообщение приходит на ваш Apple ID, происходит следующая последовательность:

Это та же архитектура, которую использует Hermes Agent. Проект Hermes Agent — 188 000 звёзд на GitHub, созданный Nous Research — маршрутизирует свою интеграцию с iMessage через BlueBubbles в своей продакшн-конфигурации. Архитектура прошла стресс-тестирование в масштабе.

Ключевая деталь в шаге 5 — это claude --print. HappyCapy не отправляет ваше сообщение чат-боту, который отвечает текстом. Он запускает Claude Code CLI, который имеет полный доступ к инструментам: выполнение bash, чтение/запись файлов, веб-поиск, генерация изображений и доступ к библиотеке из более чем 300 000 Skills от HappyCapy. Бот не просто отвечает — он действует.

---

Что вы можете делать

Как только bridge запущен, каждое iMessage на ваш Apple ID становится интерфейсом команд для вашего HappyCapy sandbox:

• Удалённое выполнение задач — отправьте задачу с iPhone, получите обратно полностью выполненный результат с выводом
• Запрос файлов — попросите PDF-отчёт, сгенерированное изображение или скрипт — и получите его
• Поиск и суммаризация — попросите агента поискать в интернете и вернуть структурированную сводку
• Запуск более 300 000 Skills — каждый Skill в библиотеке HappyCapy доступен из Messages.app
• Запуск bash на вашем sandbox — run ls /var/log выполняется в вашей Linux-среде HappyCapy и возвращает вывод
• История по каждому контакту — каждый Apple ID или номер телефона получает свою собственную ветку переписки; контекст сохраняется между сообщениями
• Работает с любого устройства Apple — iPhone, iPad, Mac, Apple Watch — всё, что отправляет iMessages, достигает бота

---

Плюсы

• Нативный опыт Apple — ответы появляются в стандартной ветке Messages.app; получателям ничего не нужно устанавливать
• Никакого стороннего приложения на устройстве получателя — бот общается через существующую инфраструктуру iMessage
• Работает с любым Apple ID — любой контакт, который может отправить вам iMessage, может взаимодействовать с ботом
• Сквозное шифрование — BlueBubbles не нарушает шифрование Apple; он считывает сообщения после их расшифровки на вашем Mac
• Бесплатно и с открытым исходным кодом — BlueBubbles под лицензией MIT; никаких подписок
• Архитектура, проверенная Hermes — тот же стек, что питает продакшн-проект агента с 188 000 звёзд
• Полноценные возможности агента — claude --print даёт боту доступ к bash, веб-поиску, файловым операциям и более чем 300 000 Skills

---

Реальные сценарии использования

Разработчик на iPhone. Вы далеко от ноутбука и вам нужно проверить, выполнилась ли cron-задача, просмотреть лог-файл или перезапустить сервис на вашем HappyCapy sandbox. Вы отправляете команду из Messages.app на iPhone. Bridge выполняет её и возвращает вывод в ответе. Никакого SSH-клиента, никакого VPN, никакого переключения контекста.

Семья только с устройствами Apple. Ваш партнёр, родители или соседи по квартире используют только iMessages и ничего больше. Вместо того чтобы просить их установить Telegram или изучить новый интерфейс, вы направляете бота на свой существующий Apple ID. Все взаимодействуют через приложение, которое уже есть на их устройствах.

Владелец бизнеса с клиентами в iMessage. Вы общаетесь с клиентами через iMessage — это то, что они используют, и переводить их на другую платформу нереалистично. С запущенным bridge вы можете попросить агента подытожить длинную переписку, составить ответ в вашем стиле, найти историю заказов клиента или получить отчёт. AI остаётся в том канале, где уже строятся отношения.

Исследователь с Mac. У вас работает Mac на столе. Вам нужен AI-агент, который всегда доступен — с iPhone во время поездки, с iPad на встрече, с Mac коллеги в экстренной ситуации. iMessage уже синхронизирован на всех ваших устройствах Apple. Бот автоматически наследует этот охват.

---

Требование к Mac — честная оценка

Настройка требует Mac с установленным и запущенным BlueBubbles, подключённым к HappyCapy через capy-bridge. Mac должен быть в активном состоянии и онлайн, чтобы bridge работал. Если он засыпает, бот уходит в офлайн.

Это реальное ограничение. Если у вас нет Mac, или ваш Mac — это ноутбук, который вы носите с собой и регулярно закрываете, iMessage — неправильный канал для вас. Интеграции HappyCapy с Telegram и Slack работают на полностью нативной Linux-инфраструктуре без зависимости от аппаратного обеспечения.

Для тех, кто уже держит включённый Mac — Mac Mini под телевизором, Mac Studio в домашнем офисе, старый MacBook, подключённый к сети на полке — настройка одноразовая, а дальше всё работает полностью автоматически. BlueBubbles запускается при входе в систему. Демон capy-bridge запускается при входе в систему. Mac продолжает работать, и бот тоже.

Если вы рассматриваете покупку специального оборудования для этой цели, базовая модель Mac Mini M4 2026 года ($799) — самый практичный вариант. Он потребляет около 6–10 ватт в режиме простоя, поддерживает работу 24/7 без шума вентилятора и помещается в пространство меньше размера книги в мягком переплёте. Полный обзор настройки Mac Mini как AI-сервера см. в статье Mac Mini as an AI Server in 2026.

---

Как настроить

Полная настройка занимает примерно 10 минут:

1. Скачайте BlueBubbles на bluebubbles.app — бесплатно, лицензия MIT, открытый исходный код
2. Запустите мастер настройки — войдите со своим Apple ID и предоставьте разрешения Accessibility + Full Disk Access
3. Запишите URL и пароль BlueBubbles с экрана настроек BlueBubbles
4. Установите capy-bridge — выполните bash /app/export-port.sh 8766 в HappyCapy, чтобы получить URL вебхука, затем запустите skill /happycapy-imessage в HappyCapy
5. Завершите мастер HappyCapy — вставьте URL BlueBubbles, пароль и URL вебхука; bridge зарегистрируется автоматически
6. Проверьте — отправьте iMessage с другого устройства; вы должны получить ответ в течение нескольких секунд

Полная документация по skill и исходный код находятся на github.com/ndpvt-web/happycapy-imessage.

---

Часто задаваемые вопросы

Нужно ли держать мой Mac включённым всё время? Да, для доступности 24/7. Mac должен быть в активном состоянии и онлайн, чтобы BlueBubbles и capy-bridge могли получать входящие сообщения. Если вы хотите, чтобы бот был доступен круглосуточно, используйте оборудование, которое может оставаться включённым — Mac Mini или Mac Studio идеально подходят. Включите «Prevent display sleep» в настройках BlueBubbles и отключите режим сна в macOS Energy Saver (режим Power Adapter).

Работает ли это также с SMS, или только с iMessage? BlueBubbles поддерживает как iMessage (синие пузыри), так и SMS (зелёные пузыри), если к вашему Mac подключён iPhone и настроен Personal Hotspot для пересылки SMS. Для большинства настроек iMessage-only проще и надёжнее.

Может ли Apple видеть мои сообщения через BlueBubbles? Нет. BlueBubbles не нарушает сквозное шифрование Apple. Сообщения расшифровываются macOS на вашем локальном устройстве, как это всегда происходит, а затем BlueBubbles считывает их из этого локального расшифрованного состояния. Серверы Apple никогда не видят содержимое в открытом виде — точно так же, как при обычном использовании Messages.app.

BlueBubbles бесплатный? Да. BlueBubbles под лицензией MIT и бесплатен для использования. Никаких подписок. Серверное приложение для Mac, исходный код и документация — всё это публично доступно на bluebubbles.app.

Что произойдёт, если мой Mac уснёт? Bridge уходит в офлайн. Сообщения, отправленные во время сна Mac, не обрабатываются и не получают ответа после пробуждения Mac. Чтобы избежать этого: включите «Prevent display sleep» в BlueBubbles, отключите системный сон в macOS Energy Saver для режима Power Adapter, или запустите caffeinate -di & в терминале. Для настроек с постоянной работой настольные Mac (Mini, Studio, Pro) предпочтительнее ноутбуков.

Могут ли несколько человек писать боту с разных Apple ID? Да. Bridge хранит отдельную историю переписки для каждого handle отправителя. Каждый Apple ID или номер телефона получает своё собственное контекстное окно. Вы можете настроить allowlist (только определённые handles) или оставить открытым для всех входящих iMessages.

Не нарушает ли это условия использования Apple? BlueBubbles — это серая зона: Apple не давала явного одобрения сторонним мостам для iMessage, но и не принимала никаких мер против BlueBubbles за более чем четыре года его существования. Проект считывает сообщения с вашего собственного Mac, под вашим собственным Apple ID, точно так же, как это мог бы сделать любой процесс с доступом Full Disk Access. Использование его для собственной автоматизации — а не для коммерческой массовой рассылки или спама — соответствует тому, как его используют десятки тысяч разработчиков. Проект Hermes Agent поставляет интеграцию с BlueBubbles в своей конфигурации по умолчанию начиная с 2026 года.

---

Заключительные мысли

Из четырёх каналов обмена сообщениями, которые поддерживает HappyCapy — Telegram, Slack, WhatsApp и iMessage — iMessage технически самый сложный в настройке. Он требует Mac, запущенного сервера BlueBubbles и постоянного соединения между вашим оборудованием и вашим HappyCapy sandbox. Это больше движущихся частей, чем у остальных.

Для пользователей Apple, которые уже живут в этой экосистеме, это также самый бесшовный результат: полноценный AI-агент, который отвечает через приложение Messages, которым ваши контакты пользуются каждый день, без новых приложений для установки и новых аккаунтов для создания. Архитектура проверена — тот же стек, который стоит за 188 000 звёзд у Hermes Agent — и HappyCapy оборачивает её в skill, работающий в один клик.

Если у вас есть Mac, который остаётся включённым, эта настройка стоит потраченных 10 минут.