Hermes Agent помогает выполнять задачи на компьютере: разбирать материалы, искать сведения, готовить файлы и запускать повторяющуюся работу по расписанию. Это руководство объясняет его возможности и навыки, проводит через установку и помогает получить первый результат на простом примере с заметками.

📌
Проверено 10 ноября 2026 года по официальной документации и релизу v0.23.0 от 5 ноября 2026 года. Руководство подготовлено по источникам: установка и сценарии не проверялись отдельным практическим запуском. После шагов указано, как проверить результат у себя.

Что такое Hermes и кому он пригодится

Hermes Agent — программа с открытым исходным кодом от Nous Research. Вы описываете задачу обычным языком. Агент обращается к выбранной ИИ-модели, использует доступные инструменты и возвращается с результатом или уточняющим вопросом.

Например, вы даёте папку с заметками и просите составить обзор. Hermes открывает файлы, читает их и собирает ответ. Для новостной сводки ему понадобятся поиск и чтение сайтов. Если сводка нужна каждое утро, эту работу можно поставить в расписание.

Hermes пригодится для задач с несколькими действиями и повторяющейся работы. Для разового текстового вопроса привычного чата с ИИ может хватить. Здесь потребуется настройка модели, инструментов и доступов. Программировать для обычного общения с агентом не обязательно; при установке иногда нужно открыть терминал и выполнить команды.

Что ему можно поручить

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

Ваша задачаЧто делает агентЧто нужно подготовить
Разобраться в папке с заметкамиЧитает текстовые файлы, кратко описывает их и группирует по темамКопии материалов в отдельной папке
Собрать сведения по темеИщет источники, открывает страницы и готовит обзор со ссылкамиРабочий веб-поиск и понятный вопрос
Подготовить документ, таблицу или презентациюИспользует подходящий навык и программы для нужного форматаИсходные данные, требования и необходимые зависимости навыка
Обработать много однотипных файловПишет и выполняет скрипт для заданной операцииТестовые копии файлов и правило обработки
Собрать сведения с сайтаОткрывает страницы и выполняет действия в браузереНастроенный браузер; для закрытого сайта — разрешённый вход
Получать сводку каждое утроЗапускает задачу по расписанию и доставляет ответ в мессенджерРаботающий шлюз, источники и настроенная доставка

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

Агент умеет разделять большую задачу между дополнительными исполнителями — субагентами. Для первого знакомства это не требуется: сначала проверьте одну задачу целиком.

Модель, инструменты, память и навыки

У этих частей разные задачи. Разберём их на примере еженедельного обзора новостей.

ЧастьЗа что отвечаетПример
МодельРазбирает запрос, выбирает действия и формирует ответРешает, какие найденные новости соответствуют вашей теме
ИнструментыВыполняют отдельные действияИщут новости, открывают страницы, сохраняют файл
ПамятьСохраняет небольшие устойчивые сведения о вас и работеВы интересуетесь применением ИИ в небольших командах
Навык, или скиллОписывает порядок выполнения повторяющейся задачиКакие источники читать, как отбирать новости, в каком виде собирать обзор
РасписаниеОпределяет время запускаКаждый понедельник в 09:00

Модель выбирается отдельно от Hermes. Один и тот же агент может обращаться к разным провайдерам; качество выполнения задачи зависит и от модели, и от доступных инструментов.

Навыки: как задать привычный порядок работы

Что находится внутри навыка

Навык — сохранённая инструкция для определённой работы. Основной файл называется SKILL.md. В нём описаны назначение, порядок действий и требования к результату. Рядом могут лежать шаблоны, примеры и вспомогательные скрипты.

Допустим, вам каждый раз нужен одинаково устроенный обзор: пять новостей, по два предложения на каждую, ссылка на первоисточник и отдельная отметка о непроверенных сведениях. Эти правила можно сохранить в навыке, чтобы не переписывать их в каждом запросе.

Навык помогает повторять порядок работы. Проверять полученные факты и файлы всё равно нужно.

Какие навыки бывают

Часть навыков поставляется с Hermes, другие устанавливаются из каталогов. В v0.23.0 работа с Word, PowerPoint и Excel объединена в навык microsoft-office, как указано в описании релиза.

Для своих задач можно создать навыки «Обзор новостей» с правилами отбора и ссылками, «Редактор» с требованиями к тексту или «Карточка проекта» для разбора заметок. Это примеры пользовательских навыков: в стандартной установке они не обещаны под этими названиями.

