SkillFoxx
Telegram

Гайд по AI-секретарю в MAX

clawbot-max-guide

Набор упрощенных примеров на Python, из которых можно собрать личного AI-секретаря в мессенджере MAX через Bot API, User API и MCP

  • 2 ★ репозитория
  • Последний коммит
  • MIT
Воркфлоу

Широкий доступ

Почему такой уровень

  • Использует неофициальный User API через вторую сим-карту, а не официальный Bot API
  • Неправильное применение (рассылки, автоматизация от лица других людей) подпадает под 152-ФЗ, 38-ФЗ и ст. 159 УК, о чем README предупреждает явно
Все причины и проверки
Российский стек

sansmaster1982/clawbot-max-guideАвтор:sansmaster1982

Установка

Работает в
Сервисы

Ручная установка

pip install -r examples/requirements.txt

Зависимости для примеров: httpx, msgpack.

Доступ и проверки

Как мы проверяем

Широкий доступИнструмент может менять данные, выполнять команды или работать с секретами.

  • Использует неофициальный User API через вторую сим-карту, а не официальный Bot API
  • Неправильное применение (рассылки, автоматизация от лица других людей) подпадает под 152-ФЗ, 38-ФЗ и ст. 159 УК, о чем README предупреждает явно

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Проект это не готовый сервер, а каркас из статьи о том, как собрать личного 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.

Частые вопросы

Можно ли использовать основной номер вместо второй сим-карты?

Автор прямо рекомендует только вторую сим-карту, не основной номер, и подчеркивает бытовой личный характер автоматизации.

MCP-сервер из примера рабочий?

Нет, examples/mcp_server_stub.py это каркас на 7 тулов, его нужно довести до рабочего состояния под свой стек.

Обсуждение

Вопросов и отзывов пока нет.

MAX — все инструменты
Российский стек

MCP-сервер для Bot API мессенджера MAX: сообщения, медиа, чаты, участники и кнопки из агента

MCP-серверРасширенный доступ12
Российский стек

Канал-плагин, который подключает AI-ассистента OpenClaw к мессенджеру MAX через официальный Bot API: текст, медиа, кнопки, стриминг, мультиаккаунт

ПлагинРасширенный доступ

openclaw-skill-max-bot (MAX)

openclaw-skill-max-bot

Российский стек

Скилл OpenClaw подключает агента к мессенджеру MAX: Long Polling, расшифровка голосовых через Whisper, индикатор набора и публикация в каналы

СкиллРасширенный доступ
Российский стек

MCP-сервер для чтения сообщений бота в мессенджере Max: чаты, участники, поиск по тексту и скачивание вложений

MCP-серверРасширенный доступ1

Канал MAX для Claude Code

claude-max-messenger-plugin

Российский стек

Плагин-канал Claude Code для мессенджера MAX через Bot API: пишете боту, Claude отвечает из терминала, доступ по коду сопряжения

ПлагинШирокий доступ5
Российский стек

MCP-сервер для мессенджера MAX (бывший VK Teams): отправка и чтение сообщений, управление чатами, закреп и статус набора текста

MCP-серверШирокий доступ

Коротко о README

README описывает архитектуру: два входа (MAX-бот и Telegram-бот) в один LLM-воркер, классификатор намерений и MCP-сервер, доступ к User API MAX через вторую сим-карту и persistent listener. Дан быстрый старт из шести шагов, таблица из семи файлов examples с указанием, какой части статьи на Хабре они соответствуют, список сторонних неофициальных реализаций протокола MAX и жирное предупреждение о правовых границах со ссылкой на LEGAL.md.

Бейдж для README

Сообщить о проблеме