Hermes Agent
на сервере, на пальцах

Арендовать машину

Сервер (он же VPS) — это компьютер в дата-центре, который вы снимаете помесячно. Он не выключается и всегда в интернете. Именно поэтому бот отвечает круглосуточно.

Где арендовать

Цены не приводим намеренно — они устаревают быстрее документа. Требования к машине выше стабильны, прайс смотрите на сайте провайдера.

Как попасть на сервер

После оплаты у сервера появится IP-адрес. Открываете у себя Терминал (на Mac программа «Терминал», на Windows PowerShell) и вставляете строку со своим адресом:

ssh root@203.0.113.42

Спросит «are you sure», отвечаете yes. Дальше два варианта. Если при заказе вы добавили SSH-ключ (так надёжнее, и мы советуем именно так), пароль не спросят, вы сразу внутри. Если сервер создан с паролем, вводите его вслепую: символы не показываются, это нормально.

Подготовить систему

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

sudo apt update && sudo apt upgrade -y
sudo apt install curl git ca-certificates -y

sudo adduser --disabled-password --gecos "" hermes
sudo loginctl enable-linger hermes

Базовая защита — файрвол, защита от подбора пароля, автообновления безопасности:

sudo ufw --force reset
sudo ufw default deny incoming
sudo ufw default allow outgoing
sudo ufw allow 22/tcp
sudo ufw --force enable

sudo apt install fail2ban -y
sudo systemctl enable --now fail2ban
sudo systemctl enable --now unattended-upgrades
sudo timedatectl set-timezone Asia/Almaty

Последняя строка ставит часовой пояс. Сервер у провайдера живёт по UTC, и расписание Hermes считается по часам сервера: без неё «каждое утро в 9:00» придёт в 14:00 по Алматы. Подставьте свой город. fail2ban в Ubuntu 24.04 не установлен, поэтому без строки apt install следующая команда падает (проверено 14.09).

Плюс вход только по ключу. На чистом сервере хостинга вход по паролю включён (проверено 15.09, Hermes сам записал это предупреждение в журнал). Конфиг проверять до перезагрузки службы SSH — sudo sshd -t, иначе можно закрыть себе вход навсегда:

printf 'PasswordAuthentication no\nKbdInteractiveAuthentication no\nPermitRootLogin prohibit-password\n' | sudo tee /etc/ssh/sshd_config.d/01-keys-only.conf
sudo sshd -t && sudo systemctl reload ssh

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

Установить Hermes

Одна команда. Установщик сам ставит uv, Node.js и Python в свою папку, забирает код и создаёт команду hermes. Один и тот же скрипт работает на Linux, macOS, WSL2 и Termux. Но несколько системных пакетов ему нужны через sudo: компилятор, быстрый поиск по файлам, обработка аудио. Надёжнее поставить их заранее, а потом запускать установщик:

Первая строка — от администратора, вторая — от пользователя hermes:

sudo apt install -y xz-utils build-essential python3-dev libffi-dev ripgrep ffmpeg
sudo -iu hermes
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

Браузер агента. Без sudo установщик пропускает системные библиотеки Chromium, а браузер нужен агенту, чтобы открывать живые сайты. От администратора, после установщика:

cd /home/hermes/.hermes/hermes-agent && sudo env PATH=/home/hermes/.hermes/node/bin:$PATH npx --yes playwright install-deps chromium

Надпись установщика «No sudo — skipping» после этого останется — она ложная. В hermes doctor норма: предложение миграции настроек и уязвимости npm в модулях браузера; их закрывает hermes update.

Перечитать окружение — иначе команда hermes не найдётся — и сразу проверить себя:

source ~/.bashrc   # или ~/.zshrc
hermes doctor

Куда что легло

Разделение секретов и настроек сделано намеренно: hermes config set сам кладёт значение в нужный файл. Руками правьте config.yaml, ключи — только командой.

Подключить модель, то есть «вставить голову»

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

hermes setup

Мастер предлагает три режима:

Blank Slate стоит знать заранее: он пишет в конфиг явный список включённого, и после hermes update ничего лишнего не подтянется. Обратный путь открыт всегда — hermes tools, hermes skills opt-in --sync, hermes setup agent.

Выбрать провайдера отдельно:

hermes model

hermes config set model.provider openai-codex
hermes config set model.default gpt-6-astra

Первая переписка — та самая проверка, ради которой всё это:

hermes --tui        # современный интерфейс, рекомендуется
hermes --continue   # проверка: должен вернуть в тот же разговор