Как посмотреть и добавить навыки

В терминале выполните:

hermes skills list
hermes skills browse

Первая команда показывает установленные навыки, вторая открывает каталог. Искать можно по теме; например, по английскому слову writing — «работа с текстом»:

hermes skills search writing

Выберите результат и скопируйте его точный идентификатор из каталога. Вместо ИСТОЧНИК/ПУТЬ в следующих командах подставьте этот идентификатор:

hermes skills inspect ИСТОЧНИК/ПУТЬ
hermes skills install ИСТОЧНИК/ПУТЬ

Сначала прочитайте описание, требования и содержимое навыка. При установке выполняется автоматическая проверка безопасности, но она не гарантирует, что сторонняя инструкция безошибочна или безопасна для вашей задачи.

Проверка: повторите hermes skills list и найдите установленный навык. В чате каждый доступный навык можно вызвать командой вида /имя-навыка, добавив задачу. Имя берите из своего списка. Hermes также может сам выбрать подходящий навык по описанию запроса.

Навык не подключает аккаунты автоматически и не заменяет недостающие программы. Если ему нужна работа с почтой, браузером или внешним сервисом, соответствующие доступы и инструменты придётся настроить отдельно.

Что означает «самообучающийся»

Hermes может сохранить найденный способ решения в навык и доработать его при следующем использовании. В память он записывает полезные сведения о пользователе, проектах и рабочей среде. Это накопление инструкций и контекста; автоматическое переобучение самой языковой модели здесь не подразумевается.

Например, вы исправили формат обзора и попросили всегда показывать даты источников. Агент может учесть это в инструкции для следующих обзоров. Проверять нужно и сохранённые правила: ошибка в навыке способна повторяться вместе с ним.

Практический способ создать свой навык показан ниже, после первого задания.

Где работает Hermes и что оплачивается

Hermes запускается на вашем компьютере или сервере. Общаться с ним можно в приложении, терминале или мессенджере. Telegram передаёт сообщения агенту; задачи выполняются там, где работает Hermes. Спящий или выключенный ноутбук не сможет выполнять утреннюю сводку.

В v0.23.0 общий фоновый процесс — шлюз, или gateway — обслуживает разговоры, интерфейсы и расписание. Появился и доступ к рабочему пространству через браузер; он выключен по умолчанию. Для первого запуска его включать не нужно.

Расходы зависят от способа подключения:

  • Модель: поддерживаемая подписка или оплата запросов по API — программному интерфейсу провайдера.
  • Дополнительные сервисы: поиск, генерация изображений и другие действия могут оплачиваться отдельно. Nous Portal объединяет модель и набор инструментов через Tool Gateway; состав и лимиты проверяйте в условиях провайдера.
  • Сервер: оплачивается отдельно, если вы решите арендовать его для постоянной работы.

Начните с ручных запусков и проверьте расход в кабинете провайдера. Частые задания и субагенты увеличивают число обращений к модели.

⚠️
Установка на своём компьютере не означает, что все данные остаются на нём. При работе с облачной моделью прочитанные агентом материалы могут попасть в запрос к провайдеру. Для знакомства используйте несекретные копии файлов. Просьба в чате «ничего не удаляй» не заменяет ограничения доступа средствами системы.

Что подготовить для первого запуска

Достаточно компьютера, доступа к модели и трёх небольших текстовых файлов. Telegram, сервер и Docker можно подключить позже.

  • Компьютер: для Desktop v0.23.0 нужны macOS 13 или новее на Apple Silicon либо 64-разрядная Windows. Intel Mac в текущей документации не поддерживается. На Linux можно установить командную строку.
  • Аккаунт провайдера: в мастере выбирается Nous Portal, поддерживаемая подписка или собственный API-ключ. Условия своего аккаунта проверяйте до подключения.
  • Отдельная папка: положите в неё только учебные файлы. Надёжнее запускать Hermes под отдельной учётной записью без доступа к личным документам.

Для установки из исходников на Linux нужны Git, curl, tar и средства проверки SHA-256; системные библиотеки зависят от дистрибутива. Другие требования и варианты систем перечислены в инструкции установки и списке платформ.

Установка и выбор модели

Шаг 1. Установите программу

