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

Hermes Agent to samohostowany, agnostyczny względem modelu asystent AI, działający na komputerze lokalnym lub tanim VPS. Przetwarza dane za pomocą interfejsu terminala i komunikatorów oraz z biegiem czasu zwiększa swoją skuteczność, zamieniając powtarzalne zadania w wielokrotnego użytku umiejętności.

Pod względem funkcjonalności jest bardzo podobny do OpenClaw, innej samohostowanej steki asystenta opartej na narzędziach, pamięci i lokalnej kontroli. Wiele programistów znalazło drogę do Hermes po tym, jak w kwietniu 2026 roku Anthropic zablokował dostęp do subskrypcji Claude w OpenClaw — oś czasu wzrostu i upadku OpenClaw wyjaśnia, dlaczego Hermes stał się naturalnym celem dla użytkowników, którzy chcieli trwałej, samohostowanej automatyzacji bez zależności od dostawcy.

Jeśli chcesz mieć szerszy obraz samohostowanych asystentów, wyszukiwania i lokalnej infrastruktury otaczającej Hermes, to przegląd systemów AI łączy te tematy z tymi samymi problemami, które Hermes stara się rozwiązać. W sprawie pięciowarstwowego modelu asystenta — LLM, pamięć, narzędzia, routing i obserwowalność — z Hermes i OpenClaw jako referencyjnymi implementacjami, zobacz Architektura asystenta AI. Aby uzyskać konkretne dane adopcji — gwiazdki GitHuba, dzienne wolumeny tokenów OpenRouter, liczby pobrań z PyPI, historię CVE i sentyment społeczności na Reddicie — OpenClaw vs Hermes Agent: Gwiazdki, Pobrania i Użycie 2026 śledzi, jak Hermes porównuje się do 19 alternatyw pod każdym mierzalnym sygnałem.

