Hermes Agent: что это, как установить и настроить

Что такое Hermes Agent

Hermes Agent это агент-помощник, который живет на машине, где его запустили: на ноутбуке, на недорогом VPS или в облаке. Вы пишете ему в терминале, в приложении или в мессенджере, он выполняет команды, работает с файлами, ищет в интернете и присылает результат. Код открыт под лицензией MIT, разработчик Nous Research. Все подробности и команда установки собраны в карточке Hermes Agent в нашем каталоге.

Что он умеет:

• Терминальный интерфейс и приложение Hermes Desktop для Windows и macOS.
• Шлюз для мессенджеров: Telegram, Discord, Slack, WhatsApp, Signal и почта из одного процесса. Голосовые сообщения он расшифровывает.
• Память: запоминает факты о вас и ищет по прошлым разговорам.
• Скиллы: после сложной задачи сам записывает порядок действий в скилл и улучшает его при следующих запусках.
• Задачи по расписанию: ежедневные отчеты, ночные проверки, еженедельные сводки с доставкой в мессенджер.
• Любые модели: подписка Nous Portal, OpenRouter, OpenAI, Anthropic, DeepSeek, Qwen, локальные модели через Ollama или LM Studio и любой OpenAI-совместимый адрес.
• Несколько сред выполнения команд: на самой машине, в Docker, по SSH на другом сервере, в облачных песочницах Modal и Daytona.

Чем Hermes отличается от Claude Code и OpenClaw

Claude Code, Cursor и Codex созданы для работы с кодом: вы открываете проект, ставите задачу и смотрите, как агент правит файлы. Hermes задуман как постоянный помощник. Он может работать на сервере круглые сутки, вы пишете ему с телефона в Telegram, а он по расписанию собирает отчеты и присылает их туда же.

OpenClaw это агент того же класса. Hermes умеет переносить из него настройки одной командой: персону, память, скиллы, настройки мессенджеров и ключи. Как это сделать, описано ниже в разделе про переезд.

Как установить Hermes Agent

Приложение для Windows и macOS

Самый простой путь: скачать установщик Hermes Desktop на официальном сайте. В пакете уже есть агент, Python и все зависимости. На macOS приложение работает только на компьютерах с Apple Silicon (M1 и новее), Mac на процессорах Intel не поддерживаются.

Linux, macOS и WSL2

Установка из терминала одной командой, без приложения:

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

Затем перезагрузите настройки оболочки и запустите агента:

source ~/.bashrc && hermes

Если у вас zsh, вместо ~/.bashrc укажите ~/.zshrc. Приложение Hermes Desktop можно поставить позже командой hermes desktop.

Windows без WSL

Откройте PowerShell и выполните:

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

Файлы окажутся в папке %LOCALAPPDATA%\hermes. Антивирус иногда помечает входящий в установку uv.exe как угрозу. Это ложное срабатывание на менеджер пакетов Python от Astral. В README репозитория есть способ проверить подлинность файла, после проверки добавьте в исключения папку %LOCALAPPDATA%\hermes\bin.

Docker

Сначала создайте папку для данных и пройдите мастер настройки. Ключи и настройки сохранятся в ~/.hermes на хосте:

mkdir -p ~/.hermes && docker run -it --rm -v ~/.hermes:/opt/data nousresearch/hermes-agent setup

Потом запустите агента в фоне как постоянный шлюз для мессенджеров:

docker run -d --name hermes --restart unless-stopped -v ~/.hermes:/opt/data nousresearch/hermes-agent gateway run

Команды на сервер вводите по SSH. Веб-консоли некоторых хостингов искажают при вставке двоеточия и собаки, и команда docker run ломается незаметно.

Android

Для телефонов на процессорах ARM есть пакет для Termux из подписанного репозитория разработчиков. Скрипт установки для компьютеров в Termux не подходит, порядок действий описан в руководстве по Termux на сайте Hermes.

Установщик сам ставит Python, Node.js, ripgrep, FFmpeg и Chromium для управления браузером. Если браузер агенту не нужен, добавьте к команде установки флаг --skip-browser.

Первая настройка: модель и ключи

Запустите мастер настройки:

hermes setup

Он предложит три режима:

• Быстрый: вход в Nous Portal, одна подписка на 300 с лишним моделей и инструменты вроде веб-поиска и генерации картинок.
• Полный: вы сами выбираете провайдера и вводите свои ключи для модели и каждого инструмента.
• С чистого листа: включено только минимальное, остальное вы добавляете сами. Подходит, если нужен полный контроль над тем, что умеет агент.

