Группы, которые вы ведёте
This page is in Russian.
max помогает админу группы: показывает вопросы, на которые никто не ответил, кто вступил и с
каким аккаунтом, и убирает спам по вашим правилам. По умолчанию он только отмечает — удалить
сообщение или человека он может, только если вы это разрешили.
Всё здесь работает от вашего личного аккаунта и там, где вы админ. Команды подробно — usage.md, каждая опция — commands.md.
Сценарии с агентом
Агенту с терминалом (Claude Code, Codex) нужен навык; агенту без терминала (Claude Desktop, Cursor) — MCP-сервер. Ниже — что вы говорите, что агент вызывает и что вы получаете.
Утро админа: кто ждёт ответа
Вы: Что в «Поход» осталось без ответа?
Агент: (max review --chat "Поход" --unanswered 4 --json)
Без ответа больше 4 часов — 3 вопроса:
· Лена, 08:12 — «Во сколько выезд в субботу?»
· Артём, вчера 22:40 — ответ на ваш пост про маршрут: «А палатки общие?»
· Ира, вчера 19:05 — «Кто везёт котелок?»
На остальные ответили вы или админы.Вопрос — это сообщение со знаком «?» или ответ на ваше сообщение или сообщение админа. Отвеченным он считается, если вы или админ ответили на него или заговорили первыми после того, кто спросил. Ссылка со знаком «?» внутри вопросом не считается.
Новенькие за неделю
Вы: Кто вступил в «Поход» за неделю? Есть подозрительные?
Агент: (max chats events "Поход" --event add --json, max chats members list "Поход" --json)
За неделю добавили 4 человек:
· Катя Смирнова — добавила Лена, аккаунту 3 года
· Олег — вступил сам, аккаунту 2 дня
· …
Стоит посмотреть: Олег — аккаунт совсем новый.Уборка спама с вашим подтверждением
Один раз настройте правила:
max chats rules set "Поход" invites delete # приглашения в чужие чаты — удалять
max chats rules set "Поход" newAccount.days 3 # аккаунт моложе трёх дней — отмечать
max chats rules set "Поход" consent.delete confirm # но перед удалением — спросить меняВы: Проверь «Поход».
Агент: (max_chats_check)
— форма: «delete message … from Олег for everyone (invites)?» —
Вы: Да.
Агент: Удалено одно сообщение с приглашением от Олега. Олег отмечен: аккаунту 2 дня.
Остальное в порядке.В терминале max chats check "Поход" задаёт тот же вопрос сам: [y/N].
Недельный отчёт по группе
Вы: Сделай итог недели по «Поход».
Агент: (max review --chat "Поход" --since 2026-09-20T00:00 --json)
Решили: выезд 4 октября, в 7:00 от метро.
Взяли на себя: Лена — продукты, Артём — палатки.
Висит: кто везёт котелок — спросили трижды, ответа нет.Проверка по расписанию
Агент не нужен: проверка — обычная команда. Два раза в день, с удалением там, где правило стоит на
уровне flag:
0 9,21 * * * max chats check "Поход" --allow-dangerous >> ~/max-check.log 2>&1В cron нет терминала, поэтому действия на уровне confirm только планируются и ждут вас. Строки
PATH и XDG_RUNTIME_DIR, без которых max в cron не найдёт Node и ваш вход, —
recipes.md.
Что можно
| Команда | Что делает |
|---|---|
max review --chat <чат> --unanswered [часы] | вопросы, на которые вы и админы не ответили за столько часов (по умолчанию 24) |
max chats events <чат> | кто вступил, вышел, кого добавили и удалили, кем; по умолчанию за 7 дней |
max chats members list <чат> | все участники от MAX: кто владелец и админы (сразу после admins add роль может быть прежней), когда заведён аккаунт, когда был в сети |
max chats rules show|set|unset <чат> | правила группы |
max chats check <чат> | проверка по правилам; делает то, что правила разрешают |
max chats members add|remove, admins add|remove | участники и админы |
max chats link show|reset <чат> | ссылка-приглашение; reset — новая, старая перестаёт работать |
max chats update | настройки, название, описание; прочитать настройки — max chats show |
max messages delete --for-everyone, pin, unpin | удалить у всех, закрепить |
Агенту без терминала то же самое дают инструменты MCP: max_review с unanswered_after_hours,
max_chats_events, max_chats_members, max_chats_rules и max_chats_check
(mcp.md).
Правила
Правила хранятся на вашем компьютере, у каждой группы свои. Первое set записывает все правила
сразу, со значениями по умолчанию.
| Правило | По умолчанию | Что значит |
|---|---|---|
trusted | — | номера людей через запятую; правила их не трогают |
blocked | — | номера людей, чьи сообщения и вступление ловятся |
blockedNames | — | части имени, через запятую, без учёта регистра |
blockedPeople | report | что делать с сообщением или вступлением заблокированного |
invites | report | приглашение в другой чат (max.ru/join/…) |
links | report | любая ссылка |
forwards | report | пересланное сообщение |
flood.messages, flood.minutes, flood.action | 5, 1, report | больше 5 сообщений за минуту от одного человека |
newAccount.days, newAccount.action | 7, report | аккаунт моложе 7 дней; 0 выключает |
consent.delete, consent.remove | flag | насколько вы разрешаете каждое действие |
Действие правила — report (отметить), delete (удалить сообщение у всех) или remove (удалить
человека из группы). Если сообщение нарушает несколько правил, берётся самое сильное действие.
Вас, админов и людей из trusted правила не трогают.
Уровень согласия решает, будет ли действие сделано:
forbid— никогда;flag— только если запуск с--allow-dangerous(а у MCP-сервера — с--allow-moderate);confirm— спросить вас: в терминале вопросом, в MCP — формой; без вас действие ждёт;allow— сразу.
Через бота
Если в группе есть ваш бот с правами админа, ту же проверку может делать он: max <бот> bot chats check. Он умеет то, чего не умеет личный аккаунт, — банить удалённых, чтобы они не вернулись по
ссылке. Возраст аккаунта ему недоступен. Подробно — bot.md.
Ограничения
- Бана нет. Удалённый человек может вернуться по ссылке-приглашению: личный аккаунт не умеет
банить. Замените ссылку (
max chats link reset) или проверяйте группу ботом — он банит. - Заявок на вступление нет. В MAX группа либо открытая, либо в неё входят по ссылке-приглашению; одобрять новых участников нельзя.
- Не больше 10 действий за проверку (
--max-actions). Удаления считаются в лимит отправок в час; упёрлась в лимит — остальное ждёт следующей проверки. - До 2000 сообщений за проверку. Если их больше, следующая проверка продолжит с того места.
- Одно вступление — весь список участников. Чтобы узнать возраст аккаунта новенького, проверка читает список участников целиком; в большой группе это десятки запросов к MAX.
- Ничего не следит за группой само. Проверка идёт, только когда её запустили вы, агент по вашей просьбе или ваше расписание.