# Hermes Agent: повний посібник із першого налаштування та запуску на VPS > Покроковий інженерний гайд із розгортання самонавчального ШІ-агента Hermes на VPS: порівняння з OpenClaw та Paperclip, Docker, оптимізація бюджету через OpenRouter та створення автономних скілів. ## 1. Архітектура та вибір агента: Hermes, OpenClaw чи Paperclip В екосистемі автономних агентів 2026 року немає універсального інструменту, який вирішує всі завдання однаково добре. Три провідні опенсорс-системи — **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) | Керує іншими агентами через адаптери | | **Здатність до навчання** | **Висока**: автоматично компілює робочі процеси в скіли | **Відсутня**: потребує ручного оновлення правил | **Непряма**: делегує виконання зовнішнім агентам | | **Поріг доцільності** | Ефективний від 1 автономного завдання | Ефективний для омніканальної комунікації | Розкривається від 5 одночасних агентів | > [!NOTE] > Всі три фреймворки використовують ізольовані мережеві порти та рантайми. Ви можете без жодних конфліктів запустити 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
(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-контейнера Переконайтеся, що контейнер 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). Це створює надмірне фінансове навантаження: > [!WARNING] > **Пастка мономодельної конфігурації:** Використання однієї моделі рівня Opus для всіх фаз сесії (планування, виклики утиліт, парсинг виводу) генерує витрати $0.50–$2.00 за одну сесію. При 90 сесіях на місяць це становить **$45–$180** лише за API. ### Архітектура розподілених ролей Для зниження витрат до **$12–$22 на місяць** без втрати якості ми розділяємо обов'язки між вузькоспеціалізованими моделями. ![Порівняння цін та характеристик моделей для Hermes Agent](/api/guides-media/ai_agents/hermes-agent-initial-setup-guide/images/hermes-agent-initial-setup-guide-extra-02.webp) ![Швидкі моделі для масових викликів інструментів](/api/guides-media/ai_agents/hermes-agent-initial-setup-guide/images/hermes-agent-initial-setup-guide-extra-03.webp) ### Матриця рекомендованих моделей | Роль в агенті | Рекомендована модель | Ідентифікатор 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 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] > **Критична вимога безпеки:** Будь-який користувач, який надсилає команду боту в месенджері, отримує **повний доступ до терміналу сервера** з правами запущеного процесу. Ніколи не запускайте публічного бота без білого списку ID! ### Налаштування 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 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](/api/guides-media/ai_agents/hermes-agent-initial-setup-guide/images/hermes-agent-initial-setup-guide-extra-01.webp) ### Матриця вирішення проблем | Симптом | Першопричина | Перевірене рішення | | :--- | :--- | :--- | | `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 та збережено перший призначений для користувача скіл.