macOS и Windows: приложение. Скачайте пакет для своей системы с официального сайта Hermes. На Mac откройте DMG и перенесите Hermes в «Программы». На Windows откройте файл .appinstaller штатным установщиком приложений. Полные пакеты содержат агент и необходимые основные компоненты.

После установки откройте Hermes. Настройте провайдера в приложении; для доступа к инструментам командной строки откройте терминал вашей системы.

Linux, macOS или WSL2: командная строка. Терминал — окно, куда вводят команды. В macOS его можно найти поиском по слову «Терминал», в Linux — через меню приложений. WSL2 — среда Linux в Windows; этот вариант подходит, если она у вас уже настроена.

⚠️
Следующие команды скачивают и сразу запускают установочный скрипт. Используйте только официальный адрес. При необходимости сначала откройте скрипт и изучите его. Не запускайте весь установщик от имени администратора: системные зависимости при необходимости устанавливаются отдельно.

В терминале Linux, macOS или WSL2 выполните:

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

Windows без приложения. Откройте PowerShell через меню «Пуск» и выполните:

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

После завершения закройте и заново откройте терминал. Это позволяет оболочке увидеть установленную команду. Если вы устанавливали Desktop, сделайте это после установки приложения.

Выполните команды по очереди:

hermes --version
hermes doctor

Проверка: первая команда показывает номер версии, вторая выводит диагностику. Исправьте ошибки, мешающие запуску; предупреждения о необязательных, ещё не настроенных интеграциях разбирайте по мере их подключения.

Шаг 2. Подключите модель

Если мастер настройки ещё не завершён, запустите:

hermes setup

Для выбора или замены провайдера и модели используйте:

hermes model

Следуйте подсказкам: выберите провайдера, войдите в аккаунт или вставьте выданный им API-ключ. Если выбираете API, ключ создаётся в кабинете этого провайдера. Он даёт доступ к вашему лимиту или балансу: не отправляйте его в переписку и не показывайте на скриншотах.

С подпиской Nous Portal предусмотрен отдельный путь:

hermes setup --portal

Он открывает вход через браузер и настраивает провайдера вместе с Tool Gateway: поиском, генерацией изображений, синтезом речи и браузерными инструментами. Актуальные варианты доступа перечислены в официальном быстром старте.

Если выберете минимальную настройку Blank Slate, многие функции, включая память и навыки, будут выключены. Это полезно для точного контроля, но их потребуется включать отдельно. Доступные наборы инструментов настраиваются командой hermes tools.

Локальную модель можно подключить без облачного провайдера, но для новичка это дополнительная настройка. Hermes требует окно контекста не меньше 64 000 токенов — объёма текста, который модель способна учитывать за один запрос. Памяти компьютера должно хватать и на модель, и на этот контекст. Внешние поиск и интеграции при этом всё равно могут обращаться в сеть.

Шаг 3. Откройте чат

В приложении создайте разговор. В терминале запустите:

hermes --tui

Классический интерфейс запускается командой hermes. Проверьте выбранную модель и доступные инструменты.

Перед работой с файлами включите ручное подтверждение команд, которые Hermes помечает как опасные. Команду ниже выполните в обычном терминале, затем откройте новый разговор:

hermes config set approvals.mode manual

Это не запрос разрешения на каждое действие. Некоторые операции и инструменты имеют другие правила; ограничения доступа к файлам нужно задавать средствами системы.

Проверка: отправьте короткое сообщение и дождитесь ответа без ошибки. Затем переходите к заданию с файлами.

Первая задача: разобраться в папке с заметками

Задача: получить обзор нескольких файлов и проверить, правильно ли агент их понял. Веб-поиск и сторонние навыки для этого не нужны.

Подготовьте три учебных файла

В Проводнике Windows или Finder на Mac создайте папку hermes-start. На Linux используйте файловый менеджер. Внутри создайте три обычных текстовых файла; для сохранения используйте Блокнот или другой текстовый редактор в режиме простого текста:

  • meeting.txt: «Во вторник обсудить новый сайт. К встрече собрать три примера страниц, которые нравятся».
  • ideas.txt: «Проверить, можно ли собирать еженедельный обзор новостей по нашей теме».
  • reading.txt: «Прочитать руководство по резервным копиям. Выписать, какие папки нужно сохранять».

Скопируйте полный путь к папке. Он может выглядеть как C:\Users\YourName\Desktop\hermes-start в Windows или /Users/yourname/Desktop/hermes-start на Mac. Подставляйте свой путь, не копируйте эти примеры буквально.