Спросите что-нибудь проверочное: «расскажи, что за сервер, на котором ты запущен: система, память, диск». Хороший знак — он не выдумал ответ, а реально сходил в терминал и показал цифры. Успех выглядит так: в шапке ваша модель и провайдер · агент отвечает без ошибки · при необходимости сам вызывает инструмент · разговор продолжается больше одного хода · --continue возвращает в него. Если это работает — самая тяжёлая часть позади.

Подключить телеграм

Здесь агент перестаёт быть игрушкой в терминале и становится тем, кому вы пишете с дивана. Две минуты в самом телеграме:

• Токен бота — у @BotFather: команда /newbot, имя и уникальный логин, обязательно заканчивающийся на bot. В ответ придёт токен вида 123456789:ABCdef… — это ключ от бота, никому не показывайте.
• Свой числовой ID — у @userinfobot. Нужен именно номер, а не @username.

hermes gateway setup

Интерактивный мастер: платформы выбираются стрелками, видно, что уже настроено, и в конце он сам предложит запустить или перезапустить шлюз. Если ставит агент без живого терминала, мастер можно заменить двумя строками в ~/.hermes/.env: TELEGRAM_BOT_TOKEN=… и список разрешённых ниже. Токен вставляете вы сами, не через переписку.

Впустить себя — строка в ~/.hermes/.env:

TELEGRAM_ALLOWED_USERS=123456789

Для нескольких — через запятую. Есть общая GATEWAY_ALLOWED_USERS сразу для всех платформ.

Запустить навсегда: служба, которая переживает перезагрузку

sudo loginctl enable-linger $USER   # служба живёт, даже когда вы вышли с сервера
hermes gateway install                # прописать как службу
hermes gateway start                  # запустить
systemctl --user is-enabled hermes-gateway   # должно ответить: enabled

Загрузка при старте системы (только Linux):

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

Сторож, который ловит настоящее зависание

Отдельная настройка, которой нет по умолчанию и которая закрывает ровно нашу боль — «служба жива, а бот молчит». В ~/.hermes/config.yaml уже есть строка gateway: null: замените её, а не дописывайте второй блок. Вместо правки файла работает и hermes config set gateway.systemd_watchdog_seconds 120 — она пишет «not a recognized config key», но сторож включается (проверено 15.09); верьте проверке WatchdogUSec, а не предупреждению:

gateway:
  systemd_watchdog_seconds: 120

hermes gateway install --force
systemctl --user restart hermes-gateway
systemctl --user show hermes-gateway -p WatchdogUSec   # должно быть: 2min

Без restart сторож не включается, хотя в файле службы он уже прописан (проверено 14.09).

Служба начинает слать системе сигнал «я жив» — но только пока внутренний цикл реально проворачивается. Завис цикл — сигнал прекращается, система перезапускает процесс. Обычный обрыв сети за зависание не считается.

Как с ним теперь общаться

Обычная переписка. Никаких особых форматов и «правильных промптов» — говорите как человеку.

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

Выдать умения: скиллы, плагины, MCP

Скилл — это папка с файлом SKILL.md: имя, описание, пошаговая инструкция «как делать вот такую задачу». Описания видны агенту всегда, полный текст читается только когда задача совпала — поэтому десятки скиллов не раздувают каждый запрос и их можно иметь много.

hermes skills browse                    # что вообще есть
hermes skills search kubernetes         # поиск по слову
hermes skills inspect <идентификатор>   # прочитать до установки
hermes skills install <идентификатор>   # поставить (сначала проверка безопасности)
hermes skills list                      # что уже стоит

Каждый установленный скилл автоматически становится слэш-командой — и в терминале, и в телеграме. Идентификатор берите из колонки поиска: он выглядит как автор/репозиторий/путь/имя. Встроенных скиллов в версии 0.21.2 было 53 (сверено 14.09; их число меняется от версии к версии, точный список покажет hermes skills list), сообществом собрано ещё больше сотни.

Бизнес-набор: шесть скиллов для владельца бизнеса

Проверено 14.09 на Hermes v0.21.2 и 15.09 на v0.21.3. Скиллы ставятся прямо из GitHub, проходят проверку безопасности и вызываются слэш-командой. Маркетинговые — из открытой библиотеки coreyhaines31/marketingskills, решения — из CodeAlive-AI/ceo-ai-os, обе под лицензией MIT.

hermes skills install coreyhaines31/marketingskills/skills/product-marketing --yes
hermes skills install coreyhaines31/marketingskills/skills/offers --yes
hermes skills install coreyhaines31/marketingskills/skills/competitor-profiling --yes
hermes skills install coreyhaines31/marketingskills/skills/lead-magnets --yes
hermes skills install CodeAlive-AI/ceo-ai-os/skills/decision-playbook --yes
hermes skills install CodeAlive-AI/ceo-ai-os/skills/competitive-analysis --yes
hermes skills list

