Jak utrzymać Hermes Agent na serwerze przez całą dobę

Po zainstalowaniu Hermes Agent na laptopie pojawia się pytanie: kto będzie odpowiadać na Telegramie i przygotowywać poranne podsumowania, kiedy laptop jest zamknięty? Przy biurku agent działa tylko wtedy, gdy komputer jest włączony. Aby bot był stale online, a zaplanowane zadania uruchamiały się samodzielnie, trzeba przenieść agenta na serwer.

Poniżej opisano, jak zainstalować Hermes na zwykłym serwerze Linux, przekształcić bramę w stale działającą usługę uruchamianą automatycznie po ponownym rozruchu oraz ograniczyć dostęp, aby nieznajomi nie mogli dostać się do terminala. Ten poradnik opiera się na oficjalnej dokumentacji.

Jeśli jeszcze nie instalowałeś Hermes, zacznij od osobnego omówienia tego, czym jest ten agent i jak go zainstalować. Ten poradnik zakłada, że agent już działa na twoim komputerze, i dotyczy wyłącznie przeniesienia go na serwer.

Informacje o korzystaniu z Ailoot znajdziesz w dokumentacji.

Dlaczego przenieść Hermes Agent z laptopa na serwer?#

Na laptopie Hermes działa tylko wtedy, gdy pokrywa jest otwarta, a ty jesteś w pobliżu. Zamknij go, a bot zamilknie; poranne podsumowanie nie dotrze. To nie sprawdzi się przy zadaniu takim jak „odpowiadaj ludziom w komunikatorze i załatwiaj sprawy zgodnie z harmonogramem”.

Na tym polega różnica w przypadku serwera: nigdy nie zasypia i nie zależy od niczego innego. Instalujesz na nim tego samego Hermes, a on działa bez ciebie: odpowiada na Telegramie o trzeciej nad ranem, każdego ranka zbiera wiadomości na wybrane tematy i zachowuje sesje między uruchomieniami.

Przeniesienie ma sens, gdy agent ma wykonywać stałe zadanie: obsługiwać bota dla ciebie lub zespołu, przygotowywać poranne podsumowania, automatycznie odpowiadać albo regularnie pracować z dokumentami. Jeśli tylko wypróbowujesz Hermes w konkretnym projekcie i jesteś w pobliżu, serwer nie jest jeszcze potrzebny; to dodatkowy krok.

Co przygotować przed instalacją Hermes na VPS-ie?#

Przed instalacją przygotuj trzy rzeczy.

Serwer. Wystarczy zwykły VPS z systemem Linux. Dokumentacja wymienia Linux i WSL2 jako platformy z podstawowym poziomem wsparcia, a testy są przeprowadzane na najnowszym Ubuntu. Jeśli system ma glibc, systemd i typowy układ katalogów, Hermes zainstaluje się prawidłowo. Na serwerze ma to znaczenie, ponieważ wszystkie opisane poniżej kroki automatycznego uruchamiania opierają się na systemd, który jest standardowo dostępny w Ubuntu i Debianie.

Dostęp przez SSH. Łączysz się z serwerem przez terminal i SSH; nie będziesz tam używać myszy. Wszystkie poniższe polecenia wykonasz w tej sesji SSH. Jeśli tworzysz oprogramowanie z pomocą AI, ale nie czujesz się jeszcze pewnie w terminalu, nie martw się: poleceń jest tylko kilka i każde możesz skopiować w całości.

Wybrany model. Agent nie myśli samodzielnie; wywołuje model. W przypadku serwera działającego bez twojego udziału ważne jest, aby dostęp do modelu nie wygasał. Najprostsza opcja to subskrypcja Nous Portal przez hermes setup --portal: logowanie odbywa się za pomocą OAuth, a token odświeża się automatycznie. Możesz też użyć własnych kluczy API, ale wtedy upewnij się, że na koncie są środki — agent bez interfejsu graficznego i z pustym saldem po prostu przestanie odpowiadać. Okno kontekstu modelu musi mieć co najmniej 64,000 tokenów, w przeciwnym razie Hermes odmówi uruchomienia z tym modelem. Wszystkie wymienione modele chmurowe spełniają ten warunek.

Jak zainstalować Hermes Agent na serwerze za pomocą jednego polecenia?#