Пример рассчитан на работу с файлами вашего компьютера в режиме local. Если вы уже выбрали Docker, агент видит файловую систему контейнера: сначала подключите учебную папку по разделу о Docker ниже.

Передайте задачу

Замените текст в квадратных скобках своим путём. Отправьте запрос в чат Hermes.

Промпт:

Прочитай три текстовых файла в папке [полный путь к hermes-start].

Для каждого файла напиши одно предложение о его содержании.
Затем сгруппируй заметки по темам и составь список действий, которые в них прямо названы.

Не придумывай сроки, приоритеты или ответственных, которых нет в файлах.
Ничего не изменяй, не создавай, не перемещай и не удаляй.
Не читай файлы за пределами указанной папки.
Если какой-то файл прочитать не удалось, сообщи об этом отдельно.

Проверьте результат

В ответе должны быть все три имени файлов. Сравните пересказ с оригиналами: упомянуты ли три примера страниц, обзор новостей и резервные копии. Из «во вторник» агент не должен самостоятельно выводить календарную дату. Убедитесь, что файлы остались без изменений.

Если агент заявил, что не может читать папку, проверьте путь и наличие файловых инструментов через hermes tools. Если у macOS появился запрос доступа к папке, разрешайте только необходимое. При Docker проверьте подключённый путь внутри контейнера.

Ограничение: здесь проверяется чтение простых текстов. PDF со сканами, таблицы и презентации потребуют других инструментов.

После задания выйдите из терминального чата и проверьте возврат к разговору:

hermes -c

Если разговор не найден, посмотрите список командой hermes sessions list и убедитесь, что используете тот же профиль. Профиль — отдельный комплект настроек, памяти и истории.

Собственный навык: повторять удачный разбор

Когда ответ вас устроит, уточните правила в том же разговоре и попросите сохранить их. Создавать навык имеет смысл после проверки результата: иначе он закрепит ещё не проверенный порядок действий.

Промпт:

Создай навык notes-review для разбора папки с текстовыми заметками по только что проверенному примеру.

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

Сохрани инструкцию как навык и покажи, где находится SKILL.md и что в нём записано.
Не включай в навык содержимое моих заметок, пароли и другие личные данные.

Если инструменты навыков отключены, включите их через hermes tools. Проверьте появление notes-review командой hermes skills list, откройте показанный файл и прочитайте инструкцию. Фраза агента «сохранил» сама по себе не подтверждает запись.

После сохранения попробуйте навык на другой папке с учебными текстами.

Промпт:

/notes-review Разбери текстовые заметки в папке [полный путь к другой учебной папке].

Проверка: агент соблюдает тот же формат и ограничения, перечисляет реально прочитанные файлы. Если вы включили одобрение записи навыков, сначала нужно принять предложенное изменение по следующему разделу.

Контроль памяти и изменений навыков

В стандартном профиле память хранится в ~/.hermes/memories/MEMORY.md и USER.md, навыки — в ~/.hermes/skills/. Знак ~ обозначает домашнюю папку пользователя. У отдельных профилей свои каталоги.

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

hermes config set memory.write_approval true
hermes config set skills.write_approval true

Изменения могут попасть в очередь. В чате посмотрите её и примите конкретную запись:

/memory pending
/memory approve ID
/skills pending
/skills diff ID
/skills approve ID

Вместо ID подставьте идентификатор из соответствующего списка. Для отклонения есть /memory reject ID и /skills reject ID. Для просмотра полного изменения навыка удобнее терминал или панель управления.

Новая сессия получает обновлённую память; уже открытая беседа может использовать прежний снимок. Проверяйте сохранённый факт в новом разговоре. Память ограничена по объёму и может содержать ошибки.

Навыки также обслуживает куратор. hermes curator run --dry-run показывает предлагаемые изменения без применения, hermes curator rollback --list — доступные снимки. hermes curator rollback восстанавливает снимок: более новые правки могут потеряться.

Ещё один сценарий: обзор по источникам

Задача: разобраться в конкретной теме и получить проверяемые ссылки. На входе нужны тема, вопрос и несколько адресов источников. Требуются включённые инструменты поиска и чтения сайтов; настройте их через hermes tools или Tool Gateway.

Для первого опыта лучше самостоятельно выбрать три страницы: тогда вы сможете проверить, что агент прочитал именно их.

