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

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

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

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

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

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

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

ssh root@203.0.113.42

Спросит «are you sure» — отвечаете yes. Потом попросит пароль: вводите вслепую, символы не показываются — это нормально, ничего не сломалось.

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

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

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

sudo adduser hermes
sudo usermod -aG sudo hermes
sudo -iu hermes

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

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

sudo systemctl enable --now fail2ban
sudo systemctl enable --now unattended-upgrades

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

Установить Hermes

Одна команда. Установщик сам скачает Python 3.11, uv, Node.js, ripgrep и ffmpeg, заберёт код и создаст команду hermes. Всё кладётся в свою папку, системное не трогается. Один и тот же скрипт работает на Linux, macOS, WSL2 и Termux.

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

Перечитать окружение — иначе команда 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 --tui        # современный интерфейс, рекомендуется
hermes --continue   # проверка: должен вернуть в тот же разговор

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

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

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

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

hermes gateway setup

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

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

TELEGRAM_ALLOWED_USERS=123456789

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

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

hermes gateway install   # прописать как службу (автозапуск)
hermes gateway start     # запустить
hermes gateway status    # убедиться, что живой

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

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

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

Отдельная настройка, которой нет по умолчанию и которая закрывает ровно нашу боль — «служба жива, а бот молчит». В ~/.hermes/config.yaml:

gateway:
  systemd_watchdog_seconds: 120

hermes gateway install --force

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

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

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

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

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

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

hermes skills browse                    # что вообще есть
hermes skills search kubernetes         # поиск по слову
hermes skills install openai/skills/k8s # поставить (сначала проверка безопасности)
hermes skills list                      # что уже стоит

Каждый установленный скилл автоматически становится слэш-командой — и в терминале, и в телеграме. Из коробки в версии 0.20.5 идут 82 встроенных скилла плюс каталог на 117; сообществом собрано ещё около 165.

Где брать

• 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 "every 1d at 09:00" "Утренний бриф"

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

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

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

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

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  # отозвать

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