Проверка — напишите агенту:

/offers У меня студия маникюра в Алматы, маникюр с покрытием стоит 8000 тенге, в будни мало клиенток. Упакуй оффер коротко, для поста в Instagram.

У нас агент применил скилл и за 12 секунд выдал готовый пост: будни, 8000 ₸ плюс дизайн на два ногтя в подарок, призыв написать «БУДНИ» в Direct. Проверяли в терминале; в телеграме команда та же.

Где брать

• agentskills.io — официальный каталог с поиском и установкой в одну команду. Формат открыт Anthropic и поддержан Claude Code, Cursor, OpenClaw и Hermes: скилл, написанный один раз, работает везде.
• ZeroPointRepo/awesome-hermes-skills и 0xNyk/awesome-hermes-agent — независимые каталоги сообщества.
• hermeswiki.ru — русскоязычная вики, если английская документация утомляет. Их цифры стоимости мы не берём: источник неизвестен.

Инструменты и подключение внешних сервисов по общему протоколу MCP — тот же сервер работает и здесь, и в Claude Code:

hermes tools   # что включено, по платформам

mcp_servers:
  github:
    command: npx
    args: ["-y", "@modelcontextprotocol/server-github"]
    env:
      GITHUB_PERSONAL_ACCESS_TOKEN: "ghp_xxx"

Скиллы можно не писать руками

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

/learn https://docs.example.com/api/quickstart
/learn клиент REST в ~/projects/acme-sdk
/learn как я оформляю расход: открыть портал, дальше…

Тот же механизм работает и без вас: инструментом skill_manage агент создаёт, правит и удаляет свои скиллы сам, сохраняя отработанный порядок действий. Рубеж контроля — параметр skills.write_approval: требовать вашего одобрения перед записью. На боевой машине его стоит включить.

Плагины — это другое

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

hermes plugins             # интерактивный список
hermes plugins search notion
hermes plugins install <название>
hermes plugins enable <название>   # добавить в разрешённые
hermes plugins disable <название>
hermes plugins list

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

Три способа завести одно и то же — прямо в чате, из командной строки или просто попросив словами («каждый будний день в 9 утра присылай сводку»).

/cron add "every 1h" "Собери новые посты канала и пришли выжимку"
/cron add "every 1h" "Разбери ленту" --skill blogwatcher

hermes cron create "0 9 * * *" "Утренний бриф" --deliver telegram   # каждый день в 9:00
hermes cron create "every 2h" "Проверь ленту"                          # каждые два часа

hermes cron create "every monday 9am" "Идея акции на неделю через скилл offers" --deliver telegram
hermes cron create "in 2m" "Короткое проверочное сообщение" --deliver telegram   # разовая проверка
hermes cron list --all
hermes cron remove <id>   # выполненная разовая задача сама из списка не уходит

Четыре вещи, которые надо знать до первой задачи

Закрыть безопасность после установки

В документации заявлено восемь рубежей; три настраиваются руками и делают основную работу.

Подтверждение опасных команд

approvals:
  mode: smart            # smart | manual | off
  timeout: 300
  cron_mode: deny        # что делает задача по расписанию, упёршись в опасную команду
  single_query_mode: deny

mode: off и hermes --yolo — только в контейнере или на машине «на выброс». На боевом сервере с вашими ключами это снятие последнего рубежа. Значения cron_mode: deny и single_query_mode: deny — правильные по умолчанию: ночная задача, у которой некому ответить на вопрос, должна остановиться, а не согласиться сама с собой.

Изоляция терминала

hermes config set terminal.backend docker   # агент работает в контейнере
hermes config set terminal.backend ssh     # или на отдельной машине

Для Docker есть дополнительный слой: прокси, подставляющий ключи снаружи — контейнер видит временные токены, а не ваши настоящие ключи (hermes egress setup && hermes egress start).

Кто впущен и что ему можно

hermes pairing approve telegram XKGH5N7P  # одобрить по коду
hermes pairing list                       # кто ждёт и кто уже впущен
hermes pairing revoke telegram 123456789  # отозвать

Код живёт час, генерируется криптостойко, частота запросов ограничена. Впущенные делятся на два уровня — администратор (всё) и обычный (разговаривать плюс те команды, что вы открыли). Права в личке и в группе считаются раздельно: администратор в личке не становится администратором в группе автоматически.

Самообучение под контролем — обязательно

hermes config set skills.write_approval true
systemctl --user restart hermes-gateway

По умолчанию false: агент правит свои скиллы сам, не спрашивая. С true он предлагает изменение, а вы подтверждаете кнопкой в Telegram. Проверено 15.09: без этой строки обещание «учится под вашим контролем» не выполняется.