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

В екосистемі автономних агентів 2026 року немає універсального інструменту, який вирішує всі завдання однаково добре. Три провідні опенсорс-системи — 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)Керує іншими агентами через адаптери
Здатність до навчанняВисока: автоматично компілює робочі процеси в скілиВідсутня: потребує ручного оновлення правилНепряма: делегує виконання зовнішнім агентам
Поріг доцільностіЕфективний від 1 автономного завданняЕфективний для омніканальної комунікаціїРозкривається від 5 одночасних агентів
Примітка

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


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

Hermes здатний працювати як легковажний CLI-інструмент, проте для повноцінної автономної роботи (з браузерною автоматизацією, фоновими шлюзами та збереженням векторної пам'яті) потрібна стабільна серверна база.

Апаратні вимоги до 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-контейнера

Переконайтеся, що контейнер Hermes успішно ініціалізовано:

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?

Якщо Hermes повертає список файлів каталогу, інструментальний шар (Tool Calling) функціонує коректно. Якщо виникає помилка, виконайте системну діагностику:

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
Швидкі моделі для масових викликів інструментів ЗбільшитиШвидкі моделі для масових викликів інструментівШвидкі моделі для масових викликів інструментів

Матриця рекомендованих моделей

Роль в агентіРекомендована модельІдентифікатор OpenRouterЦіна входу ($/1M)Основне призначення
Planner & BackboneMiniMax M2.7minimax/minimax-m2.7$0.30Оркестрація, щоденне планування, логіка сесії
Reviewer & ReasoningKimi K2.6moonshotai/kimi-k2.6$0.60Глибоке міркування, код-рев'ю, верифікація
Fast 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 (SettingsCreditsMonthly limit). Для старту рекомендується встановити поріг у $15/місяць, що захистить від нескінченних циклів у разі помилки в скриптах автоматизації.


5. Безпека та підключення шлюзів повідомлень

Hermes дозволяє керувати процесами через месенджери, перетворюючи сервер на особистого асистента в Telegram або Discord.

Важливо

Критична вимога безпеки: Будь-який користувач, який надсилає команду боту в месенджері, отримує повний доступ до терміналу сервера з правами запущеного процесу. Ніколи не запускайте публічного бота без білого списку ID!

Налаштування Telegram Gateway

Запустіть та перевірте статус фонового гейтвею:

bash
# Перевірка статусу шлюзу hermes gateway status # Перегляд логів взаємодії в реальному часі tail -f ~/.hermes/logs/gateway.log

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

Ключова перевага Hermes над звичайними викликами LLM полягає в компаундингу знань. Агент автоматично аналізує успішні багатоетапні дії та записує їх у каталог скілів ~/.hermes/skills/.

mermaid
sequenceDiagram autonumber actor User as Інженер participant H as Hermes Agent participant Web as Reddit API / Веб participant Disk as ~/.hermes/skills/ User->>H: Надіслати промпт дослідження H->>Web: Пошук трендових фреймворків у r/LocalLLaMA Web-->>H: Сирі обговорення та посилання H->>H: Аналіз та форматування (голос автора) H->>Disk: Збереження алгоритму в reddit-trending-frameworks.md H-->>User: Готовий стислий звіт Note over User,Disk: Наступний запуск User->>H: "Run reddit-trending-frameworks on r/aiagents" H->>Disk: Читання скомпільованого скіла H->>Web: Пряме виконання без зайвих роздумів H-->>User: Миттєвий структурований звіт

Демонстрація створення автономного скіла

Надішліть агенту такий робочий промпт:

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 самостійно здійснює пошук, агрегує відгуки спільноти та фільтрує спам.
  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 успішно запущено в Docker.
  • Команда hermes doctor не виявляє критичних помилок середовища.
  • Налаштовано мультимодельний розподіл ролей у ~/.hermes/config.yaml.
  • Встановлено місячний ліміт витрат в акаунті OpenRouter.
  • У файлі .env налаштовано білий список TELEGRAM_ALLOWED_USERS.
  • Виконано тестовий запуск CLI та збережено перший призначений для користувача скіл.
Цей гайд повністю безкоштовний. Якщо він зекономив вам вечір — ви можете підтримати розвиток проєкту.
Підтримати автора