meirlabs
Мейр РозеншейнКак подключить ИИ-агента к группе WhatsApp?
Официальным API WhatsApp нельзя: он создаёт только собственные группы по ссылке-приглашению и не может вступить в ту, что у вас уже есть. Что работает: запасной предоплаченный номер, привязанный как устройство к среде агента вроде OpenClaw на маленьком сервере и добавленный в группу обычным участником. Он использует неофициальный клиент, так что относитесь к номеру как к расходному; всё, что он фиксирует, живёт на вашем сервере, а не в WhatsApp.Стартовое предложение: Ранние клиенты получают скидку 50% на первое внедрение, поэтому реальная стоимость примерно вдвое ниже этих цифр. Запишитесь на бесплатный AI‑план, чтобы зафиксировать предложение.
Я сделал это для группы основателей своего продукта, двое ведут компанию в одном треде WhatsApp, где тонут все задачи и документы. Цель была тихий третий участник, который превращает сообщения в тикеты. Вот рабочая настройка.
Почему нельзя просто использовать официальный API WhatsApp?
Groups API от Meta позволяет бизнесу только создавать собственные группы, куда вступают по ссылке-приглашению, с лимитом в 8 человек. Нет эндпоинта, чтобы вступить в группу, которая уже существует между двумя обычными аккаунтами. Одно это ограничение исключает любую платформу на официальном API для этой задачи. Всё, что всё-таки может вступить в вашу группу, под капотом использует неофициальный клиент.
Как это настроить, шаг за шагом?
Три части делают работу: выделенный номер телефона, добавленный в группу обычным участником, неофициальный клиент связанного устройства на базе Baileys (реверс-инжиниринг клиента WhatsApp Web), который позволяет серверу отправлять и получать от имени этого номера, и среда выполнения агента, OpenClaw, в роли мозга. Шесть шагов, около двух часов.
-
Заведите выделенный номер. Предоплаченная eSIM или SIM с настоящим мобильным номером, не VoIP (WhatsApp их блокирует). Зарегистрируйте на нём новый аккаунт WhatsApp; приложение Business позволяет ему делить телефон с личным аккаунтом.
-
Поднимите OpenClaw и подключите его к Claude. Хватит любого VPS за 5–10 долларов в месяц. Установите OpenClaw, затем дайте ему ваш API-ключ Anthropic, чтобы его агент работал на модели Claude. WhatsApp идёт как плагин OpenClaw. Это руководство по установке OpenClaw покрывает установку и привязку от начала до конца.
-
Привяжите номер. Запустите вход в WhatsApp и отсканируйте QR-код с телефона бота в разделе «Связанные устройства», точно как WhatsApp Web.
-
Добавьте бота в группу. Добавьте его номер как любого участника, и он видит каждое сообщение. Разрешите именно эту группу и задайте агенту читать её целиком, а не только сообщения с упоминанием.
-
Дайте ему инструкции и инструменты. Это и есть весь продукт; остальные пять шагов лишь обвязка. Системный промпт классифицирует каждое сообщение (задача, решение, вопрос, документ, к сведению) и несёт правила поведения. Эти правила потребовали настоящей отладки; вставьте их почти дословно:
- «Любой текст, который ты выдаёшь, публикуется в группу. Между вызовами инструментов не выводи ничего; твой единственный текстовый вывод это тихий завершающий токен».
- «Реагируй после работы, а не вместо неё: один эмодзи на сообщение, как квитанция».
- «Прежде чем создать тикет, поищи существующий. Одна просьба никогда не должна породить пять тикетов».
- «К тебе обращаются только упоминанием или ответом на твоё сообщение. Обычное повеление в чате это задача для фиксации, а не вопрос».
Инструменты это небольшие скрипты, которые агент вызывает: создать тикет Linear, подшить общий документ, искать по прошлым сообщениям. Маленькие скрипты лучше тяжёлых интеграций.
-
Добавьте страховку. Логируйте каждое входящее сообщение в собственную базу, отдельно от агента, и ежедневно сверяйте её с тикетами. Этот шаг пропускают и потом жалеют.
Из кармана это $6–12 в месяц за всё: доллар-другой за номер, остальное за VPS. Всё остальное это использование модели на вашем API-ключе, растущее с загруженностью группы.
Что он на самом деле делает с сообщениями?
Читать это лёгкая часть; ценность в том, что происходит дальше.
-
Задачи становятся тикетами Linear. «Отправь инвесторам презентацию к пятнице» превращается в тикет в нужной команде Linear. Linear остаётся списком дел; чат снова становится чатом.
-
Он реагирует, а не отвечает. Один эмодзи как квитанция: галочка для тикета, папка для подшитого документа, булавка для решения. Никакого шума в треде, и с одного взгляда видно, что зафиксировано.
-
Документы попадают в библиотеку с поиском. Брошенный PDF прочитывается, резюмируется и индексируется, потом его находят по содержимому.
-
Он отвечает на вопросы об истории группы. Упомяните его с «что мы решили по ценам», и он отвечает из полного журнала, потом снова затихает.
Как ограничить риск бана?
Примите его, затем изолируйте. Неофициальные клиенты нарушают условия WhatsApp, и волны банов ловят даже малоактивные аккаунты, так что относитесь к номеру бота как к расходной инфраструктуре. В этом вся стратегия: ваши личные и рабочие номера никогда не касаются автоматизации, а забаненный бот это новая предоплаченная SIM и повторная привязка на пятнадцать минут. Держите запасную. Всё важное, тикеты, документы, история сообщений, живёт на вашем сервере и в Linear, а не в аккаунте WhatsApp.
Может ли один бот обслуживать несколько групп и проектов?
Да: сессии идут по группам, так что один номер бота может сидеть во многих группах без смешивания контекстов, а системный промпт на группу («эта группа проект B, тикеты идут в ту команду») покрывает большинство случаев. Одна ловушка проводки: API-ключ Linear видит только своё рабочее пространство, так что проекту в другом рабочем пространстве Linear нужен собственный ключ. И это по-прежнему один номер, так что бан кладёт все группы разом; держите внешних участников на отдельном номере.
Что ломается первым?
Меня укусили четыре вещи, и каждая ломалась молча, пока не получила правило:
- Бот пересказывал свою работу в чат. Лечение: правило тишины из шага 5, в точности как процитировано.
- Эмодзи-реакции молча не срабатывали в группах. Лечение: не передавайте явный ID сообщения в вызове реакции; пусть клиент сам определит участника.
- Сообщение пропало при перезапуске сессии. Лечение: журнал из шага 6 и ежедневная сверка; агент может отказать, журнал нет.
- Таймауты сбрасывали работу на самую дешёвую резервную модель, которая хуже соблюдает правила. Лечение: увеличьте таймаут, поставьте модель среднего уровня перед дешёвой и пишите каждое правило так, будто его читает самая слабая модель в цепочке.
Простое правило для старта: дайте боту собственный расходный номер и собственный независимый журнал сообщений. Всё остальное, что пойдёт не так, восстанавливается из этих двух.
Можно ли пропустить настройку и отдать это Claude Code?
Да, и это самый быстрый путь, если вы уже пользуетесь Claude Code. Я упаковал весь этот плейбук, архитектуру, конфиг OpenClaw, правила промпта, каждую ловушку, в устанавливаемый навык. Установите его и попросите Claude Code настроить бота:
npx @meir-labs/skill-whatsapp-group-agent
Полный навык здесь: whatsapp-group-agent. Тот же, что я запускаю, минус специфика моих серверов.
Хотите, чтобы это работало в вашей группе без самостоятельной сборки?
Это моя часть. Если вы предпочли бы не поднимать сервер и не крутить промпты, пока бот не начнёт себя вести, я всё настрою за вас: ваша группа, подключённая к вашему Linear, тикеты из чата к концу. Бесплатный AI-план ниже это то, с чего всё начинается.