Мессенджер-адаптеры
Цели урока
После прохождения этого урока вы сможете:
- 1Изучить все 18+ мессенджер-адаптеров Hermes Agent
- 2Настроить Telegram-адаптер с нуля
- 3Понять разницу между одноканальным и многоканальным подходом
- 4Узнать о рисках при использовании неофициальных API
Агент в каждом мессенджере
Мессенджер-адаптеры - одна из самых мощных возможностей Hermes Agent. Вместо того чтобы работать с агентом через терминал, вы общаетесь с ним в привычном мессенджере. Telegram, Slack, Discord, WhatsApp - агент доступен там, где вы проводите время.
Полный список адаптеров
| Адаптер | Статус | API | Ограничения |
|---|---|---|---|
| Telegram | Стабильный | Официальный Bot API | Ботовые ограничения (без звонков) |
| Slack | Стабильный | Официальный Slack API | Требует Slack App |
| Discord | Стабильный | Официальный Discord API | Требует бота на сервере |
| Matrix | Стабильный | Официальный Matrix SDK | Нужен Matrix-сервер |
| Стабильный | IMAP/SMTP | Задержка доставки | |
| SMS (Twilio) | Стабильный | Twilio API | Платный, по тарифу |
| IRC | Стабильный | IRC Protocol | Без шифрования |
| XMPP | Стабильный | XMPP Protocol | Нужен XMPP-сервер |
| Mattermost | Стабильный | Mattermost API | Self-hosted |
| Zulip | Стабильный | Zulip API | Организация по темам |
| Rocket.Chat | Бета | Rocket.Chat API | Self-hosted |
| Бета | Неофициальный | Риск блокировки аккаунта | |
| Viber | Бета | Viber Bot API | Ботовые ограничения |
| Teams | Бета | Microsoft Graph API | Требует Azure AD |
| LINE | Бета | LINE Messaging API | Популярен в Японии/Таиланде |
| Signal | Альфа | Signal CLI | Требует регистрацию номера |
| iMessage | Альфа | AppleScript | Только macOS |
| Альфа | Неофициальный | Верификация в Китае |
Настройка Telegram-адаптера
Telegram - самый популярный адаптер Hermes Agent. Настройка занимает три минуты: создаете бота через BotFather, копируете токен и добавляете в конфигурацию.
Откройте Telegram и найдите @BotFather
Отправьте команду /newbot и следуйте инструкциям
Скопируйте токен бота (формат: 123456789:ABCdefGHIjklMNO-pqrSTUvwxYZ)
Добавьте токен в файл .env
Перезапустите Hermes Agent
# Файл .env - настройка Telegram
# Токен бота от BotFather
TELEGRAM_BOT_TOKEN=123456789:ABCdefGHIjklMNO-pqrSTUvwxYZ
# Разрешенные пользователи (ID через запятую)
# Без этой настройки бот отвечает всем!
TELEGRAM_ALLOWED_USERS=123456789,987654321
# Разрешенные группы (опционально)
TELEGRAM_ALLOWED_GROUPS=-1001234567890
# Режим работы
TELEGRAM_MODE=polling # polling или webhook
# Формат ответов (markdown или html)
TELEGRAM_PARSE_MODE=markdown# Перезапускаем агента с Telegram-адаптером
docker compose restart hermes-agent
# Проверяем статус адаптера
docker compose exec hermes-agent hermes adapters status
# Ожидаемый вывод:
# Adapters:
# telegram [active] bot: @YourBotName users: 2 groups: 1
# slack [inactive]
# discord [inactive]Одноканальный vs многоканальный подход
WhatsApp и WeChat используют неофициальные API. Это означает риск блокировки аккаунта. Для бизнес-задач рекомендуем использовать только адаптеры с официальными API: Telegram, Slack, Discord, Matrix, Email.
Начните с одного адаптера (Telegram - лучший выбор), убедитесь что все работает, и только потом подключайте дополнительные каналы. Не пытайтесь настроить все 18 адаптеров сразу.
Мессенджер-адаптеры превращают Hermes Agent из терминального инструмента в персонального ассистента, доступного через привычные каналы связи. Один агент с общей памятью работает в Telegram, Slack, Discord и 15 других мессенджерах одновременно.
Вопросы для размышления
- •В каком мессенджере вы чаще всего общаетесь по работе и подойдет ли Hermes Agent для этого канала?
- •Какие задачи вы бы делегировали агенту через мессенджер вместо терминала?