Промпт:

Прочитай эти три страницы:
[ссылка 1]
[ссылка 2]
[ссылка 3]

Вопрос, на который нужен ответ: [ваш вопрос].

Подготовь короткий обзор. Для каждого существенного утверждения дай ссылку на страницу, которая его подтверждает.
Отдельно перечисли расхождения между источниками и вопросы, на которые в них нет ответа.
Если страница не открылась, сообщи об этом. Не восстанавливай её содержание по догадке.
Ничего не публикуй и не отправляй другим людям.

Результат: обзор, по которому можно вернуться к источникам. Откройте ссылки и выборочно проверьте, действительно ли страницы подтверждают написанное.

Ограничение: агент может ошибиться в пересказе, дата страницы может оказаться старой, а часть сайтов — недоступной. Наличие ссылки ещё не доказывает утверждение. Для важных решений проверяйте исходный текст.

Telegram: общаться с агентом с телефона

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

Через приложение

В Desktop откройте Messaging → Telegram, нажмите Create with QR и следуйте подсказкам. Этот путь создаёт бота, определяет ваш ID и сохраняет настройки. Он описан в руководстве Telegram.

Здесь речь о самостоятельно установленном Hermes. В Hermes Cloud с Team Gateway подключение другое: используйте привязку аккаунта в Nous Portal.

Вручную через BotFather

  1. Откройте @BotFather, отправьте /newbot, задайте имя и уникальное имя пользователя с окончанием bot.
  2. Сохраните выданный токен. Он позволяет управлять ботом. При утечке отзовите его через /revoke у BotFather.
  3. Узнайте свой числовой ID через @userinfobot. Для доступа Hermes нужен этот ID, а не имя вида @username.
  4. В терминале выполните команду ниже, выберите Telegram и вставьте токен и ID в мастер.
hermes gateway setup

Если вводите настройки вручную, они находятся в ~/.hermes/.env:

TELEGRAM_BOT_TOKEN=ВАШ_ТОКЕН_ОТ_BOTFATHER
TELEGRAM_ALLOWED_USERS=ВАШ_ЧИСЛОВОЙ_ID

Значения справа замените своими. Несколько разрешённых ID разделяются запятой. Не используйте *, если не собираетесь сознательно открывать доступ всем.

После настройки проверьте hermes gateway status. Если шлюз ещё не работает, запустите его в терминале:

hermes gateway run

Напишите боту простое сообщение. Когда получите ответ, отправьте /sethome: этот чат станет домашним каналом для результатов задач по расписанию.

Проверка: бот отвечает вашему аккаунту. Не запускайте второй независимый шлюз с тем же токеном: это мешает получению сообщений.

Для добавления другого человека есть сопряжение: hermes pairing list показывает записи, hermes pairing approve telegram КОД принимает код, hermes pairing revoke telegram USER_ID отзывает доступ. Подставляйте значения из своей установки.

В группе обычные сообщения доступны при отключённом Group Privacy в BotFather или с правами администратора. После изменения приватности удалите бота из группы и добавьте снова. Участники должны знать, что агент получает переписку. Право читать сообщения и право вызвать агента настраиваются отдельно.

Задача по расписанию: утренняя сводка

Задача: получать утром новости по выбранной теме. Понадобятся веб-поиск, работающий шлюз, Telegram и домашний канал, заданный через /sethome.

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

Промпт:

Создай задачу ai-digest на паузе.

Расписание: каждый день в 09:00, часовой пояс Europe/Moscow.
Задача: найти в Hacker News до пяти новостей об ИИ-агентах за последние сутки. Для каждой дать заголовок, одно предложение пояснения и ссылку. Если подходящих новостей меньше пяти, не дополнять список старыми.
Доставка: мой домашний канал Telegram.

Покажи настройки и оставь автоматические запуски выключенными до моей проверки.

Вариант создания из терминала:

hermes cron create "0 9 * * *" \
  "Найди в Hacker News до пяти новостей об ИИ-агентах за последние сутки: заголовок, одно предложение пояснения, ссылка. Не дополняй список старыми новостями" \
  --timezone Europe/Moscow --deliver telegram --name ai-digest --paused

В PowerShell такую команду вводите одной строкой без символов \ в конце строк. Если задача уже создана через чат, повторно создавать её в терминале не нужно.

Проверьте список, вручную запустите задачу, дождитесь сводки и только после проверки включите расписание:

hermes cron list
hermes cron run ai-digest
hermes cron resume ai-digest

Проверка: сводка пришла в Telegram, ссылки открываются, hermes cron list показывает следующий запуск в ожидаемое время. Команда run ставит выполнение на ближайший такт планировщика; сообщение может прийти не сразу.

Для управления используйте:

hermes cron pause ai-digest
hermes cron cancel ai-digest
hermes cron remove ai-digest

pause приостанавливает будущие запуски. cancel останавливает уже выполняющийся запуск. remove удаляет саму задачу. Выбирайте нужное действие; выполнять все три подряд не требуется.

Ограничение: при остановленном шлюзе агентная сводка не выполнится. Проверка ссылок расходует время, запросы к модели — лимит или деньги. Каждый обычный запуск начинает новую сессию; правила постоянного формата лучше закреплять в навыке и прикреплять его к задаче.

Технические настройки: когда они понадобятся

Для первого разбора заметок достаточно предыдущих разделов. Дальше — постоянная работа, изоляция и обслуживание. Настраивайте их по мере необходимости.

Как устроена система

flowchart LR
  U["Вы: приложение, терминал, Telegram"] --> G["Общий шлюз Hermes"]
  C["Задачи по расписанию"] --> G
  G --> A["Агент: выполняет задачу"]
  A --> M["Выбранная ИИ-модель"]
  A --> T["Инструменты: файлы, поиск, браузер, команды"]
  A --> H["Память, навыки, история"]
  T --> E["Среда команд: компьютер, Docker или SSH"]

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

Основные настройки находятся в ~/.hermes/config.yaml, API-ключи и токены — в ~/.hermes/.env. Данные авторизации также могут храниться в auth.json. Команда hermes config set направляет значение в соответствующий файл. Для отдельного профиля используйте его собственный каталог данных.

Как оставить шлюз работать постоянно

На macOS и обычном Linux-компьютере установите пользовательскую службу. На Windows та же команда регистрирует запуск при входе:

hermes gateway install
hermes gateway start
hermes gateway status

На Linux-сервере системная служба стартует при загрузке и работает от имени пользователя установки. Управление службой требует административных прав:

sudo hermes gateway install --system
sudo hermes gateway start --system
sudo hermes gateway status --system

Выберите один вариант: одновременная установка пользовательской и системной служб создаёт неоднозначность. Выдавать самому агенту неограниченные права sudo не требуется.

В WSL, контейнере и Termux используйте hermes gateway run в подходящем менеджере процессов. Если установлен tmux:

tmux new -s hermes 'hermes gateway run'

Чтобы выйти без остановки процесса, нажмите Ctrl+B, затем D. После перезагрузки это не запустит шлюз заново. В контейнере обычно нужен запуск шлюза как основного процесса с политикой перезапуска контейнера.

Проверка: бот отвечает после закрытия терминала; отдельно проверьте перезагрузку. Спящий ноутбук задания не выполняет. Различия систем описаны в руководстве шлюза.

Как выполнять команды в Docker

Docker запускает команды агента в контейнере — отдельной среде с собственной файловой системой. Для этого Docker должен быть установлен, запущен и доступен пользователю Hermes. Проверить доступ можно командой docker info.

⚠️
Папка компьютера, подключённая к контейнеру с правом записи, остаётся доступна для изменения и удаления. В контейнерных средах Hermes пропускает обычную проверку опасных команд. Не рассчитывайте на approvals.mode: manual как на защиту подключённых папок. На старте передавайте исходники только для чтения и выделяйте отдельную папку для результата.

Включение среды для команд:

hermes config set terminal.backend docker

Ниже пример для Linux-пользователя hermes. Создайте папки projects и .hermes/cache/documents в его домашнем каталоге; положите учебную папку в projects. Замените /home/hermes своим абсолютным путём. В Windows используйте пути по правилам Docker Desktop.

Сделайте копию config.yaml и обновите нужные разделы, сохранив остальные настройки. Не создавайте второй terminal, если он уже есть.

terminal:
  backend: docker
  container_cpu: 1
  container_memory: 4096
  container_persistent: true
  docker_persist_across_processes: true
  docker_mount_cwd_to_workspace: false
  docker_volumes:
    - "/home/hermes/projects:/workspace/projects:ro"
    - "/home/hermes/.hermes/cache/documents:/output"
  docker_forward_env: []