Instalacja na serwerze wygląda niemal tak samo jak na laptopie, z jedną różnicą: agent zwykle nie potrzebuje tam przeglądarki. Automatyzacja przeglądarki wymaga też Chromium, które zajmuje dużo miejsca. Dlatego używa się flagi --skip-browser.

1. Połącz się z serwerem przez SSH

   ssh root@your-server-address
   

   Wszystkie kolejne polecenia uruchamiaj w tej sesji, bezpośrednio na serwerze.

2. Uruchom instalator bez przeglądarki

   curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash -s -- --skip-browser
   

   Skrypt pobierze wymagane środowisko i zainstaluje polecenie hermes. Flaga --skip-browser pomija instalację automatyzacji przeglądarki; na serwerze bez interfejsu graficznego zajmowałaby tylko miejsce. Jeśli później potrzebujesz przeglądarki, możesz zainstalować ją osobno.

3. Uruchom ponownie powłokę i wybierz model

   source ~/.bashrc
   hermes setup --portal
   

   Pierwsza linia wczytuje nowy PATH, aby można było znaleźć polecenie hermes. Druga uruchamia logowanie do Nous Portal: potwierdź logowanie, a agent uzyska dostęp do modelu i usług bez osobnych kluczy do każdej z nich.

4. Sprawdź instalację

   hermes doctor
   

   Polecenie pokazuje, co zostało zainstalowane, czego brakuje i jak to naprawić. Zielone oznaczenia wskazują, że wszystko jest gotowe.

Zanim dodasz bota i harmonogram, przeprowadź na serwerze jedną poprawną rozmowę: uruchom hermes i zleć mu proste zadanie z weryfikowalną odpowiedzią. Dokumentacja wyraźnie odradza dodawanie kolejnych funkcji, zanim zwykła rozmowa zacznie działać — to rozsądna rada.

Jak utrzymać Hermes w działaniu przez całą dobę?#

Brama to pojedynczy proces Hermes działający w tle, który utrzymuje połączenia ze wszystkimi komunikatorami, zarządza sesjami i uruchamia zaplanowane zadania. Cała praca przez całą dobę opiera się na tej bramie. Celem jest automatyczne uruchamianie procesu i utrzymywanie go w działaniu.

Najpierw skonfiguruj bramę i połącz komunikator:

hermes gateway setup

Kreator konfiguracji przeprowadzi cię przez platformy i pomoże wprowadzić token bota oraz listę dostępu. Kroki łączenia z Telegramem (tworzenie bota przez BotFather, sprawdzanie własnego ID i wprowadzanie tokena) opisano w głównym poradniku instalacji; nie będę ich tutaj powtarzać.

Teraz pułapka, o której najczęściej się zapomina. Jeśli po prostu uruchomisz hermes gateway, proces będzie działać tylko do czasu zamknięcia sesji SSH. Zamknij terminal, a brama się zatrzyma. Aby działała bez przerwy, trzeba przekazać ją pod kontrolę systemu. Służy do tego jedno polecenie:

hermes gateway install

Instaluje ono bramę jako usługę: w systemie Linux jako usługę użytkownika systemd, a w macOS przez launchd. System monitoruje proces i uruchamia go ponownie, jeśli ulegnie awarii.

Na serwerze częściej potrzebna będzie druga opcja: usługa systemowa, która uruchamia się wraz z maszyną, jeszcze przed zalogowaniem dowolnego użytkownika:

sudo hermes gateway install --system

Tego właśnie potrzebujesz na VPS-ie: serwer uruchamia się ponownie, usługa startuje samodzielnie, a bot wraca online. Zarządzaj nią za pomocą tych prostych poleceń:

hermes gateway start     # start
hermes gateway stop      # stop
hermes gateway status    # check status

W przypadku usługi systemowej dodaj do tych poleceń sudo i flagę --system. Bez nich polecenia będą dotyczyć usługi użytkownika, a nie tej uruchamianej podczas startu:

sudo hermes gateway start --system
sudo hermes gateway stop --system
sudo hermes gateway status --system

Dlaczego potrzebny jest linger i co przestanie działać bez niego?#

To najczęstsza przeszkoda: usługa została zainstalowana, ale bot i tak milknie w nocy. Przyczyną jest sposób działania usług użytkownika w systemie Linux.

