Näin pidät Hermes Agentin käynnissä palvelimella ympäri vuorokauden

Kun Hermes Agent on asennettu kannettavalle tietokoneelle, mieleen tulee kysymys: kuka vastaa Telegramissa ja kokoaa aamukatsaukset, kun tietokone on sammutettuna? Työpöydän ääressä agentti toimii vain niin kauan kuin tietokone on päällä. Jos haluat pitää botin jatkuvasti verkossa ja saada ajastetut tehtävät suoritettua automaattisesti, agentti täytyy siirtää palvelimelle.

Tässä kerrotaan, miten Hermes asennetaan tavalliselle Linux-palvelimelle, gateway muutetaan jatkuvasti toimivaksi palveluksi, joka käynnistyy automaattisesti uudelleenkäynnistyksen jälkeen, ja käyttöoikeuksia rajoitetaan niin, etteivät ulkopuoliset pääse terminaaliin. Opas perustuu viralliseen dokumentaatioon.

Jos et ole vielä asentanut Hermesiä, aloita erillisestä yleiskatsauksesta, jossa kerrotaan mikä tämä agentti on ja miten se asennetaan. Tässä oppaassa oletetaan, että agentti on jo käynnissä omalla koneellasi, ja käsitellään vain sen siirtämistä palvelimelle.

Tietoa Ailootin käytöstä on dokumentaatiossa.

Miksi Hermes Agent kannattaa siirtää kannettavalta tietokoneelta palvelimelle?#

Kannettavalla tietokoneella Hermes toimii vain, kun kansi on auki ja olet lähellä. Sulje kansi, niin botti vaikenee eikä aamukatsausta tule. Se ei sovi tehtävään, kuten ”vastaa ihmisille viestisovelluksessa ja hoida asioita aikataulun mukaan”.

Palvelin on erilainen: se ei koskaan nuku eikä ole riippuvainen mistään muusta. Asennat siihen saman Hermesiin, ja se toimii ilman sinua: vastaa Telegramissa kolmelta aamuyöllä, kokoaa uutisia valitsemistasi aiheista joka aamu ja säilyttää istunnot ajokertojen välillä.

Siirto on järkevää, kun agentilla on jatkuva tehtävä: botti sinulle tai tiimillesi, aamukatsaukset, automaattiset vastaukset tai säännöllinen asiakirjojen käsittely. Jos vain kokeilet Hermesiä tiettyä projektia varten ja olet itse paikalla, et vielä tarvitse palvelinta; se on ylimääräinen vaihe.

Mitä pitää valmistella ennen Hermesin asentamista VPS:lle?#

Valmistele kolme asiaa ennen asennusta.

Palvelin. Tavallinen Linux-VPS riittää. Dokumentaation ensisijainen tuki koskee Linuxia ja WSL2:ta, ja testaus tehdään uusimmalla Ubuntulla. Jos järjestelmässä on glibc, systemd ja tuttu hakemistorakenne, Hermes asentuu oikein. Tämä on tärkeää palvelimella, sillä kaikki alla olevat automaattisen käynnistyksen vaiheet perustuvat systemd:hen, joka sisältyy valmiiksi Ubuntuun ja Debianiin.

SSH-yhteys. Yhdistät palvelimeen terminaalin kautta SSH:lla; siellä ei käytetä hiirtä. Kaikki alla olevat komennot suoritetaan tässä SSH-istunnossa. Jos vibe-koodaat etkä vielä tunne oloasi mukavaksi terminaalissa, älä huoli: komentoja on vain muutama, ja voit kopioida ne kokonaisuudessaan.

Valittu malli. Agentti ei ajattele itsenäisesti, vaan kutsuu mallia. Ilman sinua toimivalla palvelimella on tärkeää, ettei pääsy malliin vanhene. Yksinkertaisin vaihtoehto on Nous Portal -tilaus komennolla hermes setup --portal: kirjautuminen käyttää OAuthia, ja token uusiutuu automaattisesti. Myös omat API-avaimet käyvät, mutta varmista silloin, että tilillä on rahaa — tyhjällä saldolla varustettu headless-agentti vain vaikenee. Mallin konteksti-ikkunan on oltava vähintään 64,000 tokenia, muuten Hermes kieltäytyy käynnistymästä sillä. Kaikki luettelon pilvimallit täyttävät tämän vaatimuksen.

Miten Hermes Agent asennetaan palvelimelle yhdellä komennolla?#

