Skip to main content
Все гайды
Содержание гайда

Содержание гайда

Время на изучение: 12 мин
#ai_agents#hermes#agent#initial#setup#vps#docker#openrouter
Новичок12 мин

Hermes Agent: полное руководство по первичной настройке и запуску на VPS

Пошаговый инженерный гайд по развертыванию самообучающегося ИИ-агента Hermes на VPS: сравнение с OpenClaw и Paperclip, Docker, оптимизация бюджета через OpenRouter и создание автономных навыков.

Опубликовано:

1. Архитектура и выбор агента: Hermes, OpenClaw или Paperclip

В современной экосистеме автономных агентов нет единого универсального инструмента под все задачи. Три ведущие открытые системы — Hermes, OpenClaw и Paperclip — представляют принципиально разные архитектурные подходы. Они не конкурируют напрямую и на практике часто развертываются вместе на одном сервере.

mermaid
flowchart TD subgraph Ecosystem ["Три архитектурные парадигмы агентов"] H["<b>Hermes Agent</b><br>Самообучающийся специалист<br><i>(Накапливает опыт в MEMORY.md и создает воспроизводимые навыки)</i>"] O["<b>OpenClaw</b><br>Шлюз и автономный сотрудник<br><i>(50+ мессенджеров, статичные инструкции SOUL.md)</i>"] P["<b>Paperclip</b><br>Оркестратор цифровой компании<br><i>(Иерархия CEO, лимиты бюджета, координация команд)</i>"] end VPS[("Один VPS-сервер (Ubuntu + Docker)")] --> H VPS --> O VPS --> P

Сравнительная матрица агентных платформ

ПараметрHermes AgentOpenClawPaperclip
Основная рольИсследователь и непрерывно обучающийся специалистОмниканальный автономный сотрудникОркестратор команды из 5+ агентов
Механизм памятиДинамический: обновляет MEMORY.md, USER.md и навыки каждые 10 шаговСтатичный: поведение зафиксировано в SOUL.mdПроектный: общее состояние задач и иерархия
Каналы связи6 ключевых (CLI, Telegram, Discord, WhatsApp и др.)50+ интеграций (Teams, Slack, iMessage, Signal)Управляет внешними агентами через адаптеры
Способность к обучениюВысокая: автоматически компилирует процессы в навыкиОтсутствует: требует ручной правки промптовКосвенная: делегирует выполнение подопечным
Порог целесообразностиВысокая отдача уже от одной автономной задачиЭффективен для омниканальных коммуникацийОправдан при координации от 5 агентов одновременно
Примечание

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

2. Системные требования и подготовка инфраструктуры

Hermes может запускаться как локальная консольная утилита, однако для полноценной автономной эксплуатации (с браузерной автоматизацией, фоновыми демонами и долговременной векторной памятью) необходим стабильный выделенный сервер.

Рекомендуемые параметры VPS

  • Процессор: Минимум 2 vCPU (необходимо для одновременного парсинга и генерации эмбеддингов).
  • Оперативная память: 8 ГБ RAM (обеспечивает стабильность браузера Playwright и контейнеров Docker).
  • Диск: 100 ГБ NVMe SSD (для кеширования образов, снимков страниц и логов).
  • Операционная система: Ubuntu 24.04 LTS или Debian 12 с установленным Docker Engine.

Необходимые внешние сервисы

  1. Хостинг с поддержкой Docker: Hetzner, DigitalOcean, Vultr или любой KVM VPS.
  2. Единый API-шлюз (OpenRouter): Вместо регистрации десятка отдельных ключей для Anthropic, OpenAI и Moonshot используйте OpenRouter. Один ключ дает доступ к 200+ моделям с общим балансом и возможностью динамического переключения ролей.

3. Пошаговое развертывание Hermes на VPS через Docker

Наиболее надежный и воспроизводимый способ запуска Hermes — использование официального Docker-контейнера от Nous Research, исключающего конфликты в версиях Python.

mermaid
flowchart LR A["1. Создание VPS<br>(Ubuntu + Docker)"] --> B["2. SSH-подключение<br>к серверу"] B --> C["3. Проверка контейнера<br>(docker ps)"] C --> D["4. Мастер настройки<br>(hermes setup)"] D --> E["5. Тестовый прогон<br>(hermes CLI)"]

