Så ansluter du Hermes Agent till Telegram och hanterar uppgifter från telefonen

Du kan skicka meddelanden till Hermes Agent eller diktera uppgifter till den i Telegram från telefonen när du är borta från datorn och få resultatet i samma chatt. Resultat från schemalagda uppgifter kommer en gång till den chatt som du anger som din hemchatt.

Om du inte har Hermes ännu kan du börja med guiden om vad den här agenten är och hur du installerar den och sedan komma tillbaka för att ansluta Telegram.

Ytterligare instruktioner finns i Ailoot-dokumentationen.

Vad behöver du för att ansluta Hermes Agent till Telegram?#

Kommandot hermes doctor kontrollerar din Hermes-installation och modellanslutning. Vi skapar boten i Telegram-appen, och du behöver en dator för att köra kommandon i terminalen.

Hur skapar du en bot via BotFather?#

Varje Telegram-bot har en token — en hemlig nyckel för att styra boten. Den utfärdas av Telegrams officiella bot, @BotFather.

1. Öppna @BotFather

   Sök efter @BotFather i Telegram eller öppna t.me/BotFather. Den riktiga BotFather har en blå verifieringsbock. Starta konversationen genom att trycka på ”Start”.

2. Skicka kommandot /newbot

   BotFather ber om två namn. Det första är visningsnamnet; det kan vara vad som helst, till exempel ”Min agent”. Det andra är användarnamnet: det måste vara unikt och sluta på bot, till exempel moy_agent_bot.

3. Hämta token

   BotFather skickar ett gratulationsmeddelande och en lång sträng i formatet 123456789:ABCdefGHIjklMNOpqrSTUvwxYZ. Det här är bottoken. Kopiera hela strängen.

Det finns också ett snabbt sätt som inte kräver en manuell konversation med BotFather. I Hermes webbpanel (hermes dashboard) och i datorappen finns en knapp ”Create with QR” på sidan ”Messaging → Telegram”: skanna koden med telefonen, så skapar Hermes en bot, hittar ditt ID, sparar token i inställningarna och startar om gatewayen. Stegen nedan beskriver den manuella metoden; om du valde QR kan du gå direkt till att kontrollera anslutningen.

Hur hittar du ditt Telegram-ID, och varför behöver du det?#

Ett Telegram-konto har två identifierare: ett offentligt användarnamn med ett @-tecken och ett internt numeriskt ID. Hermes använder numret.

Den snabba metoden ”Skapa med QR” som beskrivs ovan identifierar ditt ID automatiskt. Skriv ner det bredvid din token.

Hur ger du token till Hermes Agent och startar gatewayen?#

1. Kör konfigurationsguiden

   hermes gateway setup
   

   Kör kommandot på maskinen där Hermes är installerat. Guiden visar en lista med meddelandeappar.

2. Välj Telegram och ange dina uppgifter

   Guiden frågar efter bottoken och tillåtna ID:n (du kan ange flera, separerade med kommatecken) och sparar allt direkt i inställningarna.

3. Starta gatewayen

   hermes gateway
   

   Gatewayen startar och ansluter till Telegram. Skicka ett meddelande till boten från appen efter några sekunder: om Hermes svarar är anslutningen klar.

Den manuella metoden i stället för att använda guiden ser ut så här: öppna filen ~/.hermes/.env och lägg till två rader. Ersätt värdena med token från BotFather och ditt numeriska ID:

TELEGRAM_BOT_TOKEN=123456789:ABCdefGHIjklMNOpqrSTUvwxYZ
TELEGRAM_ALLOWED_USERS=123456789

Den andra raden ger dessa personer åtkomst i privata chattar och grupper; separat gruppchattbehörighet kan också ge åtkomst. Separera flera personer med kommatecken. Spara filen och starta sedan gatewayen med samma kommando, hermes gateway.

Om boten förblir tyst även i en privat chatt ska du kontrollera gatewayloggarna i samma terminal och först verifiera token och ditt ID i åtkomstlistan. Andra fel beskrivs i tabellen i slutet av artikeln.

Vad kan Telegram-boten göra på din telefon?#

Det finns fem funktioner som du oftast behöver på telefonen.

Text- och röstmeddelanden. Skriv en uppgift med ord eller diktera ett röstmeddelande — om taligenkänning är konfigurerad transkriberar Hermes det och förstår det. Med en lokal leverantör behövs inga nycklar; allt behandlas på maskinen där agenten körs.

Filer och bilder. Du kan vidarebefordra ett dokument, kalkylblad eller en skärmbild till boten — agenten tar emot det som en bilaga. Den kan också skicka tillbaka skapade filer: be om en rapport, så skickar den den som en fil i chatten.

Bekräftelser för riskfyllda åtgärder. När agenten ska göra något riskfyllt, som att radera filer, frågar den först i chatten: svara ”yes” eller ”y” så gör den det; svara ”no” eller ”n” så avbryter den.

