Hermes AI Assistant - instalacja, konfiguracja, przepływ pracy i rozwiązywanie problemów

Hermes Agent to self-hostowany, model-agnostyczny asystent AI działający na lokalnym komputerze lub tanim VPS. Działa przez interfejs terminalowy i komunikacyjny, a z czasem się doskonali, zamieniając powtarzalne zadania w wielokrotnie użyteczne umiejętności.

Pod względem funkcjonalności jest bardzo podobny do OpenClaw, to znaczy innego self-hostowanego stosu asystentów opartego na narzędziach, pamięci i lokalnej kontroli. Wielu developerów trafiło na Hermes po tym, jak Anthropic zablokował dostęp do subskrypcji Claude dla OpenClaw w kwietniu 2026 roku — oś czasu wzrostu i upadku OpenClaw wyjaśnia, dlaczego Hermes stał się naturalnym celem dla użytkowników szukających trwałą automatyzacji self-hostowanej, bez zależności od konkretnego dostawcy.

Jeśli chcesz szerszego obrazu self-hostowanych asystentów, wyszukiwania i lokalnej infrastruktury wokół Hermes, to przegląd systemów AI łączy te tematy z tymi samymi problemami, które Hermes próbuje rozwiązać. W kwestii pięciowarstwowego modelu asystenta — LLM, pamięć, narzędzia, routing i obserwowalność — z Hermesem i OpenClaw jako implementacjami referencyjnymi, zobacz Architekturę asystentów AI. Dostępne dane dotyczące wdrożenia — gwiazdki na GitHubie, dzienny wolumen tokenów OpenRouter, liczba pobrań z PyPI, historia CVE i sentyment społeczności na Reddicie — porównanie OpenClaw vs Hermes Agent: Gwiazdki, Pobrania i Użycie 2026 śledzi, jak Hermes wypada w porównaniu z 19 alternatywami pod każdym mierzalnym kątem.