Asennus palvelimelle on lähes samanlainen kuin kannettavalle tietokoneelle, yhtä eroa lukuun ottamatta: agentti ei yleensä tarvitse siellä selainta. Selainautomaatio tuo mukanaan myös raskaan Chromiumin. Siksi käytetään lippua --skip-browser.

1. Yhdistä palvelimeen SSH:lla

   ssh root@your-server-address
   

   Suorita kaikki seuraavat komennot tässä istunnossa itse palvelimella.

2. Suorita asennusohjelma ilman selainta

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

   Skripti lataa tarvittavan ympäristön ja asentaa hermes-komennon. Lippu --skip-browser ohittaa selainautomaation asennuksen; graafista käyttöliittymää vailla olevalla palvelimella se vain veisi tilaa. Jos tarvitset selainta myöhemmin, voit asentaa sen erikseen.

3. Käynnistä komentotulkki uudelleen ja valitse malli

   source ~/.bashrc
   hermes setup --portal
   

   Ensimmäinen rivi ottaa uuden PATH-asetuksen käyttöön, jotta hermes-komento löytyy. Toinen avaa Nous Portal -kirjautumisen: vahvista kirjautuminen, niin agentti saa mallin ja palvelut ilman erillisiä avaimia jokaista varten.

4. Tarkista asennus

   hermes doctor
   

   Komento näyttää, mitä on asennettu, mitä puuttuu ja miten puutteet korjataan. Vihreät merkit tarkoittavat, että kaikki on kunnossa.

Ennen botin ja aikataulun lisäämistä varmista, että tavallinen keskustelu toimii palvelimella: suorita hermes ja anna sille yksinkertainen tehtävä, jonka vastauksen voi tarkistaa. Dokumentaatiossa nimenomaisesti neuvotaan olemaan kasaamatta ominaisuuksia ennen kuin tavallinen keskustelu toimii — järkevä neuvo.

Miten Hermes pidetään käynnissä ympäri vuorokauden?#

Gateway on yksi taustalla toimiva Hermes-prosessi, joka ylläpitää yhteyksiä kaikkiin viestisovelluksiin, hallitsee istuntoja ja suorittaa ajastettuja tehtäviä. Ympärivuorokautinen toiminta perustuu siihen. Tavoitteena on saada prosessi käynnistymään itsestään ja pysymään käynnissä.

Määritä ensin gateway ja yhdistä viestisovellus:

hermes gateway setup

Ohjattu määritys käy alustat läpi ja auttaa syöttämään botin tokenin ja käyttöoikeusluettelon. Telegramin yhdistämisvaiheet (botin luominen BotFatherilla, oman ID:n selvittäminen ja tokenin syöttäminen) käydään läpi asennuksen pääoppaassa; en toista niitä tässä.

Seuraavaksi tulee ansa, jonka ihmiset useimmiten unohtavat. Jos suoritat vain komennon hermes gateway, prosessi pysyy käynnissä ainoastaan niin kauan kuin SSH-istunto on auki. Sulje terminaali, niin gateway pysähtyy. Jotta se pysyy jatkuvasti käynnissä, prosessi on annettava järjestelmän hallintaan. Siihen on yksi komento:

hermes gateway install

Se asentaa gatewayn palveluksi: Linuxissa systemd-käyttäjäpalveluna ja macOS:ssä launchd:n kautta. Järjestelmä valvoo prosessia ja käynnistää sen uudelleen, jos se kaatuu.

Palvelimella tarvitaan useammin toinen vaihtoehto: järjestelmäpalvelu, joka käynnistyy koneen käynnistyessä ennen kuin yksikään käyttäjä kirjautuu sisään:

sudo hermes gateway install --system

Juuri tätä tarvitset VPS:lle: palvelin käynnistyy uudelleen, palvelu käynnistyy itsestään ja botti on taas verkossa. Hallitse sitä näillä yksinkertaisilla komennoilla:

hermes gateway start     # käynnistä
hermes gateway stop      # pysäytä
hermes gateway status    # tarkista tila

Järjestelmäpalvelua varten lisää näihin komentoihin sudo ja lippu --system. Ilman niitä komennot kohdistuvat käyttäjäpalveluun eivätkä käynnistyksen yhteydessä käynnistyvään palveluun:

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

Miksi lingeriä tarvitaan, ja mikä ilman sitä lakkaa toimimasta?#

Tämä on yleisin kompastuskivi: asensit palvelun, mutta botti vaikenee silti öisin. Syynä on se, miten Linuxin käyttäjäpalvelut toimivat.