Шаг 1. Подключение к серверу по SSH

После завершения инициализации сервера на хостинге подключитесь к нему через консоль:

bash
ssh root@YOUR_VPS_IP

Шаг 2. Проверка работы Docker-контейнера

Убедитесь, что контейнер успешно запущен:

bash
docker ps

В выводе должен присутствовать образ nousresearch/hermes-agent:latest. Перейдите в каталог проекта и подключитесь к шеллу контейнера:

bash
cd /docker/hermes-agent-* docker compose exec -it hermes-agent /bin/bash

Шаг 3. Запуск интерактивного мастера настройки

Внутри контейнера запустите базовый конфигуратор:

bash
hermes setup

Мастер предложит пройти четыре шага:

  1. Выбор провайдера LLM: Выберите OpenRouter.
  2. Ввод API-ключа: Укажите ключ OpenRouter (sk-or-v1-...).
  3. Выбор стартовой модели: Выберите временную модель (в следующем разделе мы настроим распределение ролей).
  4. Подключение мессенджеров: Интеграция Telegram или Discord (на первом этапе можно пропустить).

Шаг 4. Первый запуск через CLI

Проверьте работоспособность базового окружения:

bash
hermes

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

text
What files are in my current directory?

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

bash
hermes doctor

4. Конфигурация моделей и оптимизация бюджета через OpenRouter

По умолчанию Hermes обращается к флагманским моделям уровня Claude Opus, что приводит к избыточным тратам:

Внимание

Ловушка единой флагманской модели: Использование Opus для всех фаз (планирование, вызовы утилит, сборка ответов) обходится в $0.50–$2.00 за одну сессию. При 90 сессиях в месяц затраты составляют $45–$180 только на API.

Архитектура разделения ролей

Разделение обязанностей между узкоспециализированными моделями снижает расходы до $12–$22 в месяц без снижения качества результатов.

Сравнение цен и характеристик моделей для Hermes Agent ЗбільшитиСравнение цен и характеристик моделей для Hermes AgentСравнение цен и характеристик моделей для Hermes Agent
Быстрые модели для массовых вызовов инструментов ЗбільшитиБыстрые модели для массовых вызовов инструментовБыстрые модели для массовых вызовов инструментов

Матрица рекомендуемых моделей

Роль в агентеМодельID в OpenRouterВход ($/1M)Назначение
Planner & BackboneMiniMax M2.7minimax/minimax-m2.7$0.30Оркестрация, планирование, общая логика диалога
Reviewer & ReasoningKimi K2.6moonshotai/kimi-k2.6$0.60Глубокие рассуждения, аудит кода, верификация
Fast Tool ExecutorDeepSeek V4 Flashdeepseek/deepseek-v4-flash$0.14Массовые вызовы bash/tools, быстрый сбор данных
Vision SubsystemGemma 4 26B ITgoogle/gemma-4-26b-a4b-it:freeБесплатноАнализ скриншотов и изображений

Файл конфигурации мультимодельного маршрутизатора

Откройте файл настроек:

bash
hermes config edit

Замените блок конфигурации моделей следующим YAML:

yaml
model: provider: openrouter default: minimax/minimax-m2.7 roles: planner: minimax/minimax-m2.7 executor: deepseek/deepseek-v4-flash reviewer: moonshotai/kimi-k2.6 vision: google/gemma-4-26b-a4b-it:free fallback: - deepseek/deepseek-v4-flash - google/gemma-3-12b-it:free compression: enabled: true threshold: 0.50

Для сохранения ключа OpenRouter в конфигурации выполните:

bash
hermes config set OPENROUTER_API_KEY sk-or-v1-your-key-here
Совет

Финансовый предохранитель: Обязательно установите жесткий лимит расходов в панели OpenRouter (Settings → Credits → Monthly limit). Стартовое значение в $15/месяц гарантирует защиту от непредвиденных списаний при зацикливании фоновых скриптов.

5. Безопасность и интеграция со шлюзами сообщений

Подключение Hermes к мессенджерам позволяет управлять сервером прямо со смартфона через Telegram или Discord.

Важно

Критическое предупреждение по безопасности: Любой пользователь, отправивший команду боту, получает неограниченный доступ к консоли сервера с правами контейнера. Никогда не включайте бота без белого списка разрешенных пользователей!

