Slik holder du Hermes Agent i gang på en server døgnet rundt

Etter at du har installert Hermes Agent på en bærbar PC, dukker spørsmålet opp: Hvem svarer på Telegram og setter sammen morgenoppsummeringene når den bærbare PC-en er lukket? Ved skrivebordet fungerer agenten bare så lenge datamaskinen er på. Hvis boten skal være på nett hele tiden og planlagte oppgaver skal kjøres automatisk, må du flytte agenten til en server.

Nedenfor ser du hvordan du installerer Hermes på en vanlig Linux-server, gjør gatewayen til en tjeneste som kjører kontinuerlig og starter automatisk etter en omstart, og begrenser tilgangen slik at fremmede ikke kan komme inn i terminalen. Denne veiledningen bygger på den offisielle dokumentasjonen.

Hvis du ikke har installert Hermes ennå, kan du begynne med den separate oversikten over hva denne agenten er og hvordan du installerer den. Denne veiledningen forutsetter at den allerede kjører på din egen maskin, og handler bare om å flytte den til en server.

Informasjon om hvordan du bruker Ailoot, finner du i dokumentasjonen.

Hvorfor flytte Hermes Agent fra en bærbar PC til en server?#

På en bærbar PC fungerer Hermes bare mens lokket er åpent og du er i nærheten. Lukk det, og boten blir stille; morgenoppsummeringen kommer aldri. Det fungerer dårlig for en oppgave som «å svare folk i en meldingstjeneste og ordne ting etter en tidsplan».

Det er dette som gjør en server annerledes: Den sover aldri og er ikke avhengig av noe annet. Du installerer den samme Hermes på den, og den kjører uten deg: svarer på Telegram klokken tre om natten, samler nyheter om temaene dine hver morgen og beholder økter mellom kjøringene.

Det gir mening å flytte den når du har en løpende oppgave for agenten: en bot for deg selv eller teamet ditt, morgenoppsummeringer, automatiske svar eller regelmessig arbeid med dokumenter. Hvis du bare prøver Hermes ut for et bestemt prosjekt og sitter i nærheten, trenger du ingen server ennå; det er et ekstra steg.

Hva bør du gjøre klart før du installerer Hermes på en VPS?#

Gjør klart tre ting før installasjonen.

Serveren. En vanlig Linux-VPS er nok. Dokumentasjonen gir førsteprioritetsstøtte til Linux og WSL2, og testingen gjøres på den nyeste Ubuntu-versjonen. Hvis systemet har glibc, systemd og en kjent katalogstruktur, installeres Hermes riktig. Dette er viktig på en server fordi alle trinnene for automatisk oppstart nedenfor er avhengige av systemd, som følger med Ubuntu og Debian.

SSH-tilgang. Du kobler til serveren fra en terminal via SSH; du bruker ikke mus der. Alle kommandoene nedenfor kjøres i denne SSH-økten. Hvis du driver med vibe-coding og ennå ikke er komfortabel med terminalen, trenger du ikke bekymre deg: Det er bare noen få kommandoer, og du kan kopiere hver enkelt i sin helhet.

En valgt modell. Agenten tenker ikke på egen hånd; den kaller en modell. For en server som skal fungere uten deg, er det viktig at tilgangen til modellen ikke utløper. Det enkleste alternativet er et Nous Portal-abonnement via hermes setup --portal: Påloggingen bruker OAuth, og tokenet fornyes automatisk. Dine egne API-nøkler fungerer også, men da må du sørge for at det er penger på kontoen — en agent uten tilsyn med tom saldo blir rett og slett stille. Modellen må ha et kontekstvindu på minst 64,000 tokens, ellers nekter Hermes å starte med den. Alle skymodellene på listen oppfyller dette kravet.

Hvordan installerer du Hermes Agent på en server med én kommando?#

Installasjonen på en server er nesten den samme som på en bærbar PC, med én forskjell: Agenten trenger vanligvis ikke en nettleser der. Nettleserautomatisering tar også med seg den ressurskrevende Chromium. Derfor bruker du flagget --skip-browser.

1. Koble til serveren via SSH

   ssh root@your-server-address
   

   Kjør alle de følgende kommandoene i denne økten, på selve serveren.

2. Kjør installasjonsprogrammet uten nettleseren

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

   Skriptet laster ned det nødvendige miljøet og installerer kommandoen hermes. Flagget --skip-browser hopper over installasjonen av nettleserautomatisering; på en server uten grafisk grensesnitt ville den bare tatt opp plass. Hvis du trenger en nettleser senere, kan du installere den separat.

3. Start skallet på nytt og velg en modell

   source ~/.bashrc
   hermes setup --portal
   

   Den første linjen laster inn den nye PATH-verdien slik at kommandoen hermes blir funnet. Den andre åpner Nous Portal-påloggingen: Bekreft påloggingen, så får agenten en modell og tjenester uten separate nøkler for hver av dem.

4. Kontroller installasjonen

   hermes doctor
   

   Kommandoen viser hva som er installert, hva som mangler, og hvordan du kan rette det. Grønne markeringer betyr at alt er på plass.

