// прямые ответы · 40+ вопросов · без воды
Часто задаваемые вопросы
Каждый ответ начинается с прямого ответа — в первом предложении. Доказательство — сразу после. Не нашли свой вопрос? Напишите на master@letterbot.ru
Ничего не найдено. Попробуйте другой запрос или напишите на master@letterbot.ru
О продукте
Что такое LetterBot?+
LetterBot — это бесплатный локальный оператор почты для Windows. Подключается к вашим IMAP-ящикам, анализирует входящие письма, определяет приоритет и предложенное действие, отправляет короткое уведомление в Telegram. Всё работает на вашем компьютере — без серверов LetterBot.
Это ещё один почтовый клиент?+
Нет. LetterBot не заменяет ваш почтовый клиент. Он добавляет поверх него слой умного triage: отбирает только то, что требует действия, и сигнализирует в Telegram. Ваш inbox остаётся как есть — LetterBot работает в IMAP read-only режиме.
Чем LetterBot отличается от Superhuman и Gmail AI?+
Superhuman и Gmail AI — облачные сервисы: ваша почта обрабатывается на их серверах. LetterBot обрабатывает всё локально. Кроме того: LetterBot бесплатен, open source, использует Telegram как рабочий интерфейс и не требует OpenAI. Такого сочетания нигде больше нет при нулевой стоимости.
LetterBot — это продакшн-готовый продукт?+
Да, для личного и малого бизнеса. Внутри — health checks, retry/backoff, SLA-метрики, graceful degradation, event model и observability cockpit. Не подходит для enterprise (SAML/SSO, compliance-сертификации, централизованного управления).
Приватность и данные
Письма уходят в облако?+
По умолчанию — нет. LetterBot читает письма через IMAP с вашего почтового сервера, обрабатывает их локально и хранит метаданные в SQLite на вашем диске. Никаких серверов LetterBot не существует — некуда передавать данные.
Нужен ли OpenAI или ChatGPT?+
Нет. OpenAI не поддерживается. По умолчанию LetterBot работает в детерминированном режиме без внешних AI. Опциональные провайдеры — GigaChat (Сбер) и Cloudflare Workers AI. Их подключение необязательно и не меняет базовую полезность.
Если я включу LLM — что именно отправляется?+
Только текст тела письма (минимальный контекст для классификации). Содержимое вложений, полный raw email, адресная книга и история — не передаются. Вы сами контролируете, какой провайдер обрабатывает этот запрос по своей политике приватности.
Что хранится в локальной SQLite?+
Метаданные: отправитель, тема, дата, тип письма, приоритет, источник приоритета, извлечённые сущности, состояние снуза, аналитика. Полные тела писем и содержимое вложений обрабатываются в памяти и не сохраняются.
Есть ли телеметрия?+
Нет. Нулевая телеметрия. Единственные внешние соединения: ваш IMAP-сервер, Telegram Bot API и выбранный LLM-провайдер (если настроен). Проверить можно в исходном коде на GitHub.
Как удалить все данные LetterBot?+
Удалите файл
data/mailbot.sqlite или весь каталог проекта. Никаких облачных бэкапов, никаких запросов на удаление аккаунта — всё на вашей машине.Технические вопросы
Какие почтовые провайдеры поддерживаются?+
Любой IMAP-совместимый ящик: Яндекс.Почта (
imap.yandex.ru), Mail.ru (imap.mail.ru), Gmail (imap.gmail.com с паролем приложения), корпоративный Exchange/Office 365, Outlook, FastMail, ProtonMail Bridge и любой другой IMAP-сервер.Можно подключить несколько ящиков?+
Да. Неограниченное количество IMAP-аккаунтов. Каждый маршрутизируется в отдельный Telegram-чат — рабочая почта в один чат, личная в другой, серверные алерты в отдельный канал. Дайджесты не дублируются между аккаунтами.
LetterBot модифицирует или удаляет письма?+
Нет. LetterBot подключается в IMAP read-only режиме. Он никогда не удаляет, не перемещает, не помечает и не изменяет ни одного письма. Ваш inbox остаётся в точности как был.
Подходит ли для старого компьютера?+
Да — это один из лучших сценариев. Протестировано на Intel Celeron N4020 (2 ядра, 1.1 ГГц) с 3 ГБ RAM. Старый ноутбук или запасной десктоп — отличный выделенный локальный почтовый ассистент.
Есть ли локальный web-интерфейс?+
Да. Read-only observability cockpit на
http://127.0.0.1:8787. Доступные маршруты: дашборд, архив писем, трейс AI-решений с кодами причин, состояние системы, SLA-метрики доставки (p90 latency, delivery rate, error rate), аналитика отправителей. Не подключается к интернету.LetterBot читает PDF и Excel?+
Да. Извлекает текст из PDF и Excel (.xlsx) без Microsoft Office. Содержимое вложений участвует в расчёте приоритета — счёт в PDF может автоматически получить 🔴 Срочный приоритет.
Что происходит при отключении интернета?+
LetterBot не может синхронизировать IMAP и доставлять Telegram-уведомления без интернета. Но он не падает — автоматически повторяет попытку при следующем опросе. Все локальные данные сохраняются.
Что происходит при недоступности LLM?+
LetterBot автоматически переходит в
DEGRADED_NO_LLM режим и продолжает отправлять базовые уведомления на основе детерминированного анализа. Вы получаете Telegram-уведомление о деградации. При восстановлении LLM — нормальный режим возобновляется автоматически.Работает ли на Raspberry Pi или Linux?+
Официально — только Windows 10/11. Технически возможно на Linux/Pi при наличии Python 3.10+. Пользователи сообщают об успехе на Pi 4 с 4 ГБ RAM. Поддержки нет — но можно открыть issue на GitHub.
Функциональность
Как работает приоритизация?+
Детерминированный движок Priority v2: анализирует историю отправителя, тип письма (INVOICE, CONTRACT, SECURITY_ALERT…), ключевые слова дедлайна, тип вложения и частотные аномалии. Результат: 🔴 Срочно / 🟡 Важно / 🔵 Низкий. Каждое решение содержит код причины — например
PRIO_INVOICE или PRIO_DEADLINE_1D. Не чёрный ящик.LetterBot учится на моих исправлениях?+
Да. Когда вы нажимаете кнопку приоритета в Telegram, переопределяя решение системы, это записывается как сигнал коррекции. Со временем система адаптируется — какие отправители для вас срочные, каких вы регулярно понижаете. Контролируемый feedback loop, не магическое самообучение.
Как работает снуз с памятью?+
Нажмите кнопку снуза (2 часа, завтра, следующая неделя) в Telegram. В назначенное время LetterBot вернёт письмо с полным контекстом: оригинальный отправитель, тема, тип письма, предложенное действие, время получения. Это не просто напоминание — контекст решения восстанавливается полностью.
Какие типы писем распознаёт LetterBot?+
INVOICE (счёт), CONTRACT (договор), SECURITY_ALERT (уведомление безопасности), PRICE_LIST (прайс), NEWSLETTER, NOTIFICATION и другие. Классификация определяет базовый уровень приоритета и предложенное действие в Telegram-уведомлении.
Что такое отслеживание обязательств?+
LetterBot обнаруживает фразы-обязательства в письмах: «пришлю к пятнице», «подтвердите до понедельника», «позвоню завтра». Они отслеживаются и выводятся в еженедельном дайджесте — кто что обещал, включая ваши исходящие обязательства.
Как выглядит Telegram-уведомление?+
Одно письмо — одно сообщение. Структура: эмодзи приоритета + тип письма · отправитель · тема · 2–3 строки саммари · предложенное действие · заметка о вложении (если есть) · кнопки приоритета · кнопки снуза. Нажатие кнопки приоритета обновляет хранимый приоритет и тренирует модель.
Что такое еженедельный дайджест?+
Сводка каждый понедельник: всего обработанных писем, обнаруженные счета (с суммами), договоры на проверку, просроченные обязательства, silent-partner risks (контакты, переставшие отвечать) и ожидающие ответа письма. Дедупликация по
chat_id — если у вас несколько ящиков в одном чате, дайджест приходит один раз.Что такое ежедневный дайджест?+
Ежедневная сводка в настроенное время: ключевые события за день, письма, требующие внимания, и статус обязательств. Дедупликация между аккаунтами — один чат получает один дайджест, даже если к нему привязано несколько ящиков.
Установка и настройка
Как установить LetterBot?+
4 шага:
1. Скачать ZIP с GitHub Releases
2. Распаковать в удобное место
3. Заполнить
4. Запустить
Python не нужен — dist включает runtime. Около 10–15 минут.
1. Скачать ZIP с GitHub Releases
2. Распаковать в удобное место
3. Заполнить
accounts.ini — IMAP-данные и токен Telegram-бота4. Запустить
letterbot.batPython не нужен — dist включает runtime. Около 10–15 минут.
Нужно ли устанавливать Python?+
Нет. One-folder Windows release включает Python runtime в дистрибутиве. Просто распакуйте и запустите
letterbot.bat.Как создать Telegram-бота?+
Напишите
@BotFather в Telegram, команда /newbot, следуйте инструкциям. Скопируйте токен в accounts.ini. Затем напишите вашему боту любое сообщение и получите chat_id через https://api.telegram.org/bot[TOKEN]/getUpdates.Что такое 2-file config mode?+
Вся конфигурация разделена на два INI-файла:
settings.ini — общие параметры системы (интервал опроса, настройки дайджеста, параметры приоритизации), accounts.ini — секреты и аккаунты (IMAP-данные, токены). Проще разделять общие настройки и секреты.Что делать если конфиг не найден?+
Система не падает молча. Автобутстрап определяет, каких файлов не хватает, и выводит список с точными командами для создания из шаблона. Порог первого запуска — минимальный.
Как диагностировать проблемы?+
Три уровня диагностики: лог запуска с явными статусами,
doctor в CLI и /doctor в локальном web cockpit (127.0.0.1:8787/doctor). Показывает состояние всех систем, конфигурацию, здоровье ящиков и качество решений.Стоимость и лицензия
Нужна ли подписка?+
Нет. LetterBot бесплатен навсегда. AGPL-3.0 open source. Без freemium, без платных планов, без триала. Разработка поддерживается добровольными донатами через Boosty — без коммерческих целей.
LetterBot когда-нибудь станет платным?+
Нет. LetterBot задуман как постоянно бесплатное open source ПО. Разработка финансируется добровольными донатами. AGPL-3.0 лицензия гарантирует, что исходный код всегда будет открытым.
Что такое AGPL-3.0?+
GNU Affero General Public License версии 3. Вы можете читать, модифицировать и распространять код. Условие: модифицированные версии, оказывающие услуги по сети, обязаны публиковать исходный код. Подробности — на сайте GNU.
Как поддержать проект?+
Добровольный донат через Boosty. Или звезда на GitHub. Или сообщение об ошибке в Issues. Или рекомендация коллегам. Всё это помогает проекту развиваться.
Не нашли ответ?
Напишите на master@letterbot.ru или в Telegram-канал