approvals:
  mode: manual

memory:
  write_approval: true

skills:
  write_approval: true

В этом примере исходники доступны в /workspace/projects только для чтения, результат пишется в /output. Выделены одно ядро и 4 ГБ памяти; соотнесите их с возможностями хоста.

Файлы сохраняются между сессиями. При обычных настройках контейнер разделяют сессии профиля и его субагенты. После перезагрузки хоста файлы могут сохраниться, процессы придётся запускать заново.

Пустой docker_forward_env не добавляет секреты через этот список. Отдельно проверьте, что передают навыки и другие настройки. Режим manual действует только там, где применимы подтверждения; внутри Docker обычная проверка опасных команд пропускается.

Откройте новую сессию. Попросите выполнить cat /etc/os-release и hostname, сравните вывод с хостом и проверьте чтение /workspace/projects. Для первого задания с заметками укажите уже путь внутри контейнера.

Файлы в Telegram отправляет шлюз на хосте. Если агент создал /output/report.txt, путь доставки в приведённом примере — MEDIA:/home/hermes/.hermes/cache/documents/report.txt. Один путь виден контейнеру, другой — шлюзу.

Для передачи отдельных ключей существует список docker_forward_env. Значения из него доступны коду в контейнере. Дополнительный прокси подмены ключей настраивается через hermes egress setup и hermes egress start; перед подключением изучите его документацию. Другие среды, включая SSH, Modal, Daytona и Vercel Sandbox, описаны в конфигурации Hermes.

Прокси для Telegram

Если машина с Hermes не может подключиться к Telegram API, в существующий config.yaml можно добавить настройку прокси:

telegram:
  proxy_url: "socks5://127.0.0.1:1080"

Этот адрес подходит только если такой прокси действительно работает на той же машине. Подставьте свой адрес. Поддерживаются http, https и socks5. После изменения перезапустите шлюз и проверьте ответ бота.

Наблюдение за сервером без обращения к модели

Для проверки числового порога достаточно готового скрипта. Режим --no-agent запускает его по расписанию и пересылает вывод. Пустой вывод означает отсутствие сообщения; ошибка или превышение времени выполнения вызывают уведомление.

Для Linux-сервера можно попросить подготовить скрипт memory-watchdog.sh, который выводит сообщение при занятой оперативной памяти выше 85%. Пусть агент сначала покажет код и способ расчёта, сохранив скрипт в ~/.hermes/scripts/. Проверьте, что он измеряет память нужной машины, особенно если используется Docker.

Проверьте скрипт вручную, затем создайте задачу на паузе:

hermes cron create "every 5m" --no-agent --script memory-watchdog.sh \
  --deliver telegram --name memory-watchdog --paused
hermes cron run memory-watchdog

Для проверки сообщения временно снизьте порог, затем верните 85%. После успешной проверки включите задачу: hermes cron resume memory-watchdog. Ошибки скрипта и доставки помогает найти hermes cron doctor.

Ограничение: регулярные проверки не расходуют токены модели. Подготовка скрипта с помощью ИИ расходует её лимит. Хост, скрипт и доставка должны работать.

Безопасность и ограничения

Перед подключением важных данных проверьте правила безопасности Hermes:

  • Работайте с минимальными правами. На сервере используйте отдельного пользователя; для команд — ограниченную среду.
  • Сначала проверяйте изменения на копиях. Указание папки в тексте задания не ограничивает права процесса.
  • В TELEGRAM_ALLOWED_USERS держите только нужные ID. Доступ к агенту может означать доступ к его инструментам и данным.
  • Оставьте smart или manual. Подтверждения не охватывают все действия; off и --yolo убирают обычные запросы разрешения.
  • Подключайте сервисы постепенно. Навыки, плагины и MCP-серверы проверяйте по источнику, требованиям и правам. MCP — способ подключения внешних инструментов.
  • На Linux и macOS закройте файл ключей от других пользователей: chmod 600 ~/.hermes/.env. Остальные файлы авторизации и резервные копии тоже содержат секреты.
  • Чужая страница или документ могут содержать инструкции, пытающиеся заставить агента раскрыть данные или выполнить лишнее действие.
  • Проверяйте факты, расчёты и созданные файлы. Выполненная команда не гарантирует правильность результата.

Обновление и резервные копии

Перед обновлением сохраните данные. В терминале проверьте наличие обновления, затем выполните обновление с полной резервной копией:

