Hermes Agent - подключаем почту за 5 минут

Hermes Agent умеет работать с почтой - читать входящие, отвечать, обрабатывать вложения. Рассказываю, как подключить Gmail за 5 минут.

Шаг 1. Включаем двухфакторную аутентификацию

Google не даёт создать пароль приложения без 2FA. Зайдите в аккаунт → Безопасность → 2-этапная аутентификация. Включите.

Шаг 2. Создаём пароль приложения

Google → Безопасность → Пароли приложений. Выбираете "Почта" → "Другое". Генерируется 16-символьный пароль вида:

`abcd efgh ijkl mnop`

Этот пароль подставляете в конфиг агента, а не свой основной пароль от Gmail.

Шаг 3. Прописываем в .env

На сервере с Hermes Agent добавляем в ~/.hermes/.env:

`EMAIL_ADDRESS=ваша.почта@gmail.com
EMAIL_PASSWORD=сгенерированный пароль приложения
EMAIL_IMAP_HOST=imap.gmail.com
EMAIL_SMTP_HOST=smtp.gmail.com
EMAIL_ALLOWED_USERS=ваша.почта@gmail.com`

ВАЖНО: Поле EMAIL_ALLOWED_USERS ограничивает, кто может писать агенту. Без него любой, кто узнает адрес, сможет слать команды.

Для Gmail параметры стандартные: IMAP порт 993 (SSL), SMTP порт 587 (STARTTLS). Для других провайдеров адреса портов могут отличаться.

Шаг 4. Перезапускаем gateway

`sudo systemctl restart hermes-gateway`

После перезапуска агент начинает проверять почту каждые 15 секунд. Старые письма не трогает - только новые.

Как это работает

Агент видит входящие письма, читает тему и текст, может работать с вложениями (картинки, PDF, документы). Отвечает в тот же email-тред.

Примеры использования:

• Поручили разобрать входящие - агент прочитал, структурировал, дал сводку

• Пришёл счёт - агент проверил сумму, ответил, создал задачу

• Письмо от клиента - агент подготовил черновик ответа, вы утвердили и отправили

• Просто написали "что там по проекту X?" - агент посмотрел переписку и ответил

Если что-то пошло не так

SMTP connection failed: Network is unreachable - некоторые VPS блокируют SMTP-порты. Решение: уточните у хостера, или используйте IMAP только для чтения.

IMAP connection failed - проверьте IMAP_HOST и порт. Для Gmail: imap.gmail.com:993.

---

🌐 hermes-agent.ru - сайт проекта

Хотите настроить почту, но что-то идёт не так? Напишите в контакты на сайте - поможем.