# Hermes Agent: полное руководство по первичной настройке и запуску на VPS
> Пошаговый инженерный гайд по развертыванию самообучающегося ИИ-агента Hermes на VPS: сравнение с OpenClaw и Paperclip, Docker, оптимизация бюджета через OpenRouter и создание автономных навыков.
## 1. Архитектура и выбор агента: Hermes, OpenClaw или Paperclip
В современной экосистеме автономных агентов нет единого универсального инструмента под все задачи. Три ведущие открытые системы — **Hermes**, **OpenClaw** и **Paperclip** — представляют принципиально разные архитектурные подходы. Они не конкурируют напрямую и на практике часто развертываются вместе на одном сервере.
```mermaid
flowchart TD
subgraph Ecosystem ["Три архитектурные парадигмы агентов"]
H["Hermes Agent
Самообучающийся специалист
(Накапливает опыт в MEMORY.md и создает воспроизводимые навыки)"]
O["OpenClaw
Шлюз и автономный сотрудник
(50+ мессенджеров, статичные инструкции SOUL.md)"]
P["Paperclip
Оркестратор цифровой компании
(Иерархия CEO, лимиты бюджета, координация команд)"]
end
VPS[("Один VPS-сервер (Ubuntu + Docker)")] --> H
VPS --> O
VPS --> P
```
### Сравнительная матрица агентных платформ
| Параметр | Hermes Agent | OpenClaw | Paperclip |
| :--- | :--- | :--- | :--- |
| **Основная роль** | Исследователь и непрерывно обучающийся специалист | Омниканальный автономный сотрудник | Оркестратор команды из 5+ агентов |
| **Механизм памяти** | Динамический: обновляет `MEMORY.md`, `USER.md` и навыки каждые 10 шагов | Статичный: поведение зафиксировано в `SOUL.md` | Проектный: общее состояние задач и иерархия |
| **Каналы связи** | 6 ключевых (CLI, Telegram, Discord, WhatsApp и др.) | 50+ интеграций (Teams, Slack, iMessage, Signal) | Управляет внешними агентами через адаптеры |
| **Способность к обучению** | **Высокая**: автоматически компилирует процессы в навыки | **Отсутствует**: требует ручной правки промптов | **Косвенная**: делегирует выполнение подопечным |
| **Порог целесообразности** | Высокая отдача уже от одной автономной задачи | Эффективен для омниканальных коммуникаций | Оправдан при координации от 5 агентов одновременно |
> [!NOTE]
> Все три фреймворка используют изолированные порты и окружения. Вы можете без конфликтов запускать 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
(Ubuntu + Docker)"] --> B["2. SSH-подключение
к серверу"]
B --> C["3. Проверка контейнера
(docker ps)"]
C --> D["4. Мастер настройки
(hermes setup)"]
D --> E["5. Тестовый прогон
(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, что приводит к избыточным тратам:
> [!WARNING]
> **Ловушка единой флагманской модели:** Использование Opus для всех фаз (планирование, вызовы утилит, сборка ответов) обходится в $0.50–$2.00 за одну сессию. При 90 сессиях в месяц затраты составляют **$45–$180** только на API.
### Архитектура разделения ролей
Разделение обязанностей между узкоспециализированными моделями снижает расходы до **$12–$22 в месяц** без снижения качества результатов.
### Матрица рекомендуемых моделей
| Роль в агенте | Модель | ID в OpenRouter | Вход ($/1M) | Назначение |
| :--- | :--- | :--- | :--- | :--- |
| **Planner & Backbone** | MiniMax M2.7 | `minimax/minimax-m2.7` | $0.30 | Оркестрация, планирование, общая логика диалога |
| **Reviewer & Reasoning** | Kimi K2.6 | `moonshotai/kimi-k2.6` | $0.60 | Глубокие рассуждения, аудит кода, верификация |
| **Fast Tool Executor** | DeepSeek V4 Flash | `deepseek/deepseek-v4-flash` | $0.14 | Массовые вызовы bash/tools, быстрый сбор данных |
| **Vision Subsystem** | Gemma 4 26B IT | `google/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
```
> [!TIP]
> **Финансовый предохранитель:** Обязательно установите жесткий лимит расходов в панели OpenRouter (`Settings` → `Credits` → `Monthly limit`). Стартовое значение в **$15/месяц** гарантирует защиту от непредвиденных списаний при зацикливании фоновых скриптов.
---
## 5. Безопасность и интеграция со шлюзами сообщений
Подключение Hermes к мессенджерам позволяет управлять сервером прямо со смартфона через Telegram или Discord.
> [!IMPORTANT]
> **Критическое предупреждение по безопасности:** Любой пользователь, отправивший команду боту, получает **неограниченный доступ к консоли сервера** с правами контейнера. Никогда не включайте бота без белого списка разрешенных пользователей!
### Порядок настройки Telegram Gateway
:::tabs
@tab 1. Создание бота
1. Откройте `@BotFather` в Telegram.
2. Отправьте команду `/newbot` и задайте имя.
3. Сохраните выданный токен (вида `123456789:ABCdef...`).
@tab 2. Получение User ID
1. Напишите боту `@userinfobot` в Telegram.
2. Скопируйте ваш числовой идентификатор (например, `987654321`).
@tab 3. Переменные окружения
Добавьте параметры в файл `.env` внутри контейнера:
```bash
TELEGRAM_BOT_TOKEN="123456789:ABCdef..."
TELEGRAM_ALLOWED_USERS="987654321"
```
:::
Запустите и проверьте фоновый сервис шлюза:
```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. Диагностика и устранение неисправностей
При первоначальном развертывании агента на чистом сервере возможны типичные ошибки конфигурации.
### Матрица устранения неполадок
| Проблема | Причина | Проверенное решение |
| :--- | :--- | :--- |
| `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 и сохранен первый автономный навык.