W sprawie kompromisów przy wdrażaniu i wyborów dotyczących środowiska wykonawczego, Hosting LLM w 2026 roku: Porównanie infrastruktury lokalnej, samohostowanej i chmurowej dostarcza mapę hostingową, podczas gdy [Wydajność LLM w 2026 roku: Testy, wąskie gardła i optymalizacja](https://www.glukhov.org/pl/llm-performance/ “Praktyczna inżynieria wydajności LLM: przepustowość względem opóźnienia, ograniczenia VRAM, równoległe żądania, alokacja pamięci i testy w różnych środowiskach wykonawczych i sprzęcie.”}) omawia kwestie przepustowości i opóźnienia, gdy Hermes już działa. Jeśli regularnie kierujesz Hermes do Qwen lub Gemma na lokalnych środowiskach wykonawczych, takich jak Ollama, konsoliduj ustawienia temperatury i kar za wieloetapowe użycie narzędzi dzięki Parametry inferencji LLM agentic dla Qwen i Gemma. Dla zwartej mapy poleceń shell (hermes gateway, hermes memory, hermes doctor, skróty slash i więcej), użyj ściągawki CLI Hermes Agent. Jeśli głównym punktem wejścia jest komunikacja na telefonie, użyj Sterowanie głosem Hermes z telefonu, aby uzyskać stack głosowy i konfigurację specyficzną dla platformy.

Moja obiektywna opinia: Hermes jest najciekawszy, gdy traktowany jest jako infrastruktura, a nie jako zakładka, którą otwierasz od czasu do czasu. Gdy działa jako usługa i ma stabilny katalog domowy, Twoje prompty zaczynają wyglądać mniej jak „czat", a bardziej jak „operacje".

Czym jest Hermes Agent i dlaczego jest ważny

Hermes Agent to open-source’owy agent AI stworzony przez Nous Research. Jest zaprojektowany tak, aby działać trwale, używać narzędzi (terminal, pliki, web i inne) oraz z czasem poprawiać swoje zachowanie dzięki systemowi umiejętności i pamięci.

Dwie decyzje projektowe są warte omówienia, ponieważ kształtują wszystko inne w tym przewodniku.

Po pierwsze, Hermes nie jest zablokowany do jednego dostawcy modelu. Oficjalny przepływ konfiguracji obsługuje wiele dostawców i dowolny koniec API zgodny z OpenAI, a przełączanie odbywa się za pomocą polecenia hermes model, a nie przez edytowanie kodu.

Po drugie, Hermes wyciąga twardą linię między „rozmową" a „wykonywaniem". Agent może rozmawiać cały dzień, ale gdy musi działać, robi to przez wyraźne narzędzia i konfigurowalny backend wykonawczy. Tam właśnie mieszkają bezpieczeństwo, odtwarzalność i rozwiązywanie problemów.

Koszty i licencje są rzeźwiąco nudne. Sam Hermes Agent jest darmowym oprogramowaniem na licencji MIT. Jeśli używasz modeli hostowanych, ciągły koszt to to, co pobiera Twój dostawca. Jeśli uruchamiasz modele lokalnie, możesz całkowicie uniknąć opłat za API.

Jeśli Twoja konfiguracja Hermes używa Claude przez zewnętrzne warstwy narzędziowe, ta zmiana subskrypcji Anthropic jest użytecznym odniesieniem, dlaczego fakturowanie oparte na API to teraz oczekiwana ścieżka.

Instalacja Hermes Agent

Hermes ma szybką ścieżkę instalacji dla Linux, macOS i WSL2. Oficjalna dokumentacja utrzymuje ją świadomie prostą.

Instalacja Hermes na Linux

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 swój shell i uruchom CLI.

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

Instalator to nie tylko cienka nakładka. Zgodnie z przewodnikiem instalacyjnym, konfiguruje zależności, repozytorium, środowisko wirtualne oraz polecenie hermes, a następnie doprowadza Cię do pierwszego stanu gotowego do czatu.

Jeśli przychodzisz z istniejącego wdrożenia OpenClaw, a nie zaczynasz od zera, najpierw zainstaluj i zwaliduj pustego Hermesa, a następnie postępuj zgodnie z etapowym przełączeniem w 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ą zostać przebudowane ręcznie.

Uwagi dotyczące Windows i Android

Natywne Windows nie jest wspierane. Dokumentacja zaleca WSL2 i uruchamianie Hermesa w jego wnętrzu.

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

Szybki start

Najszybszy pierwszy uruchomienie to dosłownie tylko hermes, ale sensowny szybki start oznacza dwie dodatkowe decyzje: który dostawca modelu ma być użyty i które narzędzia powinny być włączone.

Wybór dostawcy i modelu

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

• hermes model do wyboru dostawcy i domyślnego modelu
• hermes tools do włączania lub wyłączania zestawów narzędzi
• hermes setup do uruchomienia interaktywnego kreatora w kluczowych obszarach konfiguracji

Minimalny przepływ wygląda tak:

hermes model
hermes tools
hermes

W kwestii tego, co faktycznie jest wspierane, oficjalny przewodnik szybkiego startu wymienia szeroki zakres dostawców i podkreśla również, że Hermes działa z API zgodnymi z OpenAI. To jest ważne, ponieważ obejmuje to zarówno usługi hostowane, jak i końcówki samohostowane.

Weryfikacja wykonywania narzędzi we wczesnym etapie

Zanim zbudujesz nawyki wokół Hermesa, warto zweryfikować, czy użycie narzędzi działa w Twoim środowisku. Przewodnik szybkiego startu wyraźnie sugeruje użycie terminala jako pierwszej funkcji do przetestowania.

W praktyce mały prompt „smoke test" spełnia dwie funkcje: sprawdza narzędzie terminala i waliduje prośby o uprawnienia.

Przykładowy prompt:

Pokaż moje użycie dysku i pięć największych katalogów.

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

Konfiguracja skalowalna

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

Gdzie znajdują się konfiguracja i stan

Hermes przechowuje swoje ustawienia i stan pod ~/.hermes. Oficjalny przewodnik konfiguracyjny 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 folderów dla pamięci, umiejętności, cron, sesji i logów.

To ma znaczenie z dwóch powodów.

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

Priorytet konfiguracji i trzymanie sekretów poza config.yaml

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

Miłym detalem jest to, że hermes config set kieruje wartości do odpowiedniego pliku: klucze API do .env, a nie-sekretne 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ż podstawianie zmiennych środowiskowych wewnątrz config.yaml za pomocą składni ${VAR_NAME}. To jest przydatne, gdy chcesz utrzymywać pewne wartości w środowisku, nadal odnosząc się do nich w strukturalnej konfiguracji.

Sandboxy i backends wykonawcze

Hermes obsługuje wiele backendów terminalowych, które definiują, gdzie faktycznie wykonują się polecenia shell. Przewodnik konfiguracyjny wymienia local, docker, ssh, modal, daytona i singularity.

Opiniotwórczy, ale nie misyjny sposób myślenia o tym jest taki:

• local jest najszybszy i najprostszy, ale nie jest izolowany
• docker to pragmatyczna warstwa bezpieczeństwa i odtwarzalności
• ssh to czysty sposób na oddzielenie urządzenia do czatu od maszyny obliczeniowej
• modal i daytona pasują do przepływów „serverless, ale wystarczająco trwałych"
• singularity to opcja przyjazna dla HPC

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ż zacieśnianie bezpieczeństwa dla backendu Docker, takie jak usuwanie uprawnień i wyłączanie eskalacji przywilejów.

Umiejętności, pamięć i profile

Hermes ma dwa powiązane mechanizmy kumulowania 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 ukoń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 do głębszego przywoływania. Dokumentacja pamięci wymienia wiele wtyczek dostawców, a przewodnik dostawców pamięci dokumentuje interaktywny przepływ konfiguracji. Aby uzyskać pełny techniczny rozkład 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, samohostowanego dostawcy z wyjątkowo szczegółową kontrolą nad tym, co jest automatycznie zapisywane, zobacz Mnemosyne dla Hermes Agent: Szybki start lokalnej pamięci, a także Samo-wzmacniające pętle pamięci w agentach AI, aby zrozumieć, dlaczego konserwatywne domyślne wartości zapisu mają znaczenie w pierwszym miejscu.

Jeśli chcesz mieć wiele niezależnych agentów na tej samej maszynie, profile Hermes zapewniają izolację. Każdy profil dostaje własny katalog z własną konfiguracją, sekretami, pamięcią, sesjami, umiejętnościami, zadaniami cron i stanem gateway.

Aby przyjrzeć się dokładniej, które umiejętności dobrze działają w produkcji według ról — inżynierowie, badacze, operatorzy i przepływy wykonawcze — zobacz Umiejętności asystenta AI Hermes dla realnych konfiguracji produkcyjnych. Gdy będziesz gotowy, aby tworzyć lub debugować same pliki SKILL.md — metadane YAML, poziomy progresywnego ujawniania, warunkowa widoczność i instalacje hub — użyj Autorowanie umiejętności Hermes Agent — Struktura i najlepsze praktyki SKILL.md.

Typowy przepływ pracy

Jeśli traktujesz Hermes jako agenta, którego zostawiasz na stałe, przepływ pracy zaczyna wyglądać jak inżynieria usług.

Stabilna linia bazowa

Linia bazowa, która zwykle nie ulega zepsuciu, to:

1. Zainstaluj i uruchom pierwszy czat w CLI.
2. Wybierz dostawcę i model za pomocą hermes model, a następnie potwierdź koszty.
3. Skonfiguruj zestawy narzędzi i zdecyduj, czy wykonanie terminala ma być lokalne, czy w sandboxie.
4. Dokonaj szybkiej zmiany w SOUL.md tylko wtedy, gdy używałeś domyślnego przez pewien czas. Zmiany tożsamości mają większe znaczenie, niż ludzie myślą, ponieważ to „slot 1" w promptcie systemowym.

Codzienne użycie, które się kumuluje

Hermes ma interfejs terminalowy (TUI) zamiast interfejsu webowego i jest zaprojektowany do długich sesji z poleceniami slash, wznawialnymi sesjami i strumieniowym wyjściem narzędzi.

W praktyce użyteczny rytm to:

• wykonuj pracę w nazwanej sesji dla projektu
• kompresuj kontekst, gdy stanie się on zbyt duży
• pozwól Hermesowi zamieniać powtarzalne rutyny w umiejętności
• utrzymuj mentalną granicę między „pytaniem" a „działaniem", aby wykonanie narzędzi pozostawało audytowalne

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 podpolecenia gateway, takie jak run, install, start, stop, status i restart. Jeśli chcesz, aby ten model bramki działał na dedykowanym serwerze, podczas gdy łączysz się z osobnego klienta desktopowego, użyj Hermes Agent Serwer headless i konfiguracja zdalnego pulpitu.

Dla kolejek zadań wieloagentowych i kontrolowanego harmonogramu zobacz Kanban w Hermes Agent dla samohostowanych przepływów LLM, który obejmuje limity dyspozytora, łańcuchy zależności i partycjonowanie oparte o cron.

Bezpieczeństwo bota używającego narzędzi ma znaczenie. Dokumentacja bramki opisuje listy dozwolone dla konkretnych platform i przepływ parowania DM, który wydaje jednorazowe kody parowania i wymaga akceptacji przez hermes pairing approve.

Aktualizacje bez dramatu

Aktualizacje Hermes to pierwszorzędne polecenie. Przewodnik aktualizacyjny dokumentuje hermes update, kontrole migracji konfiguracji oraz mały rutynowy przebieg walidacji 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ądają tajemniczo, ponieważ ludzie sprawdzają tylko warstwę modelu i ignorują warstwę wykonawczą.

Szybkie polecenia diagnostyczne

Referencja CLI wyraźnie pozycjonuje trzy polecenia jako pętlę rdzeniową:

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

Dla logów, hermes logs wyświetla ogon plików przechowywanych pod ~/.hermes/logs.

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

Częste niepowodzenia instalacyjne

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

Jeśli napotkasz te błędy, dokumentacja dostarcza konkretnych kroków naprawczych, takich jak aktualizacja Pythona, instalacja uv i ponowna instalacja 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. Wywołuje też uwagę na częstą pułapkę: klucze są specyficzne dla dostawcy.

Dla problemów „model nieznaleziony", FAQ wskazuje na użycie hermes model do wyboru ważnego identyfikatora i pokazuje nadpisania konfiguracji i per-sesję.

Obejmuje to 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 zmniejszanie presji kontekstowej poprzez kompresję lub nową sesję.

Problemy z backendem terminalowym i bramką

Jeśli polecenia terminalowe nie powiodą się natychmiast, przewodnik konfiguracyjny zawiera sekcję „częste problemy z backendem terminalowym" i wskazuje na typowe przyczyny dla każdego backendu, w tym nieuruchomiony Docker i brakujące zmienne SSH. Zwraca również uwagę, że cofnięcie się do local to ważny ruch diagnostyczny, gdy konfiguracja sandboxa jest kwestionowana.

Dla problemów z bramką, przewodnik komunikacyjny podkreśla listy dozwolone i parowanie jako bezpieczne wartości domyślne, co oznacza, że wiele incydentów „bot milczy" to w rzeczywistości 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 AI Hermes dla realnych konfiguracji produkcyjnych