W kwestii kompromisów wdrożeniowych i wyborów środowiska uruchomieniowego, Hosting LLM w 2026: Porównanie infrastruktury lokalnej, self-hostowanej i chmurowej dostarcza mapę hostingu, podczas gdy [Wydajność LLM w 2026: Benchmarki, wąskie gardła i optymalizacja](https://www.glukhov.org/pl/llm-performance/ “Praktyczna inżynieria wydajności LLM: przepustowość w porównaniu z opóźnieniem, limity VRAM, równoległe żądania, alokacja pamięci i benchmarki w różnych środowiskach i na różnych sprzętach.”} pokazuje kwestie przepustowości i opóźnień, gdy Hermes już działa. Jeśli regularnie kierujesz Hermes do modeli Qwen lub Gemma na lokalnych runtime’ach, takich jak Ollama, skonsoliduj ustawienia temperatury i kar dla wieloetapowego używania narzędzi w artykule Parametry inferencji agentic LLM dla Qwen i Gemma. W celu uzyskania zwartej mapy poleceń shell (hermes gateway, hermes memory, hermes doctor, skróty kreskowe i innych), skorzystaj ze ściągi Hermes Agent CLI. Jeśli głównym punktem wejścia jest komunikacja na telefonie, użyj Sterowania głosowego Hermesem z telefonu dla stosu głosowego i konfiguracji specyficznej dla platformy.

Moje stronnicze zdanie: Hermes jest najciekawszy, gdy traktujemy go jako infrastrukturę, a nie jako kartę, którą otwieramy od czasu do czasu. Kiedy działa jako usługa i ma stabilny katalog główny, Twoje prompty zaczynają wyglądać mniej jak „czat", a bardziej jak „operacje".

Czym jest Hermes Agent i dlaczego ma znaczenie

Hermes Agent to agent AI open source stworzony przez Nous Research. Został zaprojektowany tak, aby działać trwale, używać narzędzi (terminala, plików, sieci i innych) oraz poprawiać własne zachowanie z czasem dzięki systemowi umiejętności i pamięci.

Warte wyjaśnienia są dwa wybory projektowe, ponieważ kształtują wszystko inne w tym poradniku.

Po pierwsze, Hermes nie jest zamknięty na jednego dostawcę modelu. Oficjalny proces konfiguracji obsługuje wielu dostawców i dowolne endpointy zgodne z OpenAI, a przełączanie odbywa się przez komendę hermes model, a nie przez edycję kodu.

Po drugie, Hermes wyciąga wyraźną granicę między „rozmową" a „egzekucją". Agent może rozmawiać cały dzień, ale gdy musi działać, robi to przez jawnie określone narzędzia i konfigurowalne środowisko wykonawcze. To tam kryje się bezpieczeństwo, odtwarzalność i rozwiązywanie problemów.

Koszty i licencja są odświeżająco nudne. Sam Hermes Agent to oprogramowanie darmowe na licencji MIT. Jeśli używasz modeli hostowanych, bieżący koszt to to, co nalicza Twój dostawca. Jeśli uruchamiasz modele lokalnie, możesz w całości uniknąć opłat za API.

Jeśli Twoje wdrożenie Hermes używa Claude przez zewnętrzne warstwy narzędziowe, [ta zmiana subskrypcji Anthropic](https://www.glukhov.org/pl/ai-systems/openclaw/anthropic-claude-subscription-agent-tools/ “Anthropic blokuje subskrypcje Claude w narzędziach agentów, takich jak OpenClaw, wymuszając użycie API. Co się zmieniło, kogo to dotyczy i praktyczne obejścia.”} jest użytecznym odnośnikiem wyjaśniającym, dlaczego rozliczanie oparte na API jest obecnie oczekiwaną ścieżką.

Instalacja Hermes Agent

Hermes posiada szybką ścieżkę instalacji dla Linuxa, macOS i WSL2. Oficjalna dokumentacja trzyma ją celowo prostą.

Instalacja Hermes na Linuksie

sudo apt-get update
sudo apt-get upgrade
sudo apt-get curl git
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

Po instalacji przeładuj powłokę i uruchom CLI.

source ~/.bashrc   # lub source ~/.zshrc
hermes

Instalator to nie tylko cienka nakładka. Zgodnie z poradnikiem instalacyjnym, ustawia on zależności, repozytorium, wirtualne środowisko i komendę hermes, a następnie doprowadza do pierwszego stanu gotowego do czatu.

Jeśli przychodzisz z istniejącego wdrożenia OpenClaw, zamiast zaczynać od zera, najpierw zainstaluj i zwaliduj pusty Hermes, a następnie postępuj zgodnie ze stopniowym przełączeniem w artykule Jak bezpiecznie migrować z OpenClaw do Hermes Agent — hermes claw migrate mapuje personę, pamięć, umiejętności, dostawców i serwery MCP, ale zadania cron, wtyczki i routing wieloagentowy muszą być przebudowane ręcznie.

Uwagi dotyczące Windowsa i Androida

Natywny Windows nie jest wspierany. Dokumentacja zaleca WSL2 i uruchamianie Hermes wewnątrz niego.

Dla Androida Hermes obsługuje ścieżkę instalacji w Termux. Jest zaprojektowany tak, aby wykrywać Termux i dostosowywać konfigurację zależności i środowiska odpowiednio.

Szybki start

Najszybszy pierwszy uruchomienie to dosłownie tylko hermes, ale sensowny szybki start oznacza dwie dodatkowe decyzje: którego dostawcę modelu użyć i które narzędzia należy włączyć.

Wybór dostawcy i modelu

Hermes udostępnia trzy uzupełniające się punkty wejścia:

• hermes model, aby wybrać dostawcę i domyślny model
• hermes tools, aby włączać lub wyłączać zestawy narzędzi
• hermes setup, aby uruchomić interaktywny kreator w głównych obszarach konfiguracji

Minimalny przebieg wygląda tak:

hermes model
hermes tools
hermes

W zakresie tego, co jest realnie wspierane, oficjalny Quickstart wymienia szereg dostawców i podkreśla, że Hermes działa z API zgodnymi z OpenAI. Ma to znaczenie, ponieważ obejmuje to zarówno usługi hostowane, jak i self-hostowane endpointy.

Wczesne udowodnienie egzekucji narzędzi

Zanim zaczniesz tworzyć nawyki wokół Hermes, warto zweryfikować, czy używanie narzędzi działa w Twoim środowisku. Quickstart wprost sugeruje użycie terminala jako pierwszej funkcji do przetestowania.

W praktyce mały prompt „testu dymnego" wykonuje dwie rzeczy: sprawdza narzędzie terminalowe i waliduje prośby o uprawnienia.

Przykładowy prompt:

Pokaż mi zużycie dysku i pięć największych katalogów.

Jeśli Hermes nie może uruchomić narzędzia terminalowego, przejdź do sekcji Rozwiązywanie problemów. Nieprawidłowa konfiguracja backendu terminalowego jest jedną z najczęstszych przyczyn, a naprawa zwykle staje się oczywista, gdy się spojrzy na konfigurację.

Konfiguracja skalująca się

Hermes nagradza osoby, które rozumieją, gdzie przechowuje stan i jak rozwiązuje konfigurację. To również miejsce, z którego bierze się wiele problemów typu „wczoraj to działało".

Gdzie mieszczą się konfiguracja i stan

Hermes przechowuje swoje ustawienia i stan pod ~/.hermes. Oficjalny przewodnik konfiguracji dokumentuje układ, w tym config.yaml dla ustawień, .env dla sekretów, auth.json dla poświadczeń OAuth, SOUL.md dla tożsamości oraz foldery na pamięci, umiejętności, cron, sesje i logi.

Ma to znaczenie z dwóch powodów.

• Debugowanie staje się mechaniczne, ponieważ wiesz dokładnie, gdzie szukać.
• Kopie zapasowe stają się proste, ponieważ jeden katalog przechwytuje większość stanu agenta, o który Ci chodzi.

Priorytet konfiguracji i trzymanie sekretów poza config.yaml

Hermes rozwiązuje konfigurację z określonym priorytetem. Na szczycie znajdują się nadpisaniami z CLI, następnie config.yaml, potem .env, a na samym dole wbudowane wartości domyślne.

Dobrym szczegółem jest to, że hermes config set kieruje wartości do odpowiedniego pliku: klucze API do .env, a niесекретne ustawienia do config.yaml.

hermes config set model openrouter/meta-llama/llama-3.1-70b-instruct
hermes config set terminal.backend docker
hermes config set OPENROUTER_API_KEY sk-or-v1-xxxxxxxx

Hermes obsługuje również podstawienie zmiennych środowiskowych w config.yaml za pomocą składni ${NARZĘDZIE_ZMIENNEJ}. Jest to przydatne, gdy chcesz trzymać pewne wartości w środowisku, a jednocześnie odwoływać się do nich w ustrukturyzowanej konfiguracji.

Sandbox i środowiska wykonawcze (backendy)

Hermes obsługuje wiele backendów terminalowych, które definiują, gdzie faktycznie uruchamiane są komendy shell. Przewodnik konfiguracji wymienia local, docker, ssh, modal, daytona i singularity.

Opiniowana, ale nie ewangelizacyjna, sposób myślenia o tym to:

• local jest najszybszy i najprostszy, ale nie jest izolowany
• docker jest pragmatyczną warstwą bezpieczeństwa i odtwarzalności
• ssh to czysty sposób oddzielenia urządzenia do czatu od komputera wykonawczego
• modal i daytona pasują do workflow „serverless, ale wystarczająco trwałe"
• singularity to opcja przyjazna HPC (wysokiej wydajności obliczeniowej)

Minimalny przykład backendu Docker:

# ~/.hermes/config.yaml
terminal:
  backend: docker
  docker_image: "nikolaik/python-nodejs:python3.11-nodejs20"
  docker_volumes:
    - "/home/user/projects:/workspace/projects"
  docker_forward_env:
    - "GITHUB_TOKEN"

Dokumentacja opisuje również wzmocnienie bezpieczeństwa dla backendu Docker, takie jak usuwanie uprawnień i wyłączenie eskalacji przywilejów.

Umiejętności, pamięć i profile

Hermes ma dwa powiązane mechanizmy akumulowania wartości.

Umiejętności to pamięć proceduralna. Hermes może tworzyć, aktualizować i usuwać własne umiejętności oraz może zaproponować zapisanie podejścia jako umiejętność po zakończeniu złożonego zadania.

Wbudowana pamięć jest przechowywana jako pliki, takie jak MEMORY.md i USER.md pod ~/.hermes, a Hermes może również używać zewnętrznych dostawców pamięci dla głębszego odtwarzania. Dokumentacja pamięci wymienia wiele wtyczek dostawców, a przewodnik po dostawcach pamięci dokumentuje interaktywny przebieg konfiguracji. W celu pełnego technicznego rozbicia tego, jak działa architektura pamięci — zamrożone migawki, limity znaków, zewnętrzni dostawcy i filozofia ograniczonej pamięci — zobacz System pamięci Hermes Agent: Jak naprawdę działa trwała pamięć AI. Jeśli chcesz lokalnego, self-hostowanego dostawcy z niezwykłą, granulną kontrolą nad tym, co jest automatycznie zapisywane, zobacz Mnemosyne dla Hermes Agent: Szybki start lokalnej pamięci — oraz Samowzmacniające pętle pamięci w agentach AI dla wyjaśnienia, dlaczego konserwatywne domyślne wartości zapisu mają znaczenie w ogóle.

Jeśli chcesz kilku niezależnych agentów na tym samym komputerze, profile Hermes zapewniają izolację. Każdy profil otrzymuje własny katalog z własną konfiguracją, sekretami, pamięciami, sesjami, umiejętnościami, zadaniami cron i stanem bramki.

W celu głębszego spojrzenia na to, które umiejętności dobrze działają w produkcji, według roli — inżynierowie, badacze, operatorzy i workflow kadry menedżerskiej — zobacz Umiejętności asystenta Hermes AI dla rzeczywistych wdrożeń produkcyjnych. Gdy będziesz gotowy do tworzenia lub debugowania samych plików SKILL.md — metadanych YAML, poziomów progresywnego ujawniania, warunkowej widoczności i instalacji hubów — użyj [Tworzenie umiejętności Hermes Agent — Struktura SKILL.md i najlepsze praktyki](https://www.glukhov.org/pl/ai-systems/hermes/authoring-hermes-skill/ “Twórz umiejętności Hermes z frontmatterem YAML, progresywnym ujawnianiem, warunkową aktywacją, sekretami w porównaniu z konfiguracją oraz kłopotami z indeksem.”}.

Typowy workflow

Jeśli traktujesz Hermes jak agenta, który będzie z Tobą na długo, workflow zaczyna wyglądać jak inżynieria usług.

Stabilna baza

Baza, która zazwyczaj nie gnije, to:

1. Zainstaluj i uruchom pierwszy czat w CLI.
2. Wybierz dostawcę i model przez hermes model, a następnie potwierdź koszty.
3. Skonfiguruj zestawy narzędzi i zdecyduj, czy egzekucja terminala będzie lokalna, czy w sandboxie.
4. Wprowadź szybką zmianę w SOUL.md dopiero po używaniu domyślnej przez pewien czas. Zmiany tożsamości mają większe znaczenie, niż ludzie expectują, ponieważ jest to „slot 1" w systemowym prompcie.

Dzienny użycie akumulujące się

Hermes ma interfejs terminalowy, a nie interfejs webowy, i jest zaprojektowany na długie sesje z komendami skróconymi, wznowialnymi sesjami i strumieniowym outputem narzędzi. Flagi powłoki, podkomendy i skróty kreskowe dla tej sesji znajdują się w [ściące Hermes Agent CLI](https://www.glukhov.org/pl/ai-systems/hermes/hermes-agent-cli-cheatsheet/ “Szybka referencja do Hermes Agent CLI. Ścieżka instalacji, hermes chat i jednorazowe -z, model, gateway, umiejętności, pamięć, logi, profile i skróty kreskowe.”}.

W praktyce przydatna częstotliwość to:

• prowadź pracę w nazwanej sesji dla projektu
• kompresuj kontekst, gdy stanie się zbyt duży
• pozwól Hermesowi zamieniać powtarzalne rutyny w umiejętności
• utrzymuj psychiczną granicę między „pytaniem" a „działaniem", aby egzekucja narzędzi pozostała audytowalna

Bramka komunikacyjna dla dostępu 24/7

Bramka komunikacyjna to element, który sprawia, że Hermes czuje się jak asystent, a nie jak aplikacja terminalowa. Dokumentacja opisuje ją jako pojedynczy proces, który łączy się z wieloma platformami, obsługuje sesje, uruchamia zadania cron i dostarcza wiadomości.

Konfiguracja jest wywoływana przez hermes gateway setup, a bramka może działać na pierwszym planie lub jako usługa użytkownika. Referencja CLI dokumentuje podkomendy bramy, takie jak run, install, start, stop, status i restart. Jeśli chcesz, aby ten model bramy działał na dedykowanym serwerze, podczas gdy łączysz się z osobnego klienta desktopowego, użyj [Konfiguracja Hermes Agent Headless Server i zdalnego pulpitu](https://www.glukhov.org/pl/ai-systems/hermes/hermes-remote-backend-desktop/ “Uruchom Hermes Agent na serwerze headless ze zdalnym dostępem do pulpitu, usługami systemd, separacją bramy i bezpiecznymi wzorcami ekspozycji sieciowej.”}.

Dla backlogów wieloagentowych i kontrolowanego harmonogramu zobacz Kanban w Hermes Agent dla self-hostowanych workflow LLM, który obejmuje limity dyspozytora, łańcuchy zależności i batch oparty na cron.

Bezpieczeństwo dla bota używającego narzędzi ma znaczenie. Dokumentacja bramy opisuje listy dozwolonych (allowlists) dla konkretnych platformów i przepływ sparowania DM, który wydaje jednorazowe kody sparowania i wymaga akceptacji przez hermes pairing approve.

Aktualizacje bez dramatu

Aktualizacje Hermes to komenda pierwszoklasowa. Przewodnik aktualizacyjny dokumentuje hermes update, kontrole migracji konfiguracji i mały przebieg weryfikacji po aktualizacji, w tym hermes doctor i hermes gateway status.

hermes update
hermes doctor
hermes gateway status

Rozwiązywanie problemów i diagnostyka

Większość awarii Hermes nie jest tajemnicza. Wygląda tajemniczo, ponieważ ludzie sprawdzają tylko warstwę modelu i ignorują warstwę uruchomieniową.

Szybkie komendy triage

Referencja CLI wprost pozycjonuje trzy komendy jako rdzeń pętli:

• hermes doctor dla interaktywnych diagnostyk
• hermes status dla szybkiego przeglądu
• hermes dump dla udostępnialnego, zredagowanego podsumowania konfiguracji

Dla logów, hermes logs wyświetla końcówki plików przechowywanych pod ~/.hermes/logs.

hermes doctor --fix
hermes status
hermes dump --show-keys
hermes logs errors -f

Częste awarie instalacji

FAQ i przewodnik rozwiązywania problemów wymienia kilka nawracających problemów i ich napraw, w tym problemy z wersją Pythona, nieznaleziony uv oraz problemy z uprawnieniami wynikające z mieszania instalacji z sudo z instalacjami użytkownika.

Jeśli napotkasz te błędy, dokumentacja zapewnia konkretne kroki naprawcze, takie jak aktualizacja Pythona, instalacja uv i reinstalacja Hermes bez sudo.

Problemy z dostawcami i modelami

Gdy klucze API nie działają, FAQ zaleca sprawdzenie konfiguracji, ponowne uruchomienie hermes model lub ustawienie klucza bezpośrednio przez hermes config set. Zwraca też uwagę na częsty haczyk: klucze są specyficzne dla dostawcy.

Dla problemów „model nie znaleziony", FAQ odesyła do użycia hermes model, aby wybrać ważny identyfikator i pokazuje zarówno nadpisywanie konfiguracji, jak i nadpisywanie per sesji.

Obejmuje również problemy z limitami szybkości i długością kontekstu. FAQ sugeruje czekanie na błędy 429, przełączanie dostawców lub modeli oraz redukcję presji kontekstowej przez kompresję lub nową sesję.

Problemy z backendem terminalowym i bramką

Jeśli komendy terminalowe nie udają się natychmiast, przewodnik konfiguracji zawiera sekcję „częste problemy z backendem terminalowym" i wskazuje na typowe przyczyny per backend, w tym nierozuruchomiony Docker i brakujące zmienne SSH. Uwaga również, że cofnięcie się do local jest ważnym ruchem debugowania, gdy konfiguracja sandboxa jest pod wątpliwością.

Dla problemów z bramką, przewodnik komunikacyjny podkreśla listy dozwolonych i sparowanie jako bezpieczne wartości domyślne, co oznacza, że wiele incydentów „bot jest cichy" to tak naprawdę autoryzacja wykonująca swoją pracę.

Referencje

• Strona główna Hermes Agent
• System pamięci Hermes Agent: Jak naprawdę działa trwała pamięć AI
• Umiejętności asystenta Hermes AI dla rzeczywistych wdrożeń produkcyjnych