Knappar i stället för att skriva tillbaka. När agenten behöver ett förtydligande skickar den en fråga med knappar för val direkt i chatten — tryck på ett alternativ, så fortsätter agenten att arbeta. Kommandot /model utan argument visar en modellvalsmeny med samma slags knappar.

Tysta aviseringar. Som standard ringer telefonen bara vid slutliga svar, tillståndsförfrågningar och kommandobekräftelser. Serviceaviseringar som ”anropar ett verktyg” och ”komprimerar kontext” kommer tyst, så telefonen ringer inte vid varje steg. Om du vill ha ljudaviseringar vid varje steg byter du läge i inställningarna.

Hur får du resultat från bakgrundsuppgifter i chatten?#

Hemchatt för schemalagda uppgifter. Hermes stöder schemalagda uppgifter: ”sammanställ en sammanfattning åt mig varje morgon klockan 7:43”. Resultaten skickas till hemchatten, som du anger en gång genom att skicka kommandot /sethome direkt i konversationen med boten. Så länge gatewayen körs kommer sammanfattningar automatiskt.

Bakgrundsuppgifter. Du kan skicka en lång uppgift som ska köras i bakgrunden och fortsätta med din dag: boten skickar ett meddelande när den är klar. En uppgift som startas från ett ämne skickar svaret tillbaka till samma ämne, så inget försvinner.

Viktig begränsning: boten svarar bara medan gatewayen körs. Om du stänger av datorn där Hermes körs eller försätter den i viloläge svarar boten inte förrän maskinen körs igen. Om du vill att boten alltid ska vara online flyttar du agenten till en server: vi har en separat guide om hur du håller Hermes Agent igång dygnet runt. Som standard hämtar gatewayen nya meddelanden från Telegram genom regelbunden avfrågning. För molnplattformar som går i viloläge när ingen trafik kommer in beskriver dokumentationen ett webhook-läge, som vänder på anslutningsriktningen så att Telegram själv skickar förfrågningar till boten.

Hur håller du obehöriga borta från boten?#

Det går att hitta din bot genom att söka på dess användarnamn i Telegram, så skyddet bygger på två saker: åtkomstlistan och att hålla token hemlig.

Konfigurera först avsändaråtkomst med TELEGRAM_ALLOWED_USERS. För grupper granskar du också TELEGRAM_GROUP_ALLOWED_CHATS: om en chatt listas där tillåts alla dess medlemmar, även om deras avsändar-ID saknas i den personliga listan. En tom personlig lista bevisar därför inte ensam att alla grupper är stängda.

Sedan har vi token. Den får inte hamna i skärmbilder, vidarebefordrade meddelanden eller kodförråd. Om token läcker ska du återkalla den med kommandot /revoke i BotFather. Ange sedan den nya token i inställningarna och starta om gatewayen.

En särskild notering om grupper: avsändarbehörighet och chattbehörighet är olika saker. En medlem i en grupp som tillåts genom TELEGRAM_GROUP_ALLOWED_CHATS kan använda boten även om personens ID saknas i TELEGRAM_ALLOWED_USERS. Om åtkomsten ska vara individuell ger du inte hela gruppen tillträde; konfigurera och verifiera avsändarbegränsningar för installerad version. Om du vill att boten bara ska svara i en grupp när den tilltalas finns inställningen telegram.require_mention — då svarar den på en @-omnämning, ett svar på dess meddelande, ett kommando som /command@yourbot och träffar på dina mönster i telegram.mention_patterns, samtidigt som vanliga gruppmeddelanden ignoreras.

Varför är boten tyst i en grupp, och hur åtgärdar du det?#

Nya Telegram-botar har integritetsläget aktiverat som standard. Hermes-dokumentationen beskriver det som den vanligaste orsaken till förvirring kring botar i grupper. I det här läget får boten bara meddelanden som börjar med ett /-kommando, svar på sina egna meddelanden och serviceaviseringar. Den får helt enkelt inte vanliga gruppmeddelanden — Telegram skickar dem inte till den, och ingen agentinställning kan åtgärda det.

Så här åtgärdar du det:

1. Öppna @BotFather och skicka /mybots.
2. Välj din bot.
3. Öppna ”Bot Settings” → ”Group Privacy” → ”Turn off”.
4. Ta bort boten från gruppen och lägg till den igen.

Det är lätt att missa det fjärde steget, och då ”förblir boten fortfarande tyst”. Telegram kommer ihåg integritetsinställningen från när boten gick med i gruppen och uppdaterar den inte förrän boten har tagits bort från gruppen och lagts till igen.

Om du inte vill stänga av integritetsläget globalt finns det ett andra alternativ: gör boten till gruppadministratör. Administratörsbotar får alla meddelanden oavsett integritetsläge.

Vanliga anslutningsfel och vad du kan göra åt dem#

Vad mer brukar folk fråga om Hermes Agent i Telegram?#

När du är redo kan du lära känna Ailoot.