Usługa użytkownika systemd jest domyślnie powiązana z twoją sesją. Łączysz się przez SSH, uruchamia się menedżer użytkownika, a usługa zaczyna działać. Wylogowujesz się, a system uznaje użytkownika za nieaktywnego i wyłącza jego usługi razem z bramą. Na serwerze, do którego logujesz się i z którego się wylogowujesz, to problem: bot jest online tylko wtedy, gdy jesteś połączony przez SSH.

Możesz to naprawić, włączając tryb linger, który pozwala systemowi utrzymywać menedżer użytkownika nawet wtedy, gdy użytkownik nie jest zalogowany:

sudo loginctl enable-linger username

Po wykonaniu tego polecenia usługa użytkownika działa samodzielnie i uruchamia się podczas startu serwera, bez oczekiwania na twoje logowanie. Bez linger system wraca do poprzedniego działania: brama zatrzymuje się po zakończeniu sesji SSH i nie uruchamia się przy starcie systemu. Dokumentacja stwierdza to wprost.

Jak uruchomić Hermes na serwerze w Dockerze z automatycznym restartem?#

Docker to kolejny sprawdzony sposób na utrzymanie agenta na serwerze. Sprawdza się szczególnie wtedy, gdy masz już doświadczenie z kontenerami albo chcesz odizolować agenta od głównego systemu. Skonfiguruj go raz za pomocą docker run ... setup, a następnie uruchom kontener w tle:

docker run -d \
  --name hermes \
  --restart unless-stopped \
  -v ~/.hermes:/opt/data \
  -p 8642:8642 \
  nousresearch/hermes-agent gateway run

Oto co robią wiersze odpowiedzialne za pracę przez całą dobę:

• -d — kontener działa w tle i nie wymaga pozostawienia otwartego terminala.
• --restart unless-stopped — Docker uruchamia kontener ponownie po restarcie serwera lub awarii. Nie uruchomi go ponownie tylko wtedy, gdy zatrzymasz go ręcznie.
• -v ~/.hermes:/opt/data — ustawienia, klucze, sesje i pamięć są przechowywane na serwerze, poza kontenerem, i pozostają dostępne po jego ponownym utworzeniu.

Obraz zapewnia dodatkowe zabezpieczenie: procesem bramy zarządza nadzorca s6. Jeśli brama ulegnie awarii, zostanie uruchomiona ponownie w ciągu kilku sekund, bez utraty samego kontenera. To podwójna ochrona: Docker z zewnątrz utrzymuje kontener w działaniu, a s6 monitoruje proces wewnątrz.

Pamiętaj o jednej różnicy w podejściu z Dockerem: takich instalacji nie aktualizuje się poleceniem hermes update. Aby zaktualizować Dockera, zastąp obraz nowym — pobierz najnowszy i odtwórz kontener.

Jak sprawdzić, czy wszystko działa i przetrwa ponowne uruchomienie?#

Status i dzienniki usługi użytkownika sprawdzisz tak:

hermes gateway status
journalctl --user -u hermes-gateway -f

Dla usługi systemowej zalecanej na VPS użyj zamiast tego zakresu systemowego:

sudo hermes gateway status --system
sudo journalctl -u hermes-gateway -f

Pierwsze polecenie sprawdza wybraną usługę, drugie śledzi jej dziennik. Te nazwy jednostek dotyczą domyślnej instalacji ~/.hermes. Inny katalog Hermes może mieć jednostkę z przyrostkiem: sprawdź wynik statusu i użyj dokładnej nazwy. Nie monitoruj jednostki użytkownika przy testowaniu instalacji systemowej. Logi Hermes znajdują się w ~/.hermes/logs/, a sekrety są automatycznie redagowane, więc można bezpiecznie wysłać je do pomocy technicznej.

Teraz uruchom ponownie serwer i upewnij się, że agent wróci do działania samodzielnie. To najważniejszy test serwera i zwykle właśnie o nim ludzie zapominają:

sudo reboot

Gdy serwer znów będzie osiągalny, połącz się przez SSH. Dla instalacji systemowej sprawdź sudo hermes gateway status --system i jej dziennik systemowy; dla instalacji użytkownika z linger sprawdź hermes gateway status i dziennik użytkownika. Następnie napisz do bota na Telegramie. Jeśli odpowie bez twojej ingerencji, automatyczne uruchamianie jest skonfigurowane prawidłowo. Właśnie o to chodziło.

