Что это вообще такое
Hermes Agent — бесплатный опенсорсный каркас для ИИ-помощника от Nous Research. Сам по себе он не умный: ум дает подключенная модель. Зато он умеет то, чего не умеет обычный чат-бот — жить на сервере круглосуточно, запускать команды, писать файлы, ходить в интернет, помнить вас между разговорами, писать себе новые инструкции и просыпаться по расписанию. И все это через обычную переписку в Telegram, с телефона.
Ключевое отличие от ChatGPT в телефоне: он не забывает вас, умеет делать, а не только отвечать, и работает, пока вы спите.
Три вещи, из-за которых у новичков все ломается
Если запомнить только эту секцию — уже сэкономите себе выходные.
1. Помощник должен жить на сервере, а не в вашем ноутбуке
так ломается
Запустили Hermes на ноутбуке или просто командой в окне терминала — закрыли крышку, разорвали связь, и бот в Telegram замолчал. Ни ответов, ни задач по расписанию.
так работает
Hermes стоит на арендованном сервере и запущен как сервис (hermes gateway install). Сервер перезагрузился — сервис поднялся сам. Вы спите, а бот отвечает.
2. Гермес — это тело. Ум покупается отдельно
так разочаровываются
Взяли самую бесплатную модель, задали сложную задачу — получили кашу и решили, что Hermes бесполезен. На самом деле бесплатная модель — это стажер-школьник, а не помощник.
так становится полезным
Ставьте сильную модель с большим контекстом (документация требует минимум 64 000 токенов). Тот же Hermes с нормальной моделью — уже реально рабочий напарник.
3. Бота надо закрыть на замок
так опасно
Бот создан, но список разрешенных пользователей пустой — писать ему может любой, кто нашел бота. А у бота есть терминал вашего сервера.
так спокойно
В настройках прописан TELEGRAM_ALLOWED_USERS с вашим ID — бот отвечает только вам. Плюс отдельный пользователь на сервере вместо администратора.
Шаг 1. Арендовать сервер
Сервер (он же VPS) — это компьютер в дата-центре, который вы снимаете помесячно. Он никогда не выключается и всегда в интернете. Именно поэтому бот отвечает круглосуточно.
| Что | Минимум | Рекомендую | Почему |
|---|---|---|---|
| Процессор | 2 ядра | 2-4 ядра | Тяжелую работу делает модель на стороне провайдера, сервер только дирижирует |
| Память | 2 ГБ | 4 ГБ | На 2 ГБ заведется, но обработка аудио, видео и Node.js съедают память быстро |
| Диск | 20 ГБ | 40 ГБ | Сам Hermes легкий, но история переписки, логи и скачанные файлы копятся |
| Система | Ubuntu 22.04 / 24.04 LTS | Ubuntu 22.04 / 24.04 LTS | Под нее написан установочный скрипт и все инструкции |
Зарубежные провайдеры
Главный аргумент за зарубежный сервер — с него без плясок работают API моделей. Цены ориентировочные, точные смотрите на сайте.
| Провайдер | Цена | За что брать |
|---|---|---|
| Hetzner Cloud | CX22 — около 4-5 EUR/мес | Лучшее соотношение цены и мощности. Минус — строгая проверка при регистрации |
| DigitalOcean | от $4-6/мес | Самая понятная панель и лучшая документация. Если это ваш первый сервер в жизни |
| Contabo | от 5,50 EUR за 4 vCPU / 6-8 ГБ | Больше всего памяти за доллар. Расплата — диск и поддержка как повезет |
| Vultr | от $6/мес, почасовая оплата | 32 локации и оплата по часам — поднять на выходные, попробовать и снести |
Российские провайдеры
Плюс — оплата обычной картой и поддержка на русском. Минус — прямой доступ к OpenAI и Anthropic с российских адресов обычно закрыт, поэтому модель подключайте через посредника (OpenRouter или Nous Portal).
| Провайдер | Цена | За что брать |
|---|---|---|
| Timeweb Cloud | от 300-600 руб/мес | Самая дружелюбная панель среди российских, есть зарубежные локации |
| RuVDS | от 139 руб за минималку | Ветеран рынка, много площадок, документы для юрлиц |
| Aeza | почасовая оплата | Удобно для экспериментов: включил на вечер, попробовал, выключил |
| Selectel | от нескольких сотен рублей | Взрослый корпоративный провайдер: SLA, бэкапы. Дороже, но чтобы работало и не думать |
Короткий ответ. Есть чем платить за рубеж — берите Hetzner CX22, это лучший баланс. Первый сервер в жизни и хочется, чтобы все объясняли — DigitalOcean. Платить удобнее российской картой — Timeweb и модель через OpenRouter.
Как попасть на сервер
После оплаты провайдер пришлет письмо: IP-адрес, логин root и пароль. Открываете на своем компьютере терминал (на Mac — программа Терминал, на Windows — PowerShell) и вставляете строку со своим адресом:
ssh root@203.0.113.42
Спросит are you sure — отвечаете yes. Потом попросит пароль: вводите вслепую, символы не показываются — это нормально, ничего не сломалось. Все, вы внутри сервера.
Шаг 2. Подготовить сервер
Две минуты скучных команд: обновить систему и завести отдельного жильца, чтобы помощник не хозяйничал с правами администратора.
# обновляем систему и ставим базовые утилиты sudo apt update && sudo apt upgrade -y sudo apt install curl git ca-certificates -y
# заводим отдельного пользователя sudo adduser hermes sudo usermod -aG sudo hermes # переключаемся на него - дальше все делаем от его имени sudo -iu hermes
Почему не под root. Hermes умеет выполнять команды на сервере. Под администратором любая его ошибка (или чужое сообщение боту) может снести систему. Под отдельным пользователем — максимум испортит свою папку.
Шаг 3. Установить Hermes
Одна команда. Установщик сам скачает Python, Node.js и остальные зависимости, заберет код и создаст команду hermes.
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash source ~/.bashrc
Куда все легло — пригодится, когда захотите что-то поправить руками:
| Путь | Что внутри |
|---|---|
~/.hermes/hermes-agent/ |
Сам код программы. Руками не трогаем |
~/.hermes/config.yaml |
Все настройки: модель, инструменты, платформы, расписания |
~/.hermes/.env |
Секреты: API-ключи и токен Telegram-бота |
~/.hermes/auth.json |
Данные входа по подписке (когда логинитесь, а не вставляете ключ) |
~/.hermes/skills/ |
Все инструкции-скиллы. Главное место, куда будете заглядывать |
~/.hermes/plugins/ |
Установленные плагины |
~/.hermes/cron/jobs.json |
Задачи по расписанию |
Если пишет hermes: command not found — выйдите и зайдите на сервер заново (exit, потом снова ssh) либо выполните source ~/.bashrc. Система просто еще не знает про новую команду.
Шаг 4. Подключить модель — вставить голову
Самый важный выбор во всей инструкции: здесь решается, будет помощник умным или бестолковым.
hermes model
Команда покажет список провайдеров и проведет по шагам. Три разумных пути:
| Путь | Деньги | Кому |
|---|---|---|
| Nous Portal рекомендуемый старт |
есть бесплатный вход, дальше подписка | Вход через браузер, ключи вставлять не надо. Одна подписка — доступ к 300+ моделям плюс встроенные внешние инструменты. Команда: hermes setup --portal |
| OpenRouter рабочая лошадка |
платите по факту за токены | Один ключ — доступ к моделям всех вендоров сразу, модель меняется одной строкой. Работает и с российских адресов |
| Своя подписка взрослый режим |
уже оплачено, доплачивать не надо | Если платите за ChatGPT или Claude — подключите подписку напрямую. В hermes model выбираете OpenAI Codex или Anthropic. Второй раз за токены платить незачем |
Грабля, на которую наступают все, кто идет через подписку Claude. В Hermes есть два разных провайдера с похожими именами: openai — это вход по подписке ChatGPT через Codex, а openai-api — обычный ключ OpenAI. Перепутаете — получите невнятную ошибку авторизации, которая выглядит как проблема с ключом. Смотрите на суффикс.
Ключ можно вбить и руками — команда сама разложит секреты в .env, а обычные настройки в config.yaml:
hermes config set OPENROUTER_API_KEY sk-or-xxxxx hermes config set model openrouter/openai/gpt-4o hermes config show
Запасная голова на случай сбоя
Провайдер может лечь или упереться в лимит — тогда Hermes сам переключится на следующего по списку. Это называется fallback-цепочка:
hermes fallback add # добавить запасного провайдера hermes fallback list # посмотреть цепочку
Требование к модели: минимум 64 000 токенов контекста. Контекст — это рабочий стол помощника: чем он меньше, тем чаще приходится сгребать бумаги в сторону и терять детали разговора.
Проверка перед переездом в Telegram
Один раз поговорите с ним прямо в терминале — убедитесь, что голова на месте:
hermes --tui
Спросите что-нибудь проверочное: расскажи, что за сервер, на котором ты запущен: система, память, диск. Хороший знак — он не выдумал ответ, а реально сходил в терминал и показал цифры. Выйти: /quit. Все, терминальная часть закончилась.
Шаг 5. Подключить Telegram — главный шаг
Здесь помощник перестает быть игрушкой в терминале и становится тем, кому вы пишете с дивана.
5.1 — Создать бота
- Откройте @BotFather и отправьте
/newbot - Придумайте имя и уникальный логин, обязательно заканчивающийся на
bot - В ответ придет токен вида
123456789:ABCdef...— это ключ от бота, никому не показывайте
5.2 — Узнать свой ID
Напишите боту @userinfobot — он вернет ваш числовой ID (не @username, а именно число). Запишите.
5.3 — Связать бота с сервером
Мастер спросит платформу (выбирайте Telegram), токен бота, ваш User ID и домашний канал — куда слать результаты задач по расписанию. Для начала укажите туда же свой ID.
hermes gateway setup
То же самое руками — три строки в файле ~/.hermes/.env:
TELEGRAM_BOT_TOKEN=123456789:ABCdefGHIjklMNOpqrSTUvwxYZ TELEGRAM_ALLOWED_USERS=123456789 TELEGRAM_HOME_CHANNEL=123456789
5.4 — Запустить навсегда
hermes gateway install # прописать как системный сервис (автозапуск) hermes gateway start # запустить hermes gateway status # убедиться, что живой
Проверка: закройте терминал, возьмите телефон и напишите боту «привет, ты кто». Ответил — все собралось, дальше терминал вам не нужен. Молчит — вернитесь и посмотрите hermes logs gateway -n 50.
Шаг 6. Как с ним теперь общаться
Обычная переписка. Никаких особых форматов и правильных промптов — говорите как человеку.
| Что | Как |
|---|---|
| Голос, фото, файлы | Можно надиктовать голосовое, скинуть скриншот или документ — он разберет и ответит по сути |
| Слэш-команды | /skills — список умений, /model — сменить модель, /clear — начать разговор заново, /help — что вообще можно |
| Домашний канал | /sethome в любом чате назначает его домашним — туда будут падать отчеты и дайджесты |
| Работа в группе | Чтобы бот отвечал в групповом чате, в BotFather выключите Group Privacy и перезайдите ботом в группу |
| Он помнит вас | Кто вы, чем занимаетесь, как любите оформлять результат — это переживает перезапуск и новый разговор |
| Разговор не бесконечный | Когда тема сменилась — пишите /clear. Иначе он тащит старый контекст и тратит на него деньги |
Шаг 7. Выдать умения — скиллы
Скилл — текстовый файл-инструкция «как делать вот такую задачу». Помощник читает его, только когда задача действительно подвернулась, поэтому их можно иметь много. Ставить можно прямо из Telegram — командой /skills install.
~/.hermes/skills/
└── my-skill/
├── SKILL.md # сама инструкция
├── references/ # справочники, читаются при необходимости
├── templates/ # шаблоны
└── scripts/ # вспомогательные скрипты
Где брать
| Каталог | Что там |
|---|---|
| agentskills.io | Официальный Skills Hub: встроенные, официальные дополнительные и скиллы сообщества. Сотни штук с поиском и установкой в одну команду |
| awesome-hermes-skills | Каталог сообщества на 350+ инструментов с пометками production / beta / experimental |
| awesome-hermes-agent | Вторая независимая подборка: скиллы, плагины, провайдеры памяти, интерфейсы |
| hermeswiki.ru | Русскоязычная вики: установка, команды, каталог скиллов |
hermes skills list # что уже стоит hermes skills browse # витрина официальных hermes skills search youtube # поиск по слову hermes skills inspect official/research/arxiv # посмотреть перед установкой hermes skills install official/research/arxiv # поставить hermes skills uninstall arxiv # удалить hermes skills check # есть ли обновления
С чего начать
| Скилл | Зачем |
|---|---|
plan |
Разложить задачу на шаги до того, как что-то делать. Самый недооцененный |
youtube-full |
Транскрипты и разбор роликов с YouTube без отдельного API-ключа |
github-pr-workflow |
Работа с репозиториями: ветки, коммиты, пул-реквесты |
official/research/arxiv |
Поиск и разбор научных статей |
excalidraw |
Рисовать схемы вместо описания словами |
duckduckgo-search |
Поиск в интернете без отдельного ключа |
official/security/1password |
Достать секрет из хранилища, не держа его в открытом виде |
Самое интересное: скиллы можно не писать
В Hermes есть команда /learn. Показываете ей источник — ссылку на документацию, PDF, папку с проектом, свой же прошлый разговор — а агент сам собирает материал и пишет готовую инструкцию. Дальше она сразу становится новой командой.
/learn документацию по нашему API вот тут: https://docs.example.com/api /learn как я обычно собираю недельный отчет - посмотри наш последний разговор
Это и есть та самообучаемость, ради которой Hermes затевали: помощник наращивает свои умения сам, а не ждет, пока вы сядете их описывать.
Шаг 8. Плагины — подключить внешние сервисы
Если скилл — это инструкция, то плагин — новая способность: код, который добавляет агенту умение работать с конкретным сервисом.
| Встроенный плагин | Что дает |
|---|---|
security-guidance |
Ловит опасный код при записи файлов по набору правил. Включить первым |
disk-cleanup |
Сам убирает временные файлы в конце сессии — сервер не зарастает мусором |
image_gen/openai |
Генерация картинок прямо в переписке |
google_meet |
Заходит на созвоны в Google Meet и делает живую расшифровку |
observability/langfuse |
Подробная телеметрия вызовов модели — для тех, кто хочет видеть внутренности |
kanban/dashboard |
Доска задач для работы нескольких агентов сразу |
hermes plugins search notion # поиск по каталогу сообщества hermes plugins install owner/repo # установка из репозитория hermes plugins enable security-guidance hermes plugins list
Важная деталь про безопасность. Плагины выключены по умолчанию: установка их находит, но ничего не запускается, пока вы явно не включите. Это защита от чужого кода, который начнет работать без спроса.
Шаг 9. Задачи по расписанию
Момент, после которого помощник начинает работать, пока вы спите. Ставится одним сообщением боту: каждый будний день в 9 утра присылай сводку по новостям ИИ, 5 пунктов. Если хочется точности — есть прямая команда:
/cron add "0 8 * * *" "Найди главные новости про ИИ за сутки и пришли 5 пунктов"
hermes cron list # все задачи hermes cron status # работает ли планировщик и когда следующий запуск hermes cron pause # приостановить hermes cron remove # удалить
Расписание — пять чисел: минута час день месяц день-недели. 0 8 * * * — каждый день в 8:00, 0 12 * * 3 — по средам в полдень. Не помните синтаксис — просто попросите словами, он оформит сам.
Как это работает внутри. Шлюз каждую минуту проверяет список задач и запускает те, чье время пришло. Каждая задача выполняется в чистой сессии, без истории ваших разговоров. Поэтому формулируйте самодостаточно: «собери и пришли», а не «сделай то, что мы вчера обсуждали».
Обслуживание — чтобы не развалилось
Восемь команд, которые стоит знать. Заходить на сервер ради них придется редко.
| Команда | Когда нужна |
|---|---|
hermes doctor |
Что-то не работает, а что — непонятно. Проверяет все подряд, есть --fix |
hermes status |
Быстрый ответ: жив ли агент, подключен ли Telegram |
hermes logs gateway -f |
Смотреть в реальном времени, что происходит со шлюзом |
hermes update |
Обновиться. Проект развивается быстро — раз в пару недель не помешает |
hermes backup |
Архив настроек и данных. Сделайте до первого обновления, не после |
hermes insights --days 7 |
Сколько токенов и денег ушло за неделю. Отрезвляет |
hermes sessions list |
История разговоров: посмотреть, выгрузить, почистить |
hermes security audit |
Проверить зависимости на известные уязвимости |
Три правила безопасности. Первое: в TELEGRAM_ALLOWED_USERS только ваш ID. Второе: не запускайте под администратором. Третье: ключи живут в ~/.hermes/.env и нигде больше — не вставляйте их в скиллы, задачи и переписку. И не включайте режим --yolo: он отключает подтверждения перед опасными командами.
Как это выглядит у меня через месяц работы
Все, что выше — фундамент. Дальше начинается то, ради чего это ставилось. Ниже — моя собственная установка: цифры сняты с живого сервера в момент написания статьи, а не взяты из презентации.
Голова и запасные головы
Основная модель — Claude Opus 5, подключенный не по API-ключу, а через подписку. Дальше fallback-цепочка ровно из шага 4: Claude Sonnet 5, затем GPT-5 mini по обычному ключу OpenAI, затем бесплатная модель через Nous.
Смысл цепочки не в экономии, а в том, что дайджест в 8 утра приходит даже когда основной провайдер лежит. Три уровня падения — это уже не эксперимент, а сервис.
Что он делает без меня
Самая полезная деталь, которой нет ни в одном гайде. Три задачи из четырех запускаются в режиме --no-agent: обычный bash-скрипт по расписанию, без вызова модели. Watchdog проверяет сервисы 48 раз в сутки и не тратит ни одного токена. LLM подключается только там, где нужно понимание смысла — в утреннем дайджесте. Если гонять моделью то, что решается скриптом, счет за месяц вас удивит.
Тишина как формат отчета
Watchdog печатает только проблемы. Все в порядке — в Telegram тишина. Это звучит мелочью, но это разница между системой, которой пользуются, и системой, уведомления от которой через неделю отключают. Помощник, присылающий 48 сообщений «все хорошо» в сутки, будет замьючен на третий день.
Куда складываются результаты
108 сессий и 2 688 сообщений в локальной базе, память о том, кто я и как работаю, — в отдельных файлах, которые переживают любой перезапуск. Плюс подключенные через MCP календарь, почта, Google Drive и поиск.
Чему тут стоит поучиться сразу. Ценность не в количестве скиллов, а в том, что результаты складываются в постоянное хранилище, а не растворяются в чате. Помощник, который каждый раз начинает с нуля, — красивый чат-бот. Помощник с накопленной базой — рабочая система.
Если что-то пошло не так
| Симптом | Что делать |
|---|---|
| Бот молчит в Telegram | hermes gateway status, затем hermes logs gateway -n 50 |
hermes: command not found |
Перезайти на сервер или выполнить source ~/.bashrc |
| API key not set | hermes model — заново выбрать провайдера |
| Ошибка 404 при обращении к модели | Модель недоступна у вашего провайдера — выберите другую через hermes model |
| Задачи по расписанию не срабатывают | hermes cron status — планировщик тикает только при работающем шлюзе |
| После обновления пропали настройки | hermes config check, затем hermes config migrate |
| Совсем непонятно | hermes doctor --fix, потом hermes dump для обращения в поддержку |
Словарик
Слова, которые будут попадаться. Все объяснены через быт.
| Термин | Это как… |
|---|---|
| VPS virtual private server |
Арендованная комната в общежитии: дом чужой, но комната ваша и всегда открыта |
| SSH secure shell |
Ключ от этой комнаты: команда ssh открывает дверь и пускает вас внутрь удаленно |
| Терминал | Разговор с компьютером записками вместо кликов мышкой. Пишете строку — он выполняет |
| Сервис systemd service |
Трудовой договор: программа обязана работать всегда и выходить на смену сама после перезагрузки |
| Шлюз gateway |
Секретарь на телефоне: принимает сообщения из Telegram, передает агенту и несет ответ обратно |
| Токен бота | Ключ от почтового ящика. У кого ключ — тот и бот. Поэтому только в .env |
| Контекст context window |
Рабочий стол: бумаг помещается ограниченное число. Кончилось место — старое убирают в сторону |
| Токены | Счетчик воды: платите за объем текста, прошедший через модель, в обе стороны |
| Провайдер модели | Оператор связи: сам не думает, но дает доступ к голове и берет за это деньги |
| Скилл | Памятка на холодильнике: «как варить рис». Читается, только когда собрались варить рис |
| Плагин | Новая насадка на дрель: не инструкция, а физически новая способность |
| Cron | Будильник с поручением: в 8:00 встань и собери мне новости. Каждый день, без напоминаний |
| Fallback | Второй водитель: основной устал — за руль садится следующий по списку |
Где эта инструкция заканчивается
Все, что выше, вы сделаете сами за вечер. Дальше начинается место, где люди чаще всего застревают: бот работает, а пользы от него нет. Он отвечает на вопросы, но ничего не меняет в делах.
Разница между игрушкой и системой — не в количестве установленных скиллов. Она в трех вещах:
- Задача выбрана правильно. Не всякую рутину стоит отдавать модели: половина решается скриптом на 30 строк, дешевле и надежнее. Watchdog из моего кейса — ровно такой случай.
- Результаты складываются в хранилище. Ответ в чате исчезает. База знаний, репозиторий или таблица — остаются и накапливают ценность.
- Есть контур проверки. Агент, который уверенно выдумывает результат и никем не перепроверяется, опаснее отсутствия агента.
Если вы дошли до этого места и думаете «поставил, а дальше что» — это нормальная точка. Именно здесь я обычно и подключаюсь.
Куда дальше
- Официальный Quickstart — короткий путь от нуля до первого ответа
- Настройка Telegram — все тонкости бота, групп и топиков
- agentskills.io — каталог скиллов с поиском
- Плагины и примеры плагинов
- Задачи по расписанию — подробнее про cron
- Справочник команд — полный список
- Репозиторий на GitHub — исходники и README
- Русская вики по Hermes — если английская документация утомляет