WhatsApp — это место, где происходят разговоры. Не Slack, не Discord, не Telegram — для большей части мира WhatsApp является мессенджером по умолчанию. Два миллиарда активных пользователей в месяц, доминирование в Европе, Латинской Америке, Южной Азии и Африке. Если вы хотите AI-ассистента, который действительно станет частью вашей повседневной жизни, он должен быть там, где уже идут ваши повседневные разговоры.
Проблема в том, что WhatsApp не предлагает бот-API для частных лиц. WhatsApp Business API существует, но требует бизнес-аккаунта, одобрения Meta и модели оплаты за сообщение, рассчитанной на клиентский сервис, а не на персональных ассистентов. Для разработчика, который хочет персонального AI-бота в своём WhatsApp — такого, который отвечает в групповых чатах, помнит контекст и работает на его собственном оборудовании — официальный путь ведёт в тупик.
NanoClaw решает это с помощью Baileys — open-source библиотеки WhatsApp Web, которая подключается к серверам WhatsApp так же, как веб-клиент WhatsApp. Вы сканируете QR-код, соединение устанавливается, и NanoClaw может отправлять и получать сообщения от имени вашего аккаунта WhatsApp. Без Business API, без одобрения Meta, без платы за сообщение.
Архитектура: почему WhatsApp особенный
Интеграция NanoClaw с WhatsApp — это не просто мост для сообщений, а основной канал, вокруг которого спроектирована вся архитектура. В то время как другие каналы (Telegram, Discord, Slack) добавляются через Claude Code Skills, WhatsApp встроен в ядро. Это не фаворитизм — это отражение того, как групповая модель WhatsApp естественно соответствует модели безопасности NanoClaw.
Группы WhatsApp — это граница изоляции. Каждая группа получает свой контейнер, свой файл памяти CLAUDE.md и своё записываемое рабочее пространство. Когда кто-то отправляет сообщение в семейную группу, агент, который отвечает, имеет доступ только к истории и памяти этой группы. Он не может видеть сообщения из вашей рабочей группы, не может получить доступ к истории личных чатов и не может читать файлы, принадлежащие другим группам. Изоляция обеспечивается монтированиями контейнера, а не логикой приложения.
Эта изоляция по группам делает NanoClaw безопасным для того, как люди реально используют WhatsApp. Ваша семейная группа обсуждает личные дела. Ваша рабочая группа обсуждает проприетарные проекты. Ваша группа друзей делится тем, чем не стала бы делиться публично. Каждый из этих контекстов должен быть отделён, и NanoClaw это гарантирует — не через списки контроля доступа, в которых могут быть баги, а через физическое разделение контейнеров, которое невозможно обойти эксплойтами уровня приложения.
Настройка
Процесс настройки занимает около десяти минут, большая часть которых — ожидание npm install.
Клонируйте репозиторий и установите зависимости:
```bash git clone https://github.com/qwibitai/NanoClaw.git cd NanoClaw npm install ```
Настройте окружение. Минимальная конфигурация — только API-ключ Anthropic:
```bash echo 'ANTHROPIC_API_KEY=sk-ant-your-key-here' > .env ```
Запустите привязку WhatsApp:
```bash npm run auth ```
Это отобразит QR-код в терминале. Откройте WhatsApp на телефоне, перейдите в «Связанные устройства» и отсканируйте код. Соединение установлено, и NanoClaw теперь слушает сообщения.
Запустите агента:
```bash npm start ```
Вот и всё. Отправьте сообщение в любую группу WhatsApp, где хотите активировать бота, упомяните имя ассистента (настраивается через ASSISTANT_NAME в .env), и он ответит. Первый ответ занимает несколько секунд, пока контейнер запускается; последующие сообщения в той же сессии быстрее, потому что контейнер остаётся «тёплым».
Как проходят сообщения
Понимание потока сообщений помогает объяснить, почему NanoClaw ощущается отзывчивым несмотря на накладные расходы контейнеров. Когда сообщение приходит в WhatsApp, хост-процесс — ядро NanoClaw на ~500 строках TypeScript — получает его через Baileys. Он проверяет, адресовано ли сообщение ассистенту (по упоминанию имени или в личном сообщении). Если да, хост проверяет состояние контейнера группы.
Если контейнер для этой группы уже запущен (от недавнего разговора), сообщение направляется в него через IPC. Агент внутри контейнера получает сообщение, обрабатывает его с помощью Claude Agent SDK и отправляет ответ обратно через IPC. Хост пересылает ответ в WhatsApp. Общая добавленная задержка: несколько миллисекунд на IPC плюс время ответа Claude API.
Если контейнер не запущен, хост создаёт новый. На macOS с Apple Container это занимает 200–400 мс. На Linux с Docker — 1–2 секунды. Контейнер получает файл памяти CLAUDE.md группы, историю разговоров из SQLite и API-ключ через stdin. Он обрабатывает сообщение и отвечает. Контейнер остаётся активным на настраиваемый таймаут (по умолчанию: 30 минут) для обработки последующих сообщений без накладных расходов на запуск.
В результате большинство сообщений — те, что приходят во время активного разговора — ощущаются мгновенными. Время ответа AI определяется задержкой Claude API, а не инфраструктурой NanoClaw. Только первое сообщение после долгого молчания имеет накладные расходы на запуск контейнера, и даже они достаточно малы, чтобы пользователи редко это замечали.
Память по группам: функция, которая делает его полезным
Файл CLAUDE.md для каждой группы — это то, что превращает stateless чат-бота в по-настоящему полезного ассистента. Файл памяти каждой группы накапливает контекст со временем — предпочтения, текущие проекты, повторяющиеся темы, внутренние шутки. Агент читает этот файл в начале каждого хода разговора, а значит, помнит то, что вы сказали ему на прошлой неделе, без необходимости повторять.
В семейной группе память может содержать диетические предпочтения, школьное расписание и регулярные мероприятия. В рабочей группе — дедлайны проектов, предпочтения команды и технические решения. В группе друзей — планы поездок, рекомендации ресторанов и общие интересы.
Память редактируема. Вы можете попросить агента запомнить что-то конкретное («запомни, что у мамы аллергия на моллюсков») или забыть что-то («забудь то, что я сказал о сюрпризе»). Вы также можете редактировать файл CLAUDE.md напрямую — это обычный текстовый файл в вашей файловой системе, не запертый внутри базы данных.
Реальность приватности
Запуск AI-бота для WhatsApp поднимает обоснованные вопросы приватности, и стоит быть прямым. Сообщения, которые обрабатывает NanoClaw, отправляются в Anthropic API для генерации ответов Claude. Это означает, что ваши сообщения WhatsApp — или, по крайней мере, те, что адресованы ассистенту — покидают ваше устройство и обрабатываются серверами Anthropic.
NanoClaw смягчает это несколькими способами. Только сообщения, явно адресованные ассистенту, отправляются в API — бот не обрабатывает и не хранит сообщения, которые ему не адресованы. История разговоров в SQLite остаётся на вашей машине. Файлы памяти CLAUDE.md остаются на вашей машине. А если вы настроите NanoClaw на использование Ollama вместо Anthropic, обработка AI происходит локально — ничего не покидает вашу сеть.
Для большинства пользователей практическая позиция по приватности такова: ваши сообщения WhatsApp остаются на вашем устройстве, за исключением случаев, когда вы явно задаёте вопрос AI-ассистенту — тогда это конкретное сообщение отправляется в Anthropic (или обрабатывается локально с Ollama). Это существенно лучшая история приватности, чем у облачных AI-сервисов, которые обрабатывают и хранят всё, что вы вводите.
WhatsApp — это место, где происходит ваша жизнь. NanoClaw помещает туда AI-ассистента — с изоляцией, памятью и моделью приватности, которые делают его безопасным для использования в группах, где вы обсуждаете действительно важные вещи.