Telegram: Администрирование
Telegram: Участники, права администратора, настройки группы и проверка спама.
Посмотрите состав, настройки и состояние своей группы, затем выберите действие администратора. Здесь можно проверить права, найти вопросы и подозрительные аккаунты, подготовить изменения. Начните с отчёта; изменение настроек или удаление участников требует отдельного решения.
Проверить группу и свои права
Используй tg CLI. В группе «Клуб» покажи описание, участников, администраторов и мои права. Какие настройки я могу менять? Ничего не меняй.Вы получите карточку группы и список доступных действий. Участие в группе не всегда даёт права администратора; агент должен проверить их до изменений.
Подготовить план наведения порядка
Используй tg CLI. Проверь группу «Клуб»: вопросы без ответа, новые участники и признаки спама. Предложи, кому помочь и какие сообщения проверить. Не удаляй сообщения, не блокируй людей и не меняй настройки.Получите план с конкретными сообщениями и причинами. Затем можно выбрать отдельное действие: ответить, проверить аккаунт, изменить описание или правила доступа. Команды управления приведены ниже.
Команды и инструкции
Используйте эту страницу, если вы являетесь администратором группы Telegram и вам нужна помощь в поддержании порядка. Вы научитесь находить вопросы, на которые никто не ответил, видеть, кто присоединился и кто их добавил, подводить итоги недели, удалять спам по своим правилам и вести историю списка участников. Чтение не отмечает сообщения прочитанными, поэтому проверка группы не сообщает ее членам, что вы ее просматривали.
Здесь все работает из личного аккаунта, в группах, где вы являетесь администратором. Несколько слов на этой странице:
- Администратор – это участник с правами управления группой. Некоторые команды учитывают только ваши ответы и ответы администраторов.
- Локальное хранилище — это копии сообщений, которые
tgхранит на этом компьютере. Отчеты и задачи используют его, поэтому видят только то, что было скачано. - Задача — то, что ждёт вашего действия, например вопрос, на который никто не ответил.
tgоткрывает и закрывает задачи в локальном хранилище. - Правила определяют, что ищет
tg personal chats moderate, например ссылки или флуд, и что он может делать. - Снимок состава — это список участников, сохраненный за один день. Снимки с течением времени показывают, кто присоединился, а кто ушел.
Что можно сделать
| Задача | Команда |
|---|---|
| Найдите вопросы, которые ждут ответа | tg personal review --unanswered |
| Посмотрите, кто присоединился, вышел, был добавлен или удален | tg personal chats events |
| Итоги недели: решения, обещания, открытые вопросы | tg personal review 'date>7d' |
| Держите список того, что вас ждет | tg personal tasks list |
| Удалить спам по своим правилам | tg personal chats rules set, tg personal chats moderate |
| Заменить утекшую ссылку-приглашение | tg personal chats links reset |
| Одобряйте или отклоняйте запросы на вступление | tg personal chats requests list|confirm|reject |
| Посмотрите активность за неделю и собственную статистику Telegram | tg personal stats chats show, tg personal stats chats official |
| Сохраняйте список участников каждый день | tg personal chats members fetch --track |
| Найдите участников, похожих на ботов или спамеров | tg personal chats members check |
Полный список групповых команд находится ниже. Подробности о каждой команде приведены в группах и каналах в руководстве по использованию; каждая опция находится в справке по командам.
С агентом
Ваш ИИ-агент (например, Claude Code, Codex, Cursor или Gemini CLI) может выполнить эти проверки за вас. Агенту с терминалом необходим skill tg; агенту в приложении без терминала необходим сервер MCP. Ниже: что вы говорите, что запускает агент и что вы получаете взамен.
Имена, сообщения и результаты, приведенные ниже, являются вымышленными. Команды отделены от ответа: агент читает данные и представляет их вам.
Утро админа: кто ждёт ответа
Начните с вопросов, которые давно ждут вас или админов.
Ваш запрос:
Что в «Hiking» осталось без ответа больше четырёх часов?
Команда:
tg personal review 'chat:Hiking' --unanswered 4h --jsonПример ответа агента:
3 вопроса ждут ответа.
Участник Вопрос Ожидание Лена Во сколько выезд в субботу? 6 часов Артём Палатки общие? 12 часов Ира Кто возьмёт котелок? 15 часов Откройте вопрос, чтобы проверить переписку вокруг него.
Это правила review: вопросом считается «?» вне ссылки или ответ вам/админу. Прямой ответ либо следующая реплика вас/админа может закрыть вопрос. Статистический отчёт считает только связанные прямые ответы и может дать другой результат.
Новенькие за неделю
Посмотрите события вступления; возраст аккаунта — повод проверить человека, а не доказательство спама.
Ваш запрос:
Кто вступил в «Hiking» за неделю? Покажи, кого стоит проверить.
Команда:
tg personal chats events "Hiking" 'time>=7d' --jsonПример ответа агента:
Новичок Как появился Катя Добавлена Леной Олег Вступил сам Для проверки Олега откройте доступные сведения о нём. Только по возрасту аккаунта удалять нельзя.
События показывают только доступную историю. Текущий список участников можно проверить отдельно.
Если приглашение стало публичным
Замените ссылку-приглашение, если вы попросили об этом.
Ваш запрос:
Ссылка Hiking попала посторонним. Замени её и разреши добавлять людей только админам.
Заменить ссылку:
tg personal chats links reset "Hiking" --jsonОграничить добавление участников:
tg personal chats update "Hiking" --only-admins-add on --jsonПример ответа агента:
Настройка Результат Старая ссылка Заменена Добавление участников Только админы Новая ссылка находится в запрошенном результате; передайте её только нужным людям.
Эти команды изменяют группу. Запрос в примере разрешает оба изменения.
Удаление спама с вашего согласия
Сначала посмотрите, что предполагают правила, без каких-либо действий.
Ваш запрос:
Проверьте Поход на спам. Пока ничего не удаляйте; покажи предложения.
Команда:
tg personal chats moderate "Hiking" --dry-run --jsonПример ответа агента:
Предложение: удалить сообщение со ссылкой-приглашением.
Найдено Предложение Статус Ссылка-приглашение Удалить сообщение Только предпросмотр Ничего не удалено. Подтвердите точное сообщение, если хотите выполнить действие.
Для реальных действий нужен ваш запрос и разрешения профиля. Предварительный просмотр не дает разрешения на удаление.
Недельный отчёт по группе
Попросите короткий итог: решения, обязательства и открытые вопросы.
Ваш запрос:
Сделай итог недели по «Hiking».
Команда:
tg personal review 'chat:Hiking date>7d' --jsonПример ответа агента:
Решили: выезд в 7:00 от станции.
Взяли на себя:
- Лена — продукты.
- Артём — палатки.
Открыто: кто возьмёт котелок.
Покажу исходные сообщения, если нужно проверить итог.
Проверка по расписанию
Для списка открытых вопросов агент не нужен: это обычная команда.
0 9,21 * * * tg personal review 'chat:Hiking' --unanswered --json >> ~/hiking-open.jsonl 2>> ~/tg-cron.logcron не имеет терминала и часто не имеет XDG_RUNTIME_DIR, без которого tg не может получить доступ к связке ключей: см. работа по расписанию.
Доступные команды
Включить темы может только владелец группы. Существующей супергруппе обновление не нужно. После обновления обычной группы у неё появляется новый идентификатор чата; локальное хранилище сохраняет старые сообщения под прежним идентификатором и не объединяет две истории.
В теме форума текст, подписи к фото и файлам и запланированные отправки остаются в этой теме, а явный
ответ должен относиться к той же теме. Закрытая или отсутствующая тема отклоняется до того, как что-либо
отправлено. Если результат отправки неизвестен, повторите её с тем же --operation-id, чатом и темой; для
запланированной отправки вместо повтора проверьте tg personal messages scheduled <chat>.
Агент, подключенный через MCP-сервер, может выполнять те же команды, насколько это позволяют разрешения профиля.
create, join, leave, update, link reset, members и admins меняют то, что видят участники группы: новая группа сообщает добавленным людям, а в чате отображается сообщение о присоединении или выходе. Каждый из них проходит через разрешения профиля и защиту отправки, и каждый добавленный человек учитывается в почасовом лимите (см. Защита отправки).
Что ждёт вашего действия
review и serve хранят список задач в локальном хранилище: что должны сделать вы и что кто-то должен вам. Задача указывает на своё сообщение и никогда не копирует его. Где правило открывает задачу:
- Личный чат: вопрос, на который вы не ответили, и сообщение, где вас упомянули.
- Группа: только вопрос, который отвечает на ваше сообщение, и упоминание вас. Вопросы других людей — не ваши задачи.
- Канал или «Избранное»: ничего.
Ваш ответ закрывает задачу. Чтобы записывать каждый вопрос в группе, кому бы он ни был адресован, поставьте группе тег:
tg personal tags add --chat <group> watch-tasks
tg personal tags remove --chat <group> watch-tasksВ группе с этим тегом каждый вопрос, на который вы не ответили, открывает задачу — сообщение со знаком вопроса или ответ на ваше сообщение. Учитываются только новые сообщения; для старых используйте tasks scan. Просьба или обещание без знака вопроса — не задача правила: её добавляет ваш агент через tasks add. Вопрос закрывает ваш ответ, а также ответ на него от любого участника, кроме того, кто спросил. Более позднее сообщение, которое не отвечает на вопрос, ничего не закрывает; такую задачу закрываете вы или ваш агент. Ставьте тег только группам, где отвечать должны вы.
Первая синхронизация аккаунта не открывает задач из вашей истории; следующие синхронизации открывают задачи из новых сообщений. Чтобы превратить историю чата в задачи, посмотрите, что откроется, а затем откройте:
tg personal tasks scan <chat>
tg personal tasks scan <chat> --last 300 --yesconfig set task_first_pass_per_chat <n> позволяет первой синхронизации открыть до n задач на чат.
Когда кто-то что-то вам обещает, сохраните это как его задачу и посмотрите, что вам должны другие:
tg personal tasks add msg:telegram/<you>/<chat>/<message> --type promise --category other --assignee sender
tg personal tasks list "assignee:any state:open"--assignee sender — тот, кто отправил сообщение; --assignee person:<id> называет другого человека, а tasks update <task> --assignee none убирает исполнителя. Задача без исполнителя — это нормально: лучше, чем пропущенная.
Посмотрите, что вас ждет, сначала самые старые, потом только вопросы и упоминания в одной группе:
tg personal tasks list state:opentg personal tasks list chat:<chat id> "(kind:question OR kind:mention)"Добавьте то, что не видят правила, например данное вами обещание, или закройте задачу, не требующую ответа:
tg personal tasks add msg:telegram/<you>/<chat>/<message> --type promise --category othertasks categories показывает категории, которые может получить задача. Чтобы изменить список, измените раздел task_categories в ~/.config/WireCat/config.json. Это общий файл настроек инструментов WireCat, а не файл одного профиля. В нём только ваши изменения списка по умолчанию: имя со смыслом и словами-признаками добавляет или заменяет категорию, а null убирает категорию из списка по умолчанию:
{
"task_categories": {
"garden": "plants | seedling, es:planta",
"religion": null
}
}config set task_categories.garden "plants | seedling" и config unset task_categories.garden пишут в тот же файл и сохраняют его другие разделы; config unset task_categories возвращает список по умолчанию. Хранилище, перенесённое через MESSAGING_STORE, читает config.json рядом с собой.
Если задача может совпадать с открытой, tasks add отклоняет добавление с кодом 2 и показывает кандидатов. Повторите с --into <task>, чтобы связать сообщение с этой задачей, либо с --new, чтобы создать отдельную. Если она совпадает только с задачей, закрытой за последние 14 дней, tasks add открывает её как продолжение, связанное follow-up-of с закрытой. tasks duplicates list показывает найденные правилами пары, а tasks merge <task> --into <other> объединяет задачи:
tg personal tasks add msg:telegram/<you>/<chat>/<message> --type promise --category other --into <task>tg personal tasks close <task> --as dismissed --reason no-reply-neededИИ-агент, который закрывает задачу, указывает свою уверенность через --certainty, от 0 до 1. Ниже порога хранилища (task_agent_close_min, по умолчанию 0.8) задача остаётся открытой с предложением закрыть; config set task_agent_close off превращает любое закрытие агентом в предложение. tasks list close:suggested находит их. Подтвердите предложение командой tasks close <task> или отклоните его командой tasks reject <task>:
tg personal tasks list close:suggestedtg personal tasks reject <task>Дайте задаче название, срок и дату, когда к ней вернуться, и свяжите с ней сообщения и чаты, к которым она относится. Дата следующей проверки — для вас или вашего агента; tg никому не напоминает:
tg personal tasks update <task> --title "Send Anna the contract" --due 2d --remind-time 1dtg personal tasks link <task> msg:telegram/<you>/<chat>/<message> --chat "Hiking"Посмотрите, что требует внимания сегодня: просроченные задачи и задачи с близким сроком, чаты, где кто-то ждёт вашего ответа, и чаты, где вы ждёте ответа от других. Команда читает локальное хранилище, а не текст сообщений:
tg personal tasks agendatasks agenda и tasks duplicates list принимают поля запроса:
tag:иcategory:оставляют задачи с этой меткой или категорией:tag:urgent,category:money.claimed:говорит, кто взял задачу:none,mine,othersилиany. Без него в списке дел видны задачи, которые никто не взял, и ваши;claimed:anyпоказывает все.decision:выбирает пары дублей:review(по умолчанию) ждут проверяющего агента, аunsureждут вас:decision:unsure.
tg personal tasks agenda category:money tag:urgent claimed:anytg personal tasks duplicates list decision:unsuretg skill show follow-ups выводит ежедневный порядок работы для ИИ-агента: он готовит черновики
ответов по этому списку и ничего не отправляет.
Посмотрите открытые задачи для каждого чата, самую старую и среднее время закрытия:
tg personal stats tasks showЗакрытая задача остается закрытой, а отклоненная никогда не возвращается. Только ваши собственные ответы закрывают задачу, ответы других администраторов — нет, и упоминания через @username не учитываются. Агент, подключенный через MCP, получает те же команды.
Правила
В правилах группы говорится, что ищет tg personal chats moderate и что он может с этим делать. Они живут в файле этого профиля, никогда в Telegram, и за группой в фоновом режиме ничего не следит: правило действует только при запуске chats moderate.
Покажите правила. До вашего первого изменения они являются значениями по умолчанию и помечены как несохраненные:
tg personal chats rules show "Hiking"Удалить сообщение, в котором есть ссылка:
tg personal chats rules set "Hiking" links deleteЗаблокировать этих людей по идентификатору…
tg personal chats rules set "Hiking" blocked 12345,67890…и удалять их, когда они пишут или присоединяются:
tg personal chats rules set "Hiking" blockedPeople removeУдалить без предварительного запроса:
tg personal chats rules set "Hiking" consent.delete allowПосмотрите, что будет делать проверка, не выполняя ее:
tg personal chats moderate "Hiking" --dry-runПроверьте, что нового появилось с момента последнего запуска, и действуйте:
tg personal chats moderate "Hiking"| Правило | По умолчанию | Что он ищет |
|---|---|---|
links, invites, forwards | report | сообщение со ссылкой, ссылка-приглашение в другую группу, пересылаемое сообщение |
blocked, blockedNames | — | люди по идентификатору или части имени, разделенной запятой |
blockedPeople | report | что делать с сообщением или присоединением заблокированного человека |
flood.messages, flood.minutes, flood.action | 5, 1, report | больше, чем столько-то сообщений от одного человека за столько-то минут |
trusted | — | люди, к которым правила никогда не применяют действия; администраторы группы и вы тоже исключены |
consent.delete, consent.remove | ask | насколько далеко вы разрешаете каждое действие |
Действие каждого правила — report, delete или remove. Произойдет ли delete или remove, зависит от уровня группы, consent.delete и consent.remove: deny никогда, readonly только сообщает, ask спрашивает вас о каждом из них (по умолчанию; --allow-dangerous говорит да всем), allow делает это. Каждое действие по-прежнему проходит через защиту отправки и часовой лимит, а выполнение останавливается после --max-actions (10). Следующий запуск начинается с того места, где остановился этот; --since-time смотрит на ваш собственный период и не сдвигает сохранённую точку отсчёта.
Агент, подключенный через MCP, действует только там, где уровень равен allow; действия с запросом подтверждения перечисляются для вас и не выполняются. newAccount не предлагается: Telegram не сообщает, сколько лет аккаунту.
С ботом
Если ваш бот является администратором группы, он может выполнить ту же проверку: tg <bot> bot chats moderate. Человек, которого удалит бот, не сможет вернуться по ссылке, если вы не добавите --no-block. Бот оценивает только сообщения, которые он видел или импортировал на этом компьютере, и не проверяет вступления. См. модерирование группы с помощью бота.
Ограничения
- История Telegram — источник событий.
chats eventsиreviewпоказывают, что еще хранится в истории чата; служебное сообщение, удаленное администратором, для них тоже пропало. - Админы известны только там, где говорит Telegram. Без них
review --unansweredзасчитывает только ваши ответы и так и говорит. - Ничто не наблюдает за группой само по себе. Проверка запускается, когда вы, агент по вашему запросу или по вашему расписанию запускаете ее.
- Применяются ограничения скорости Telegram. Чтение каждого члена большой группы требует большого количества запросов; ответ
FLOOD_WAITговорит, как долго ждать (см. когда Telegram просит подождать).
Статистика для администраторов групп
Посмотрите сообщения, участников переписки и ответы за неделю. Чтобы узнать, кто отвечает, кому нужна помощь и остаются ли новички, откройте Статистику.
Ваш запрос:
Покажи активность Hiking за неделю и пробелы в истории.
Команда:
tg personal stats chats show "Hiking" --since-time 7d --offline --jsonПример ответа агента:
Показатель В доступной истории Сообщения 120 Участники переписки 18 Ответы 30 История неполная: это наблюдаемые значения. Этот локальный запрос не загружал события вступления и выхода.
Без --offline CLI также загружает события вступления и выхода. Сохранённые ежедневные наблюдения остаются доступны локально. Первый отчёт не может восстановить прошлые списки участников.
Статистика самого Telegram
tg personal stats chats official <chat> --jsonTelegram рассчитывает статистику для администраторов достаточно крупных супергрупп и каналов — ту же, что на экране «Статистика» в приложениях. tg personal stats chats official запрашивает её и выводит один объект JSON. Период выбирает Telegram; он указан в period. Каждый итог сопровождается значением за предыдущий период.
- У супергруппы (
kind: "group") есть участники, сообщения, читатели и авторы, самые активные авторы, администраторы и приглашающие, а также 8 графиков: рост, участники, новые участники по источнику, языки, сообщения, действия, часы и дни недели. - У канала (
kind: "channel") есть подписчики, просмотры, пересылки и реакции на пост и историю, число подписчиков с включёнными уведомлениями, последние посты со счётчиками и 12 графиков.
Каждый график — список рядов по значениям x: date (день, YYYY-MM-DD), time (ISO 8601) или number. Если Telegram не может предоставить график, он отображается как { "error": ... }, а остальные графики остаются. Команда только читает: ничего не отправляет, не отмечает прочитанным и не меняет. --jsonl отклоняется.
Telegram отвечает только для чата, в котором показывает вам статистику. В обычной группе, чате, где вы не администратор, или слишком маленьком чате команда завершается ошибкой прав или проверки параметров. Один запуск требует примерно 10–17 запросов: карточка чата, статистика и каждый график, который Telegram отдаёт позже. Укажите чат по @username или ID: название сначала ищется в вашем списке чатов, что добавляет запрос на каждые 100 чатов. Telegram хранит статистику на отдельном сервере, поэтому первый запуск добавляет ключ входа для него в файл сессии; ключ никогда не выводится.
Снимки состава и изменения
tg personal chats members fetch читает участников в локальное хранилище, записывая профили, изменения, число участников за день и полноту чтения. --max-pages ограничивает число страниц. Частичное чтение никого не отмечает как вышедшего: для этого нужно прочитать весь доступный список и знать численность группы, не превышающую число прочитанных участников. Больший бюджет не позволяет обойти ограничения Telegram на список участников.
--track добавляет группу в список отслеживания. chats tracking list показывает все отслеживаемые группы; show — состояние отслеживания одной группы и ежедневные числа за последние 30 дней. add начинает отслеживание без немедленной загрузки; remove прекращает ежедневную загрузку и сохраняет записанную историю. Пока работает tg personal serve, он загружает отслеживаемые группы по одной, начиная первый обход через минуту после подключения, и пропускает уже загруженные в текущий день UTC. Отслеживание не запускает serve; если сервер был остановлен несколько дней, следующий запуск создаёт новый снимок, а не заполняет пропущенные дни.
tg personal chats members history показывает записанные вступления, выходы и изменения профилей от старых к новым; период ограничивает запрос, например time>=7d. Команда никогда не обращается к Telegram. Для вступления используется время Telegram, если известно, иначе время первого наблюдения человека. Выход датируется первым полным снимком без человека, а не точным временем выхода. Первая загрузка записывает исходный состав: эти люди не обязательно вступили в тот день. chats members list --offline читает последний полностью сохранённый состав; частичное чтение его не заменяет. Без полного снимка список может быть пуст, хотя некоторые профили и события уже записаны. Профили и история остаются в локальном хранилище рядом с сообщениями.
tg personal chats members check перечисляет участников с признаками ботов и причинами; --max-pages ограничивает страницы, порог задаёт запрос, например score>=3 (без него score>=2). Никого не удаляет и исключает администраторов и владельца. meta.truncated означает, что прочитаны не все участники. С --offline команда недоступна; оценки требуют проверки человеком. Telegram предоставляет сведения о bot, scam, fake, deleted, фото, вступлении и пригласившем, где они доступны. «Никогда не писал» означает, что в локальной истории сообщения не найдены, а не доказательство, что человек никогда не писал в группе.
--deep <n> также полностью проверяет первых n участников, по одному в секунду: профиль, самое старое фото профиля, до 1 000 сохранённых сообщений каждого и два публичных списка спама — Combot CAS и lols.bot. ID каждого участника отправляется этим спискам. Полная проверка попадает в check у каждого проверенного участника.
Еженедельный отчёт для вашей группы
«Hiking Club» ниже — вымышленная группа для примера. Сначала загрузите её сообщения через messages sync, если они ещё не сохранены, затем запишите текущий состав и подготовьте отчёт:
tg personal chats members fetch "Hiking Club" --track --jsontg personal stats chats show "Hiking Club" --since-time 7d --by day --timezone Europe/Madrid --jsontg personal chats members history "Hiking Club" "time>=7d" --offline --jsontg personal chats tracking show "Hiking Club" --offline --jsontg personal chats members check "Hiking Club" --jsonПопросите агента включить в отчёт сообщения, активных отправителей, вопросы без ответа, изменения состава и дни со снимками участников. Оставьте в отчёте видимыми записи missing, meta.truncated и промежутки между снимками. Для будущих отчётов держите tg personal serve запущенным или повторяйте загрузку участников; первый отчёт не может показать выходы до первого записанного состава.