Få én vanlig samtale til å fungere direkte på serveren før du legger til en bot og en tidsplan: Kjør hermes og gi den en enkel oppgave med et svar som kan verifiseres. Dokumentasjonen fraråder uttrykkelig å legge til funksjoner før en vanlig samtale fungerer — det er et godt råd.

Hvordan holder du Hermes i gang døgnet rundt?#

Gatewayen er én Hermes-prosess i bakgrunnen som opprettholder forbindelser til alle meldingstjenestene, administrerer økter og kjører planlagte oppgaver. All drift døgnet rundt dreier seg om den. Målet er å få denne prosessen til å starte automatisk og fortsette å kjøre.

Konfigurer først gatewayen og koble til en meldingstjeneste:

hermes gateway setup

Konfigurasjonsveiviseren viser deg plattformene og hjelper deg med å oppgi bot-tokenet og tilgangslisten. Trinnene for å koble til Telegram (opprette en bot med BotFather, finne ID-en din og oppgi tokenet) er omtalt i hovedveiledningen for installasjon; jeg gjentar dem ikke her.

Deretter kommer fellen folk oftest glemmer. Hvis du bare kjører hermes gateway, kjører prosessen bare så lenge SSH-økten er åpen. Lukk terminalen, og gatewayen stopper. For å holde den i gang kontinuerlig må du la systemet styre den. Det gjør du med én kommando:

hermes gateway install

Den installerer gatewayen som en tjeneste: som en systemd-brukertjeneste på Linux og via launchd på macOS. Systemet overvåker prosessen og starter den på nytt hvis den krasjer.

På en server trenger du oftere det andre alternativet: en systemtjeneste som starter når maskinen starter opp, før noen bruker logger seg inn:

sudo hermes gateway install --system

Det er akkurat dette du trenger for en VPS: Serveren starter på nytt, tjenesten starter av seg selv, og boten er på nett igjen. Administrer den med disse enkle kommandoene:

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

For en systemtjeneste legger du til sudo og flagget --system i disse kommandoene. Uten dem retter kommandoene seg mot brukertjenesten i stedet for tjenesten som starter ved oppstart:

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

Hvorfor er linger nødvendig, og hva går galt uten det?#

Dette er den vanligste snublesteinen: Du installerte tjenesten, men boten blir likevel stille om natten. Årsaken er måten Linux-brukertjenester fungerer på.

En systemd-brukertjeneste er som standard knyttet til økten din. Du kobler til via SSH, brukerbehandleren din starter, og tjenesten kjører. Du logger ut, systemet regner brukeren som inaktiv og avslutter brukerens tjenester sammen med gatewayen. På en server du logger inn og ut av, er dette et problem: Boten er bare på nett mens du er i SSH.

Du kan løse dette med linger-modus, som lar systemet holde brukerbehandleren i gang selv når brukeren ikke er logget inn:

sudo loginctl enable-linger username

Etter denne kommandoen kjører brukertjenesten på egen hånd og starter når serveren starter opp, uten å vente på at du logger inn. Uten linger går systemet tilbake til den opprinnelige oppførselen: Gatewayen stopper når du logger ut av SSH, og den starter ikke ved oppstart. Dokumentasjonen sier dette uttrykkelig.

Hvordan kjører du Hermes på en server i Docker med automatiske omstarter?#

Docker er en annen fungerende måte å ha agenten på en server på, særlig hvis du allerede er vant til containere eller vil isolere agenten fra hovedsystemet. Konfigurer den én gang med docker run ... setup, og start deretter containeren i bakgrunnen:

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

Dette gjør linjene som sørger for drift døgnet rundt:

• -d — containeren kjører i bakgrunnen og holder ikke terminalen åpen.
• --restart unless-stopped — Docker starter containeren på nytt etter en omstart av serveren eller et krasj. Den startes ikke på nytt bare hvis du har stoppet den manuelt.
• -v ~/.hermes:/opt/data — innstillinger, nøkler, økter og minne lagres på serveren, utenfor containeren, og overlever at den opprettes på nytt.

Imaget gir en ekstra sikkerhet: Gateway-prosessen kjører under s6-veilederen. Hvis gatewayen krasjer, startes den på nytt i løpet av et par sekunder uten at selve containeren går tapt. Det gir dobbel beskyttelse: Docker holder containeren i gang utenfra, mens s6 overvåker prosessen inni.

Husk én forskjell ved Docker-metoden: Disse installasjonene oppdateres ikke med kommandoen hermes update. For å oppdatere i Docker må du erstatte imaget med et nytt — last ned det nyeste og opprett containeren på nytt.

Hvordan kontrollerer du at alt fungerer og tåler en omstart?#

Slik kontrollerer du status og logger for en brukertjeneste:

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

For systemtjenesten som anbefales på VPS, bruker du systemomfanget i stedet:

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