Сменить модель можно в любой момент командой hermes model или /model прямо в разговоре. Модели нужен контекст не меньше 64 тысяч токенов, с меньшим Hermes не запустится. У облачных моделей Claude, GPT, Gemini, Qwen и DeepSeek его хватает. Для локальной модели в Ollama укажите размер контекста -c 65536.

Ключи и токены Hermes хранит в файле ~/.hermes/.env, остальные настройки в ~/.hermes/config.yaml.

Nous Portal, OpenAI и Anthropic принимают оплату только зарубежной картой. Без нее остаются два пути: локальная модель через Ollama или LM Studio либо любой OpenAI-совместимый шлюз, который Hermes подключает как свой адрес (Custom Endpoint). Такой шлюз с оплатой в рублях делаем и мы: SkillFoxx API дает доступ к GPT, Claude, Gemini и DeepSeek по одному ключу, сейчас он в закрытой бете.

Как подключить Hermes к Telegram

1. Проверьте, что агент нормально отвечает в терминале. Мессенджеры стоит подключать только после этого.
2. Создайте бота у @BotFather в Telegram и скопируйте токен. В приложении Hermes Desktop бота можно создать кнопкой с QR-кодом: Hermes сам создаст бота и запишет токен.
3. Запустите hermes gateway setup и выберите Telegram.
4. Укажите свой числовой ID в TELEGRAM_ALLOWED_USERS. Командовать ботом смогут только перечисленные пользователи, в том числе в группах.
5. Запустите шлюз командой hermes gateway start и напишите боту.

Если бот молчит, проверьте состояние командой hermes gateway status. Для российского мессенджера MAX есть сторонний плагин-шлюз: он расшифровывает голосовые, показывает кнопки выбора модели и подтверждения команд, а таблицы присылает картинками, потому что MAX их не отображает.

Скиллы в Hermes: как искать и ставить

Скилл это папка с файлом SKILL.md: описание задачи и порядок действий, иногда со скриптами. Hermes ставится с набором встроенных скиллов, они лежат в ~/.hermes/skills. Каждый установленный скилл становится командой: /имя-скилла в терминале и в мессенджере.

Искать и ставить новые скиллы:

hermes skills search pdf

hermes skills install https://example.com/my-skill/SKILL.md

Первая команда ищет по каталогам, которые знает Hermes. Вторая ставит скилл по прямой ссылке на SKILL.md вместе с файлами, на которые он ссылается. Перед установкой Hermes проверяет скилл сканером безопасности: ищет скрытые инструкции для модели и попытки вынести ключи.

Скиллы из каталога SkillFoxx прямо в Hermes

Мы открыли для Hermes каталог проверенных скиллов: только с низким и средним уровнем риска, файлы закреплены по конкретной версии в репозитории. Hermes читает его как источник well-known. Посмотреть список:

hermes skills search https://skillfoxx.ru --source well-known --limit 50

Эта команда не ищет по словам, а показывает записи каталога по порядку, поэтому стоит увеличить --limit. Посмотреть скилл перед установкой и поставить его, на примере Humanizer:

hermes skills inspect well-known:https://skillfoxx.ru/.well-known/skills/humanizer

hermes skills install well-known:https://skillfoxx.ru/.well-known/skills/humanizer

Второй способ, через наш установщик. Он проверяет подпись рецепта, до установки показывает уровень риска и кладет скилл туда, где его прочитает Hermes, с учетом профилей и HERMES_HOME:

npx skillfoxx add skills/humanizer --agent hermes --global

Без --global скилл встанет в текущий проект, тогда в корне репозитория выполните hermes skills trust. MCP-серверы установщик прописывает в ~/.hermes/config.yaml, если у записи есть готовый рецепт установки. После этого выполните /reload-mcp в разговоре с Hermes. Если рецепта нет, установщик покажет ссылку на инструкцию в карточке. Подробнее об установщике в отдельной статье.

Все скиллы и MCP-серверы, которые работают с Hermes, с уровнем риска и описанием собраны на странице Hermes Agent в каталоге.

Hermes совместим с открытым стандартом Agent Skills, поэтому ему подходят скиллы, написанные для Claude Code, Codex и других агентов. Если такие скиллы уже лежат у вас в ~/.agents/skills, добавьте эту папку в skills.external_dirs в файле config.yaml, и Hermes подхватит их без копирования. Скиллы из папки проекта он загружает только после команды hermes skills trust внутри проекта.