Nie musisz się martwić o utratę rozmowy. Hermes zapisuje sesje na dysku, dzięki czemu przetrwają ponowne uruchomienie bramy. Co więcej, jeśli brama ulegnie awarii akurat podczas wysyłania odpowiedzi, po przywróceniu działania dostarczy tę odpowiedź zamiast ponownie wykonywać zadanie. To ważne w przypadku bota działającego przez całą dobę: nieoczekiwany restart nie przerwie rozmowy.

Jak zabezpieczyć agenta z dostępem do terminala na serwerze?#

Agent na serwerze to program z dostępem do terminala, który działa bez twojego nadzoru. Najpierw sprawdź te trzy ustawienia.

Zamknięty dostęp do bota. Domyślnie brama odpowiada tylko osobom z listy dostępu albo tym, które ukończyły łączenie za pomocą kodu w wiadomości prywatnej. Tak powinien zachowywać się bot z dostępem do terminala: przypadkowa osoba, która napisze do bota, nie może nic zrobić. Listę ustawia się za pomocą identyfikatorów liczbowych, na przykład dla Telegrama:

TELEGRAM_ALLOWED_USERS=123456789,987654321

Potwierdzenie niebezpiecznych poleceń. Przed wykonaniem destrukcyjnej operacji agent prosi o zgodę. Istnieje tryb YOLO, który wyłącza potwierdzenia; najlepiej nie włączać go na serwerze działającym bez twojego nadzoru. Potwierdzenia mają właśnie zapobiegać nieodwracalnym działaniom bez twojej wiedzy.

Piaskownica zapewniająca pełną izolację. Jeśli chcesz uniemożliwić agentowi fizyczny dostęp do głównego systemu serwera, uruchamiaj jego polecenia w kontenerze Dockera:

hermes config set terminal.backend docker

Od tej pory wszystkie działania agenta w terminalu odbywają się w odizolowanej piaskownicy i nie mogą dosięgnąć działającego serwera. To rozsądne zabezpieczenie, gdy pozwalasz agentowi działać samodzielnie.

Co zrobić, jeśli bot milczy lub brama ulega awarii?#

Gdy bot przestaje odpowiadać, postępuj w tej kolejności. Najpierw sprawdź zainstalowany zakres: sudo hermes gateway status --system i dziennik systemowy dla usługi systemowej albo hermes gateway status i dziennik użytkownika dla usługi użytkownika. Jeśli brama działa, ale wiadomości nie docierają, niemal zawsze chodzi o konfigurację platformy: token bota jest nieprawidłowy albo danej osoby nie ma na liście dostępu. Uruchom ponownie hermes gateway setup w tym samym katalogu Hermes, a następnie sprawdź wybraną usługę przez hermes gateway status --system dla systemowej lub hermes gateway status dla użytkownika. Udana konfiguracja nie dowodzi działania właściwej bramy.

Jeśli model zwraca puste lub dziwne odpowiedzi, sprawdź go za pomocą hermes model i potwierdź dostawcę oraz stan logowania. Ogólna procedura przywracania działania po tym, jak „wszystko się zepsuło”, to: hermes doctor, hermes model, hermes setup, a potem hermes gateway status --system dla instalacji systemowej lub hermes gateway status dla instalacji użytkownika.

Jest jeszcze jedna rzecz na wypadek rzadkiej, ale nieprzyjemnej sytuacji, gdy cały proces zawiesza się bez awarii. Usługa systemd ma licznik czasu watchdog: dodaj poniższy wiersz do ~/.hermes/config.yaml i ponownie zainstaluj usługę.

gateway:
  systemd_watchdog_seconds: 120

# Usługa systemowa VPS (ten sam katalog Hermes co w pierwotnej instalacji):
sudo hermes gateway install --system --force
sudo hermes gateway status --system

Dla usługi użytkownika odtwórz tylko ten zakres przez hermes gateway install --force i sprawdź hermes gateway status. Wybierz jeden zakres; nie instaluj obu w celu naprawy jednej bramy.

Od tej pory brama regularnie wysyła do systemu sygnał „działam”, a gdy sygnały ustaną, systemd automatycznie ponownie uruchamia proces. Działa to tylko w systemie Linux z systemd i tylko w przypadku zawieszenia procesu. Licznik watchdog nie wpływa na zwykłe przerwy w połączeniu sieciowym między serwerem a komunikatorem.

O co jeszcze pytają użytkownicy Hermes Agent na serwerze?#

Poznaj Ailoot.