Den første kommandoen kontrollerer valgt tjeneste; den andre følger loggen for samme omfang. Enhetsnavnene gjelder standardinstallasjonen i ~/.hermes. Andre Hermes-hjem kan ha et suffiks i enhetsnavnet. Undersøk statusutdataene og bruk det eksakte navnet. Ikke overvåk en brukerenhet mens du tester en systeminstallasjon. Hermes-loggene ligger i ~/.hermes/logs/, og hemmeligheter sladdes automatisk fra dem, så det er trygt å sende dem til kundestøtte.

Start nå serveren på nytt, og kontroller at agenten kommer tilbake av seg selv. Dette er den viktigste servertesten, og den folk som regel glemmer:

sudo reboot

Koble til via SSH når serveren er tilgjengelig igjen. Ved systeminstallasjon kontrollerer du sudo hermes gateway status --system og systemjournalen; ved brukerinstallasjon med linger kontrollerer du hermes gateway status og brukerjournalen. Send deretter boten en melding på Telegram. Hvis den svarer uten at du gjør noe, er automatisk oppstart riktig konfigurert. Det var hele poenget.

Du trenger ikke bekymre deg for å miste samtalen. Hermes skriver økter til disk, og de overlever en omstart av gatewayen. Dessuten leverer den svaret etter gjenoppretting i stedet for å kjøre oppgaven på nytt hvis gatewayen krasjer akkurat idet den sender et svar. Dette er viktig for en bot som kjører døgnet rundt: En uventet omstart ødelegger ikke samtalen.

Hvordan sikrer du en agent med terminaltilgang på en server?#

En agent på en server er et program med terminaltilgang som kjører uten tilsyn fra deg. Kontroller disse tre innstillingene først.

Stengt bottilgang. Som standard svarer gatewayen bare personer på tilgangslisten eller personer som har fullført kodebasert kobling i en direktemelding. Dette er riktig oppførsel for en bot med terminaltilgang: En tilfeldig person som sender boten en melding, kan ikke gjøre noe. Listen angis ved hjelp av numeriske ID-er, for eksempel for Telegram:

TELEGRAM_ALLOWED_USERS=123456789,987654321

Bekreftelse for farlige kommandoer. Før den gjør noe destruktivt, spør agenten om tillatelse. Det finnes en YOLO-modus som deaktiverer bekreftelser; det er best å ikke aktivere den på en server som kjører uten deg. Bekreftelser er nettopp der for å forhindre at noe irreversibelt skjer uten at du vet om det.

En sandkasse for full isolasjon. Hvis du vil at agenten fysisk sett ikke skal kunne se serverens hovedsystem, kjører du kommandoene dens i en Docker-container:

hermes config set terminal.backend docker

Da foregår alt agenten gjør i terminalen, inne i en isolert sandkasse som ikke kan nå serveren som er i drift. Det er et fornuftig sikkerhetstiltak når du lar agenten handle på egen hånd.

Hva gjør du hvis boten er stille eller gatewayen krasjer?#

Når boten slutter å svare, følger du denne rekkefølgen. Kontroller først det installerte omfanget: sudo hermes gateway status --system og systemjournalen for en systemtjeneste, eller hermes gateway status og brukerjournalen for en brukertjeneste. Hvis gatewayen kjører, men meldinger ikke kommer frem, skyldes det nesten alltid en konfigurasjon av plattformen: Bot-tokenet er feil, eller personen står ikke på tilgangslisten. Kjør hermes gateway setup på nytt i samme Hermes-hjem. Undersøk deretter valgt tjeneste med hermes gateway status --system for system eller hermes gateway status for bruker. Et vellykket oppsett beviser ikke at riktig gateway kjører.

Hvis modellen gir tomme eller merkelige svar, kontroller den med hermes model og bekreft leverandøren og påloggingen. Den generelle gjenopprettingssekvensen som tar deg fra «alt er ødelagt» tilbake til fungerende tilstand, er: hermes doctor, hermes model, hermes setup, etterfulgt av hermes gateway status --system for systeminstallasjon eller hermes gateway status for brukerinstallasjon.

En ting til om det sjeldne, men ubehagelige tilfellet der hele prosessen fryser uten faktisk å krasje. Legg denne linjen til i ~/.hermes/config.yaml og installer tjenesten på nytt.

gateway:
  systemd_watchdog_seconds: 120

# For VPS-systemtjenesten (samme Hermes-hjem som opprinnelig):
sudo hermes gateway install --system --force
sudo hermes gateway status --system

For en brukertjeneste regenererer du bare det omfanget med hermes gateway install --force og kontrollerer hermes gateway status. Velg ett omfang; ikke installer begge for å reparere én gateway.

Deretter sender gatewayen regelmessig et signal til systemet om at «jeg er i live», og hvis signalene stopper, starter systemd prosessen automatisk på nytt. Dette fungerer bare på Linux med systemd, og bare når prosessen fryser. Vakthundtimeren påvirker ikke et vanlig nettverksbrudd mellom serveren og meldingstjenesten.

Hva mer spør folk om Hermes Agent på en server?#

Bli kjent med Ailoot.