Гайд по AI-секретарю в MAX
clawbot-max-guide
Набор упрощенных примеров на Python, из которых можно собрать личного AI-секретаря в мессенджере MAX через Bot API, User API и MCP
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- Использует неофициальный User API через вторую сим-карту, а не официальный Bot API
- Неправильное применение (рассылки, автоматизация от лица других людей) подпадает под 152-ФЗ, 38-ФЗ и ст. 159 УК, о чем README предупреждает явно
Установка
Ручная установка
pip install -r examples/requirements.txtЗависимости для примеров: httpx, msgpack.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Проект это не готовый сервер, а каркас из статьи о том, как собрать личного AI-секретаря для MAX: агент читает сообщения через вторую сим-карту (User API, не основной номер), классифицирует намерение, при необходимости вызывает MCP-сервер на 7 заглушках инструментов и ведет переписку от вашего имени до подтверждения, дублируя каждую реплику в служебный чат владельца. В комплекте семь примеров: long polling через Bot API, отправка через User API с обязательным полем cid, постоянный listener на TLS-сокете, классификатор намерений, каркас MCP-сервера, дублирование переписки владельцу через Bot API и структура allowlist для авто-ответов. Материал сопровождается отдельным файлом LEGAL.md с разбором, что можно и что нельзя по 152-ФЗ, 38-ФЗ и статье 159 УК.
Для кого. Для разработчиков, которые готовы сами довести примеры до рабочего кода и хотят личного бытового AI-секретаря в MAX на своем номере.
Подходит, если
- Нужен отправной пример, как читать и отправлять сообщения через неофициальный User API MAX
- Нужна личная бытовая автоматизация: бот бронирует столик или ведет переписку от вашего имени с подтверждением
- Нужен разбор правовых границ такой автоматизации по 152-ФЗ и 38-ФЗ перед тем, как что-то писать
Не подходит, если
- Нужен готовый рабочий сервер: mcp_server_stub.py это каркас на 7 заглушках, а не рабочий MCP-сервер, доводить до рабочего состояния нужно самому
- Планируете коммерческую рассылку, автообзвон или автоматизацию от лица других людей: README прямо называет это незаконным и вне сферы проекта
- Нужна production-система: автор явно предупреждает, что это не она
Пример запроса к агенту
Забронируй столик у указанного номера на завтра в 19:00 на двоихОграничения
Это не production-код: примеры упрощены и требуют доработки под свой стек, включая сам MCP-сервер, который в репозитории только заглушка на 7 тулов. Использует неофициальный User API MAX через вторую сим-карту, а не официальный протокол. Вызов LLM в примере listener это заглушка call_your_llm(), которую нужно подключить самому. README прямо описывает проект как использование на свой страх и риск.
Как отключить. Остановите скрипт user_api_listener.py и удалите файл токена ~/.config/clawbot-max/token.txt.
Проверка безопасности
- Использует неофициальный User API через вторую сим-карту, а не официальный Bot API
- Неправильное применение (рассылки, автоматизация от лица других людей) подпадает под 152-ФЗ, 38-ФЗ и ст. 159 УК, о чем README предупреждает явно
Коротко о README
README описывает архитектуру: два входа (MAX-бот и Telegram-бот) в один LLM-воркер, классификатор намерений и MCP-сервер, доступ к User API MAX через вторую сим-карту и persistent listener. Дан быстрый старт из шести шагов, таблица из семи файлов examples с указанием, какой части статьи на Хабре они соответствуют, список сторонних неофициальных реализаций протокола MAX и жирное предупреждение о правовых границах со ссылкой на LEGAL.md.
Частые вопросы
Можно ли использовать основной номер вместо второй сим-карты?
Автор прямо рекомендует только вторую сим-карту, не основной номер, и подчеркивает бытовой личный характер автоматизации.
MCP-сервер из примера рабочий?
Нет, examples/mcp_server_stub.py это каркас на 7 тулов, его нужно довести до рабочего состояния под свой стек.
Похожие
MCP-сервер со справкой по нодам и шаблонам n8n: агент подбирает ноды, проверяет конфигурацию и при наличии API создает воркфлоу в вашем n8n
Официальный плагин Zapier MCP: агент получает доступ к действиям в тысячах приложений через подключенный аккаунт Zapier
Awesome Claude Skills от Composio
Awesome Claude Skills
Каталог скиллов и плагинов для Claude и других агентов, плюс собственные скиллы автоматизации 78 SaaS-сервисов через Composio
Плагин и каталог CLI для агентов: генерирует командный интерфейс к GUI-программам вроде GIMP и Blender и ставит готовые через CLI-Hub