Hermes Agent помогает выполнять задачи на компьютере: разбирать материалы, искать сведения, готовить файлы и запускать повторяющуюся работу по расписанию. Это руководство объясняет его возможности и навыки, проводит через установку и помогает получить первый результат на простом примере с заметками.
Что такое 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 | bashWindows без приложения. Откройте 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
- Откройте @BotFather, отправьте
/newbot, задайте имя и уникальное имя пользователя с окончаниемbot. - Сохраните выданный токен. Он позволяет управлять ботом. При утечке отзовите его через
/revokeу BotFather. - Узнайте свой числовой ID через @userinfobot. Для доступа Hermes нужен этот ID, а не имя вида
@username. - В терминале выполните команду ниже, выберите 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-digestpause приостанавливает будущие запуски. 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.
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