Порядок настройки Telegram Gateway

Запустите и проверьте фоновый сервис шлюза:

bash
# Проверка статуса сервиса hermes gateway status # Просмотр входящих событий в реальном времени tail -f ~/.hermes/logs/gateway.log

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

Главное отличие Hermes от разовых запросов к LLM — накопление процедурного опыта. Агент анализирует успешные цепочки действий и автоматически компилирует их в каталог ~/.hermes/skills/.

mermaid
sequenceDiagram autonumber actor Dev as Разработчик participant H as Hermes Agent participant Web as Reddit API / Web participant Disk as ~/.hermes/skills/ Dev->>H: Отправить исследовательский промпт H->>Web: Поиск трендовых фреймворков в r/LocalLLaMA Web-->>H: Ветки обсуждений и ссылки H->>H: Анализ и форматирование под заданный голос H->>Disk: Сохранение алгоритма в reddit-trending-frameworks.md H-->>Dev: Готовая выжимка из 9 тезисов Note over Dev,Disk: Последующий запуск Dev->>H: "Run reddit-trending-frameworks on r/aiagents" H->>Disk: Чтение скомпилированного навыка H->>Web: Точечный опрос без лишних рассуждений H-->>Dev: Мгновенный структурированный отчет

Демонстрация создания автономного навыка

Передайте агенту тестовую задачу:

text
Research the top 3 trending AI agent frameworks on r/LocalLLaMA this week. Use my voice — punchy, no jargon, no AI-speak. Three bullets per framework. Save this whole workflow as a reusable skill called reddit-trending-frameworks.

Жизненный цикл фиксации навыка

  1. Исполнение: Hermes выполняет поиск по Reddit, анализирует комментарии и отсеивает спам.
  2. Форматирование: Формирует 9 емких тезисов (по 3 на фреймворк) в указанной тональности.
  3. Сохранение навыка: Записывает алгоритм в файл ~/.hermes/skills/reddit-trending-frameworks.md.

Проверьте появление файла навыка на диске:

bash
ls -la ~/.hermes/skills/

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

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

text
Run my reddit-trending-frameworks skill on r/aiagents instead

Hermes применит сохраненный навык, затратив в разы меньше токенов и завершив работу быстрее первого раза.

7. Диагностика и устранение неисправностей

При первоначальном развертывании агента на чистом сервере возможны типичные ошибки конфигурации.

Справочная таблица устранения частых неполадок Hermes ЗбільшитиСправочная таблица устранения частых неполадок HermesСправочная таблица устранения частых неполадок Hermes

Матрица устранения неполадок

ПроблемаПричинаПроверенное решение
command not found: hermesОболочка не обновила переменную PATH.Выполните source ~/.bashrc (или source ~/.zshrc).
Контейнер завершает работу сразу после стартаНе указан или поврежден API-ключ в .env.Проверьте логи через docker logs hermes. Убедитесь, что вокруг знака = нет пробелов.
Ошибка HTTP 400 при первом сообщенииНекорректное имя модели для шлюза.Для OpenRouter используйте формат провайдер/модель (например, minimax/minimax-m2.7).
Бот в Telegram не отвечает на командыЗапрос поступил от неавторизованного пользователя.Проверьте логи: tail -f ~/.hermes/logs/gateway.log. Добавьте ID в TELEGRAM_ALLOWED_USERS.

8. Итоговый чек-лист готовности к эксплуатации

Перед постоянной работой с Hermes убедитесь в выполнении всех пунктов:

  • Создан VPS с параметрами не менее 2 vCPU и 8 ГБ RAM.
  • Контейнер nousresearch/hermes-agent:latest находится в статусе Up в Docker.
  • Проверка hermes doctor завершилась без критических предупреждений.
  • Настроена мультимодельная маршрутизация в ~/.hermes/config.yaml.
  • Задан жесткий лимит расходов в панели управления OpenRouter.
  • Заполнен белый список пользователей TELEGRAM_ALLOWED_USERS.
  • Проведен первый тестовый запуск в CLI и сохранен первый автономный навык.
Этот гайд полностью бесплатный. Если он сэкономил вам вечер — вы можете поддержать развитие проекта.
Поддержать автора