Какие скиллы и MCP-серверы подключить первыми

Для работы с файлами и задачами:

• Скиллы Anthropic для документов: pdf, docx, xlsx и pptx. Агент собирает отчет в Excel, заполняет документ Word или делает презентацию.
• oh-my-hermes: надстройка специально для Hermes. Превращает размытую просьбу в четкую задачу, выбирает порядок работы и требует показать результат работы.
• Superpowers: если поручаете Hermes программирование. Агент сначала обсуждает задачу и составляет план, потом пишет код и тесты.
• Context7: MCP-сервер с актуальной документацией библиотек, чтобы агент не писал код по устаревшему API.

Для российских сервисов. Здесь пригодится расписание: подключили сервис, поставили задачу, и сводка каждое утро приходит в Telegram.

• MCP-сервер Яндекс Метрики: 26 отчетов по трафику, источникам и целям, только чтение.
• fast-bitrix24-mcp: воронка продаж, сделки в риске, ежедневная сводка и активность менеджеров в Битрикс24.
• MCP-сервер Wildberries для Hermes: 56 инструментов кабинета продавца. Любое изменение идет в два шага: агент показывает план, вы подтверждаете.
• Поиск по Wildberries и Ozon: цены, рейтинги и отзывы товаров без ключей, для сравнения и подбора.
• Скилл YouGile: карточки задач прямо из переписки с агентом, с предпросмотром перед созданием.

Остальные инструменты для российских сервисов собраны в разделе «Российский стек». У каждого в карточке указано, что он умеет менять, и уровень риска.

MCP-серверы подключаются в файле ~/.hermes/config.yaml, в разделе mcp_servers. Пример для Метрики:

mcp_servers:
  yandex-metrika:
    command: npx
    args: ["-y", "github:nikolaymokh-dev/yandex-metrika-mcp"]
    env:
      YANDEX_API_KEY: "ВАШ_ТОКЕН"

Как устроены MCP-серверы и чем они отличаются от скиллов, мы разобрали в отдельной статье.

Задачи по расписанию

Расписание Hermes задается обычной фразой, писать cron-выражения не нужно. Например: «Каждое утро в 9:00 присылай мне в Telegram сводку новых issues в моем репозитории» или «По понедельникам собирай отчет Метрики за прошлую неделю». Результат приходит в тот мессенджер, который вы укажете. Начинайте с расписания, когда агент уже стабильно работает в чате.

Безопасность

Hermes выполняет команды в терминале, работает сам по расписанию и хранит ключи от моделей и мессенджеров. Поэтому в нашем каталоге у него высокий уровень риска. Что стоит настроить сразу:

• Подтверждение опасных команд. По умолчанию включен режим smart: вспомогательная модель пропускает безопасные команды, запрещает явно опасные и спрашивает вас в спорных случаях. Режим manual спрашивает всегда. Режим off и флаг --yolo отключают проверку совсем, их лучше не включать.
• Изоляция. Команда hermes config set terminal.backend docker запускает все команды агента в отдельном контейнере Docker.
• Список пользователей. В каждом мессенджере разрешите доступ только своим аккаунтам.
• Отдельные токены. Для Метрики, CRM и маркетплейсов выпускайте токены с минимальными правами, лучше только на чтение.
• Расписание без подтверждений. В задачах по расписанию опасные команды по умолчанию блокируются: подтвердить их некому. Оставьте так.

Переезд с OpenClaw

Сначала посмотрите, что будет перенесено, ничего не меняя:

hermes claw migrate --dry-run

Затем перенесите по-настоящему командой hermes claw migrate. Переедут персона из SOUL.md, память, ваши скиллы, список разрешенных команд, настройки мессенджеров и ключи. Чтобы перенести все, кроме ключей, добавьте --preset user-data. При первой настройке hermes setup сам находит папку ~/.openclaw и предлагает перенос.

Если что-то не работает

• hermes: command not found: перезагрузите оболочку командой source ~/.bashrc или проверьте PATH.
• Пустые или странные ответы: заново выберите провайдера и модель в hermes model.
• Бот в мессенджере молчит: проверьте токен и список разрешенных пользователей, затем hermes gateway status.
• Непонятная ошибка: запустите hermes doctor, он покажет, чего не хватает и как это исправить.