Systemd-käyttäjäpalvelu on oletusarvoisesti sidottu istuntoosi. Yhdistät SSH:lla, käyttäjähallinta käynnistyy ja palvelu toimii. Kirjaudut ulos, ja järjestelmä katsoo käyttäjän olevan poissa käytöstä, joten se sammuttaa käyttäjän palvelut gateway mukaan lukien. Sisään ja ulos kirjauduttavalla palvelimella tämä on ongelma: botti on verkossa vain silloin, kun olet SSH-yhteydessä.

Voit korjata tilanteen linger-tilalla, jonka avulla järjestelmä pitää käyttäjähallinnan käynnissä, vaikka käyttäjä ei olisi kirjautuneena:

sudo loginctl enable-linger username

Tämän komennon jälkeen käyttäjäpalvelu toimii itsenäisesti ja käynnistyy palvelimen käynnistyessä odottamatta kirjautumistasi. Ilman lingeriä palataan aiempaan toimintaan: gateway sammuu, kun poistut SSH:sta, eikä käynnisty palvelimen käynnistyessä. Dokumentaatiossa sanotaan tämä nimenomaisesti.

Miten Hermes ajetaan palvelimella Dockerissa automaattisin uudelleenkäynnistyksin?#

Docker on toinen toimiva tapa pitää agentti palvelimella, etenkin jos olet jo tottunut kontteihin tai haluat eristää agentin pääjärjestelmästä. Määritä se kerran komennolla docker run ... setup ja käynnistä sitten kontti taustalla:

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

Näin ympärivuorokautisen toiminnan varmistavat rivit toimivat:

• -d — kontti toimii taustalla eikä pidä terminaalia auki.
• --restart unless-stopped — Docker käynnistää kontin uudelleen palvelimen uudelleenkäynnistyksen tai kaatumisen jälkeen. Se ei käynnistä sitä uudelleen vain, jos pysäytit sen itse.
• -v ~/.hermes:/opt/data — asetukset, avaimet, istunnot ja muisti sijaitsevat palvelimella kontin ulkopuolella ja säilyvät, kun kontti luodaan uudelleen.

Image tuo lisäsuojan: gateway-prosessi toimii s6-valvojan alaisena. Jos gateway kaatuu, se käynnistetään uudelleen muutamassa sekunnissa menettämättä itse konttia. Suojaus on kaksinkertainen: Docker pitää kontin käynnissä ulkopuolelta, kun taas s6 valvoo sisällä olevaa prosessia.

Muista yksi Docker-tavan ero: näitä asennuksia ei päivitetä komennolla hermes update. Päivitä Docker-asennus korvaamalla image uudella — lataa uusin image ja luo kontti uudelleen.

Miten tarkistat, että kaikki toimii ja selviää uudelleenkäynnistyksestä?#

Tarkista käyttäjäpalvelun tila ja lokit näin:

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

Käytä VPS:lle suositeltavaa järjestelmäpalvelua varten järjestelmärajausta:

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

Ensimmäinen komento tarkistaa valitun palvelun ja toinen seuraa sen rajauksen lokia. Nämä yksikkönimet koskevat oletusasennusta ~/.hermes. Muissa Hermes-kotihakemistoissa yksiköllä voi olla lisänimi. Tarkista tilatuloste ja käytä juuri siinä näkyvää yksikköä. Älä valvo käyttäjäyksikköä järjestelmäasennusta testatessasi. Hermesin lokit ovat hakemistossa ~/.hermes/logs/, ja salaisuudet peitetään niissä automaattisesti, joten lokien lähettäminen tukeen on turvallista.

Käynnistä nyt palvelin uudelleen ja varmista, että agentti palaa toimintaan itsestään. Tämä on tärkein palvelintesti, ja se unohtuu yleensä ihmisiltä:

sudo reboot

Kun palvelin on jälleen tavoitettavissa, yhdistä uudelleen SSH:lla. Tarkista järjestelmäasennuksessa sudo hermes gateway status --system ja sen järjestelmäloki. Tarkista lingeriä käyttävässä käyttäjäasennuksessa hermes gateway status ja sen käyttäjäloki. Lähetä sitten botille viesti Telegramissa. Jos se vastaa ilman sinun osallistumistasi, automaattinen käynnistys on määritetty oikein. Tätä varten kaikki tehtiin.

Keskustelun katoamisesta ei tarvitse huolehtia. Hermes kirjoittaa istunnot levylle, ja ne säilyvät gatewayn uudelleenkäynnistyksessä. Lisäksi jos gateway kaatuu juuri vastausta lähettäessään, se toimittaa vastauksen palautumisen jälkeen sen sijaan, että suorittaisi tehtävän uudelleen. Tämä on tärkeää ympärivuorokautiselle botille: odottamaton uudelleenkäynnistys ei katkaise keskustelua.