hermes update --check
hermes update --backup
hermes doctor
hermes gateway status

После обновления откройте чат и напишите боту. Если шлюз не перезапустился, используйте hermes gateway restart; системной службе Linux могут потребоваться административные права. Не запускайте второй процесс вместо проверки существующей службы.

Отдельную полную копию создаёт hermes backup. Она включает настройки, авторизацию, навыки и историю; храните архив как секрет. Перед восстановлением остановите шлюз. Команда hermes import ПУТЬ_К_АРХИВУ заменяет существующие файлы данными из архива, поэтому сначала сохраните текущее состояние.

Способ обновления зависит от установки. В текущем справочнике команд для исходников указан канал main: он не равен последнему стабильному тегу GitHub. У готовых пакетов свой механизм; Microsoft Store обновляет пакет через Store.

Если у вас старая установка

Перед обновлением прочитайте примечания к v0.23.0. Для этого руководства существенны такие изменения:

  • Разговоры обслуживает общий шлюз. Если осталось несколько старых шлюзов по профилям, предварительная проверка — hermes gateway migrate --multiplex --dry-run. При конфликтах токенов и портов сначала разберите отчёт.
  • Старые браузерные команды вида browser_navigate и browser_click заменены на browser_exec. Обновите собственные инструкции, если они обращаются к удалённым инструментам.
  • Навыки Word, PowerPoint и Excel объединены в microsoft-office. Старые копии могут остаться на диске; проверьте дубли перед удалением.
  • MCP-сервер Hermes вынесен в плагин: hermes plugins install mcp-serve, затем hermes mcp-serve. Подключение внешних серверов описано в документации MCP.
  • Импорт из других агентов и Singularity/Apptainer используют отдельные плагины. Не переносите секреты вслепую: начните с предусмотренного предварительного просмотра.

Новая беседа начинается через /new или /reset. В v0.23.0 команда /rewind позволяет вернуться к раннему сообщению и создать ветку разговора. Она не отменяет выполненные действия в файлах и сервисах.

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

Что произошлоЧто проверитьСледующее действие
hermes: command not foundТерминал открыт до установкиЗакройте и откройте терминал; на bash можно выполнить source ~/.bashrc, на zsh — source ~/.zshrc
Агент не отвечает или получает ошибку доступа к моделиПровайдер, авторизация, модель и лимит аккаунтаПовторите hermes model, затем проверьте обычный чат
Агент не читает учебную папкуПолный путь, права, файловые инструменты, выбранная средаПроверьте hermes tools; для Docker используйте путь подключённой папки внутри контейнера
Навык не появилсяОн не сохранён, отключён или ждёт одобренияПроверьте hermes skills list и /skills pending
Новый разговор не помнит сохранённый фактЗапись отсутствует или ждёт одобренияПроверьте файл памяти и /memory pending; начните новую сессию после сохранения
Бот молчитТокен, разрешённый ID, состояние шлюзаhermes gateway status, затем при необходимости hermes gateway setup
Бот не видит обычные сообщения группыПриватность Telegram и фильтры HermesПроверьте Group Privacy; после изменения заново добавьте бота
Задача по расписанию не сработалаШлюз, часовой пояс, пауза, ошибка последнего запускаhermes cron list, hermes cron status, hermes cron doctor
Файл из Docker не приходит в TelegramШлюзу недоступен путь контейнераПишите в общую папку и указывайте путь хоста для доставки
Локальная модель отклоненаОкно контекста меньше 64 000 токеновНастройте контекст по документации среды: например, --ctx-size 65536 для llama.cpp

Начните диагностику с hermes doctor. Затем проверьте модель, нужный инструмент и шлюз. Журналы открываются командой hermes logs. Не публикуйте их целиком без проверки: там могут оказаться пути, содержимое запросов и другие чувствительные сведения.

Следующий шаг

Когда одна задача уже работает, разберитесь в устройстве памяти, профилей и навыков: Hermes Agent изнутри: архитектура, память и самообучение. Этот разбор проверен для более ранней версии; команды сверяйте с текущей официальной документацией.

Для своей задачи начните с одного повторяющегося действия: определите входные данные, результат и способ проверки. Это поможет понять, какие инструменты и доступы действительно нужны агенту.

Если захотите обсудить, как это применить у себя или в команде — пишите в Telegram @pimenov