Miten suojaat palvelimella olevan, terminaaliin pääsevän agentin?#

Palvelimella toimiva agentti on terminaaliin pääsevä ohjelma, joka toimii ilman valvontaasi. Tarkista ensin nämä kolme asetusta.

Botin käyttö on rajattu. Oletuksena gateway vastaa vain käyttöoikeusluettelossa oleville tai niille, jotka ovat suorittaneet koodipohjaisen linkityksen yksityisviestissä. Tämä on oikea toimintatapa terminaaliin pääsevälle botille: satunnainen botille viestittävä henkilö ei voi tehdä mitään. Luettelo määritetään numeerisilla ID-tunnuksilla, esimerkiksi Telegramia varten:

TELEGRAM_ALLOWED_USERS=123456789,987654321

Vahvistus vaarallisille komennoille. Ennen tuhoavaa toimintoa agentti pyytää lupaasi. On olemassa YOLO-tila, joka poistaa vahvistukset käytöstä; sitä ei kannata ottaa käyttöön palvelimella, joka toimii ilman sinua. Vahvistusten tarkoitus on nimenomaan estää peruuttamattomat toimet ilman tietoasi.

Hiekkalaatikko täydellistä eristystä varten. Jos haluat tehdä fyysisesti mahdottomaksi sen, että agentti näkee palvelimen pääjärjestelmän, suorita sen komennot Docker-kontissa:

hermes config set terminal.backend docker

Tällöin kaikki agentin terminaalissa tekemä tapahtuu eristetyssä hiekkalaatikossa, eikä se pääse varsinaiselle palvelimelle. Tämä on järkevä suojaus, kun annat agentille vapauden toimia itsenäisesti.

Mitä tehdä, jos botti on hiljaa tai gateway kaatuu?#

Kun botti lakkaa vastaamasta, etene tässä järjestyksessä. Tarkista ensin asennettu rajaus: järjestelmäpalvelussa sudo hermes gateway status --system ja järjestelmäloki, käyttäjäpalvelussa hermes gateway status ja käyttäjäloki. Jos gateway on käynnissä, mutta viestit eivät pääse läpi, ongelma liittyy lähes aina alustan määritykseen: botin token on väärä tai henkilö ei ole käyttöoikeusluettelossa. Suorita hermes gateway setup uudelleen samassa Hermes-kotihakemistossa. Tarkista sitten valittu palvelu komennolla hermes gateway status --system järjestelmäpalvelua tai hermes gateway status käyttäjäpalvelua varten. Onnistunut määritys ei todista oikean gatewayn olevan käynnissä.

Jos malli palauttaa tyhjiä tai outoja vastauksia, tarkista se komennolla hermes model ja varmista palveluntarjoaja sekä kirjautuminen. Yleinen palautusjärjestys, jolla pääset ”kaikki on rikki” -tilanteesta takaisin toimivaan tilaan, on: hermes doctor, hermes model, hermes setup, ja sen jälkeen hermes gateway status --system järjestelmäasennuksessa tai hermes gateway status käyttäjäasennuksessa.

Vielä yksi asia harvinaisesta mutta ikävästä tilanteesta, jossa koko prosessi jäätyy kaatumatta. Systemd-palvelussa on watchdog-ajastin: lisää tämä rivi tiedostoon ~/.hermes/config.yaml ja asenna palvelu uudelleen.

gateway:
  systemd_watchdog_seconds: 120

# VPS:n järjestelmäpalvelu (sama Hermes-kotihakemisto kuin alkuperäisessä asennuksessa):
sudo hermes gateway install --system --force
sudo hermes gateway status --system

Jos käytät käyttäjäpalvelua, luo vain se uudelleen komennolla hermes gateway install --force ja tarkista hermes gateway status. Valitse yksi rajaus. Älä asenna molempia yhden gatewayn korjaamiseksi.

Sen jälkeen gateway ilmoittaa järjestelmälle säännöllisesti: ”Olen elossa”, ja jos ilmoitukset loppuvat, systemd käynnistää prosessin automaattisesti uudelleen. Tämä toimii vain Linuxissa, jossa on systemd, ja vain prosessin jäätyessä. Watchdog-ajastin ei vaikuta tavalliseen verkkokatkokseen palvelimen ja viestisovelluksen välillä.

Mitä muuta Hermes Agentista palvelimella kysytään?#