# A Hermes Agent csatlakoztatása a Telegramhoz és a feladatok kezelése telefonról
> Lépésről lépésre: hozz létre botot a BotFatherrel, add meg a tokent és a hozzáférési listát a Hermes Agentben, majd indítsd el a gatewayt. Hangüzenetek, ütemezett feladatok és vezérlés telefonról.
Source: https://ailoot.ai/blog/hu/hermes-agent-telegram-setup/
Canonical: https://ailoot.ai/blog/hu/hermes-agent-telegram-setup/
Language: hu
Publisher: Ailoot (https://ailoot.ai/)
Translation: guide-118
Revision: sha256-29cdbdcd52c49d558582ae166f5bd15c271982e92870749677f18d01929e6ebe
A Hermes Agentnek üzeneteket küldhetsz, vagy feladatokat diktálhatsz neki a Telegramon a telefonodról, amikor nem vagy a számítógépednél, az eredményt pedig ugyanabban a csevegésben kapod meg. Az ütemezett feladatok eredményei egyszeri beállítás után az általad kijelölt fő csevegésbe érkeznek.
Ha még nincs Hermesed, először olvasd el az útmutatót arról, [mi ez az ügynök, és hogyan telepítheted](https://ailoot.ai/blog/hu/hermes-agent-install-setup/), majd térj vissza a Telegram csatlakoztatásához.
További útmutatást az [Ailoot dokumentációjában](https://ailoot.ai/docs/) találsz.
## Mire van szükséged a Hermes Agent Telegramhoz csatlakoztatásához?
Főbb pontok
Telepített Hermes Agentre, hozzá csatlakoztatott modellre és Telegram-fiókra van szükséged. A bot létrehozása a Telegramon ingyenes, a Hermes pedig nyílt forráskódú projekt. Külön költség merülhet fel a modell, a felhőalapú beszédfelismerés és a szerver miatt, ha úgy döntesz, hogy éjjel-nappal futtatod a botot.
A `hermes doctor` parancs ellenőrzi a Hermes telepítését és a modellkapcsolatot. A botot a Telegram alkalmazásban hozzuk létre; a terminálparancsok futtatásához számítógépre lesz szükséged.
## Hogyan hozhatsz létre botot a BotFatherrel?
Főbb pontok
Nyisd meg a @BotFather botot a Telegramon, küldd el a /newbot parancsot, majd válassz egy megjelenített nevet és egy egyedi, `bot` végződésű felhasználónevet. A BotFather egy 123456789:ABCdef... formátumú tokennel válaszol — ez a botod kulcsa. Mentsd el, és ne mutasd meg senkinek.
Minden Telegram-botnak van tokenje — ez egy titkos kulcs, amellyel vezérelhető a bot. Ezt a Telegram hivatalos botja, a @BotFather adja ki.
1. ### Nyisd meg a @BotFather botot
Keress rá a Telegramon a `@BotFather` névre, vagy nyisd meg a [t.me/BotFather](https://t.me/BotFather) oldalt. Az igazi BotFather neve mellett kék hitelesítési pipa látható. A „Start” gombra koppintva kezdd el a beszélgetést.
2. ### Küldd el a /newbot parancsot
A BotFather két nevet fog kérni. Az első a megjelenített név; bármi lehet, például „My Agent”. A második a felhasználónév: egyedinek kell lennie, és `bot` végződésűnek kell lennie, például `moy_agent_bot`.
3. ### Szerezd meg a tokent
A BotFather gratuláló üzenetet és egy hosszú, `123456789:ABCdefGHIjklMNOpqrSTUvwxYZ` formátumú karakterláncot küld. Ez a bot tokenje. Másold ki a teljes karakterláncot.
Figyelem
A token teljes hozzáférést biztosít a bothoz: aki ismeri a tokent, az irányítani tudja a botot. Ha kiszivárog, azonnal vond vissza a BotFatherrel folytatott beszélgetésedben a `/revoke` paranccsal, és kérj újat.
Van egy gyorsabb módszer is, amelyhez nem kell kézzel beszélgetned a BotFatherrel. A Hermes webes irányítópultján (`hermes dashboard`) és az asztali alkalmazásban, a „Messaging → Telegram” oldalon található egy „Create with QR” gomb: olvasd be a kódot a telefonoddal, és a Hermes létrehozza a botot, felismeri az azonosítódat, elmenti a tokent a beállításokba, majd újraindítja a gatewayt. Az alábbi lépések a kézi módszert mutatják be; ha a QR-kódot választottad, ugorj egyenesen a kapcsolat ellenőrzéséhez.
## Hogyan találhatod meg a Telegram-azonosítódat, és miért van rá szükség?
Főbb pontok
Keresse meg a numerikus azonosítóját, amely például 123456789 formátumú. Ez a fiókja száma; a @ jellel kezdődő felhasználónév nem használható a hozzáférési listában. A Hermes ezt az azonosítót használja a hozzáférési listához: nélküle a gateway senkinek sem válaszol, Önnek sem.
A Telegram-fióknak két azonosítója van: egy nyilvános, @ jellel kezdődő felhasználónév és egy belső, numerikus azonosító. A Hermes a számot használja.
A gyors, QR-kóddal történő „Create with QR” módszer automatikusan felismeri az azonosítódat. Írd fel a token mellé.
## Hogyan adhatod meg a tokent a Hermes Agentnek, és hogyan indíthatod el a gatewayt?
Főbb pontok
Futtasd a beállítóvarázslót a `hermes gateway setup` paranccsal, majd válaszd a Telegramot: a varázsló bekéri a tokenedet és az azonosítódat, aztán mindent elment. A kézi módszerhez két sort kell megadni a `~/.hermes/.env` fájlban. Ezután indítsd el a gatewayt a `hermes gateway` paranccsal, és a bot néhány másodperc múlva működni fog.
| | Beállítóvarázsló | Kézzel |
|----|----|----|
| Mit futtatsz | `hermes gateway setup` | Egy szerkesztőt a `~/.hermes/.env` fájllal |
| Mit adsz meg | A tokent és az azonosítót a varázsló kérdéseire válaszul | Két változót kézzel |
| Hol tárolódik | A varázsló közvetlenül a beállításokba menti | A beállításokat közvetlenül a `.env` fájlba írod |
| Kinek ajánlott | Mindenkinek; ez az ajánlott módszer | Akik jártasak a konfigurációkban vagy szkripttel állítják be |
1. ### Futtasd a beállítóvarázslót
```bash
hermes gateway setup
```
A parancsot azon a gépen futtasd, amelyre a Hermes telepítve van. A varázsló megjeleníti az üzenetküldő alkalmazások listáját.
2. ### Válaszd ki a Telegramot, és add meg az adataidat
A varázsló bekéri a bot tokenjét és az engedélyezett azonosítókat (többet is megadhatsz, vesszővel elválasztva), majd mindent közvetlenül a beállításokba ment.
3. ### Indítsd el a gatewayt
```bash
hermes gateway
```
A gateway elindul, és csatlakozik a Telegramhoz. Néhány másodperc múlva küldj bármilyen üzenetet a botodnak az alkalmazásból: ha a Hermes válaszol, a kapcsolat készen áll.
A varázsló helyett a kézi módszer így néz ki: nyisd meg a `~/.hermes/.env` fájlt, és adj hozzá két sort; a BotFathertől kapott tokent és a numerikus azonosítódat írd be:
```bash
TELEGRAM_BOT_TOKEN=123456789:ABCdefGHIjklMNOpqrSTUvwxYZ
TELEGRAM_ALLOWED_USERS=123456789
```
A második sor ezeket az embereket privát és csoportos chatben engedélyezi; a külön csoportos engedélyezés is adhat hozzáférést. Több személy esetén vesszővel válaszd el az azonosítókat. A fájl mentése után indítsd el a gatewayt ugyanazzal a `hermes gateway` paranccsal.
Ha a bot még privát csevegésben is néma marad, ellenőrizd a gateway naplóit ugyanabban a terminálban, és először győződj meg arról, hogy a token és az azonosítód helyesen szerepel a hozzáférési listában; a többi hibát a cikk végén található táblázat ismerteti.
## Mire képes a Telegram-bot a telefonodon?
Főbb pontok
A Telegram-bot szöveges és hangüzeneteket olvas, fájlokat és képeket fogad, a veszélyes parancsok előtt közvetlenül a csevegésben engedélyt kér, a modellválasztási lehetőségeket pedig gombokként jeleníti meg. Alapértelmezés szerint csak a végső válaszok, a megerősítési kérések és a parancsok megerősítései adnak hangjelzést.
A telefonodon leggyakrabban öt képességre lesz szükséged.
**Szöveges és hangüzenetek.** Írd le szavakkal a feladatot, vagy diktálj hangüzenetet — ha be van állítva a beszédfelismerés, a Hermes átírja és megérti. Helyi szolgáltató használatakor nincs szükség kulcsokra; minden azon a gépen fut, amelyen az ügynök működik.
**Fájlok és képek.** Továbbíthatsz a botnak dokumentumot, táblázatot vagy képernyőképet — az ügynök mellékletként kapja meg. Az ügynök létrehozott fájlokat is vissza tud küldeni: kérj egy jelentést, és fájlként küldi el a csevegésben.
**Megerősítés veszélyes műveletek előtt.** Ha az ügynök valami kockázatos műveletet készül végrehajtani, például fájlokat törölni, előbb rákérdez a csevegésben: válaszolj „yes” vagy „y” szöveggel a végrehajtáshoz, illetve „no” vagy „n” szöveggel a megszakításhoz.
**Gombok a begépelés helyett.** Ha az ügynöknek pontosításra van szüksége, kérdést küld beágyazott választógombokkal — koppints egy lehetőségre, és az ügynök folytatja a munkát. A `/model` parancs argumentumok nélkül ugyanilyen gombokkal megjelenített modellválasztó menüt nyit meg.
**Csendes értesítések.** Alapértelmezés szerint a telefonod csak a végső válaszok, a megerősítési kérések és a parancsok megerősítései esetén csöng. Az olyan szolgáltatási értesítések, mint a „calling a tool” és a „compressing context”, hang nélkül érkeznek, így a telefonod nem csöng minden lépésnél. Ha minden lépésnél hangjelzést szeretnél, módosítsd az üzemmódot a beállításokban.
## Hogyan kaphatod meg a háttérfeladatok eredményét a csevegésben?
Főbb pontok
Az ütemezett feladatok az eredményt a fő csevegésbe küldik: nyisd meg a beszélgetést a bottal, és küldd el a `/sethome` parancsot. Egy témából indított háttérfeladatok válasza ugyanabba a témába érkezik vissza. A legfontosabb feltétel, hogy a gateway folyamatosan fusson; különben a bot nem válaszol, amikor a számítógép ki van kapcsolva.
**Fő csevegés az ütemezett feladatokhoz.** A Hermes támogatja az ütemezett feladatokat: „minden reggel 7:43-kor állíts össze nekem egy összefoglalót.” Az eredményt a fő csevegésbe küldi, amelyet egyszer kell kijelölnöd úgy, hogy közvetlenül a bottal folytatott beszélgetésben elküldöd a `/sethome` parancsot. Amíg a gateway fut, az összefoglalók automatikusan megérkeznek.
**Háttérfeladatok.** Elküldhetsz egy hosszabb feladatot háttérben történő futtatásra, majd folytathatod a napodat: a bot üzenetet küld, amikor elkészült. Ha egy feladatot valamelyik témából indítasz, a válasz ugyanabba a témába érkezik vissza, így semmi sem vész el.
Fontos korlátozás: a bot csak akkor válaszol, amikor a gateway fut. Ha kikapcsolod vagy alvó módba helyezed a Hermest futtató számítógépet, a bot addig nem válaszol, amíg a gép újra működésbe nem lép. Ha folyamatosan online szeretnéd tartani a botot, költöztesd az ügynököt egy szerverre: külön útmutatónk szól arról, [hogyan futtathatod a Hermes Agentet éjjel-nappal](https://ailoot.ai/blog/hu/hermes-agent-vps-24-7/). Alapértelmezés szerint a gateway lekérdezi a Telegramot új üzenetekért; az olyan felhőplatformokhoz, amelyek bejövő forgalom nélkül alvó módba lépnek, a dokumentáció webhook módot kínál, amely megfordítja a kapcsolat irányát, így maga a Telegram küld kéréseket a botnak.
## Hogyan tarthatod távol az idegeneket a bottól?
Főbb pontok
A `TELEGRAM_ALLOWED_USERS` a felsorolt küldőazonosítókat privát és csoportos chatben is engedélyezi. A csoporthoz külön is adható hozzáférés: a `TELEGRAM_GROUP_ALLOWED_CHATS` a felsorolt csoportok minden tagját engedélyezi. A tokent tartsd titokban; a megemlítési szűrők a válasz idejét szabályozzák, nem a hozzáférés jogosultjait.
A botod felhasználóneve alapján rá lehet keresni a Telegramon, ezért a védelem két dolgon múlik: a hozzáférési listán és a token titokban tartásán.
Először a `TELEGRAM_ALLOWED_USERS` segítségével állítsd be a küldők hozzáférését. Csoportoknál a `TELEGRAM_GROUP_ALLOWED_CHATS` beállítást is nézd át: az ott felsorolt chat bármely tagja hozzáférhet, akkor is, ha küldőazonosítója nincs a személyes engedélylistán. Az üres személyes lista önmagában ezért nem bizonyítja minden csoport lezárását.
Másodszor ott van a token. Nem kerülhet képernyőképekre, továbbított üzenetekbe vagy kódtárakba. Ha kiszivárog, vond vissza a BotFatherben a `/revoke` paranccsal. Ezután add meg az új tokent a beállításokban, majd indítsd újra a gatewayt.
Külön megjegyzés a csoportokról: a küldő és a chat jogosultsága külön dolog. A `TELEGRAM_GROUP_ALLOWED_CHATS` által engedélyezett csoport tagja akkor is használhatja a botot, ha azonosítója nincs a `TELEGRAM_ALLOWED_USERS` listán. Ha a hozzáférésnek egyéninek kell maradnia, ne engedélyezd az egész csoportot; a telepített verzión állítsd be és igazold a küldőkorlátozásokat. Ha azt szeretnéd, hogy a bot csoportban csak megszólításra válaszoljon, létezik a `telegram.require_mention` beállítás — ekkor egy @-os megemlítésre, az üzenetére adott válaszra, egy `/command@yourbot` formátumú parancsra és a `telegram.mention_patterns` mezőben megadott mintákra reagál, a szokásos csoportüzeneteket pedig figyelmen kívül hagyja.
## Miért néma a bot egy csoportban, és hogyan javíthatod meg?
Főbb pontok
Az ok a Telegram adatvédelmi módja: alapértelmezés szerint a csoportban lévő bot csak a parancsokat és a saját üzeneteire adott válaszokat látja. Kapcsold ki a @BotFatherrel: /mybots → Bot Settings → Group Privacy → Turn off. Ezután el kell távolítanod a botot a csoportból, majd újra hozzá kell adnod — a Telegram megjegyzi a régi beállítást. Másik lehetőségként tedd a botot csoportadminisztrátorrá az adatvédelmi mód kikapcsolása nélkül.
Az új Telegram-botoknál alapértelmezés szerint be van kapcsolva az adatvédelmi mód; a Hermes dokumentációja szerint ez okozza a legtöbb félreértést a csoportokban használt botokkal kapcsolatban. Ebben a módban a bot csak a `/` jellel kezdődő parancsokat, a saját üzeneteire adott válaszokat és a szolgáltatási értesítéseket kapja meg. A szokásos csoportüzeneteket egyszerűen nem kapja meg — a Telegram nem küldi el neki őket, és ezt semmilyen ügynökbeállítás nem javítja meg.
A javítás menete:
1. Nyisd meg a @BotFather botot, és küldd el a `/mybots` parancsot.
2. Válaszd ki a botodat.
3. Nyisd meg a „Bot Settings” → „Group Privacy” → „Turn off” menüpontot.
4. Távolítsd el a botot a csoportból, majd add hozzá újra.
A negyedik lépést könnyű kihagyni, ilyenkor pedig a bot „továbbra is néma marad”. A Telegram megjegyzi a bot csoporthoz csatlakozásakor érvényes adatvédelmi beállítást, és nem frissíti, amíg a botot el nem távolítják a csoportból, majd újra hozzá nem adják.
Ha nem szeretnéd globálisan kikapcsolni az adatvédelmi módot, van egy másik lehetőség: tedd a botot a csoport adminisztrátorává. Az adminbotok bármilyen adatvédelmi mód mellett minden üzenetet megkapnak.
## Gyakori csatlakozási hibák és megoldásuk
Főbb pontok
Először ellenőrizd, hogy fut-e a gateway, illetve helyes-e a token és a hozzáférési listában szereplő azonosító. Csoportoknál ellenőrizd az adatvédelmi módot; beszédfelismerésnél a STT-szolgáltatót; az Edge TTS-sel készülő hangválaszoknál pedig azt, hogy elérhető-e az ffmpeg.
| Jelenség | Ok | Teendő |
|----|----|----|
| A bot egyáltalán nem válaszol | Hibás token vagy nem fut a gateway | Ellenőrizd a tokent a `.env` fájlban, indítsd újra a `hermes gateway` parancsot, és nézd meg a naplókat ugyanabban a terminálban |
| A bot „unauthorized” üzenettel válaszol | Az azonosítód nincs a hozzáférési listában | Ellenőrizd az azonosítódat, add hozzá a `TELEGRAM_ALLOWED_USERS` listához, majd indítsd újra a gatewayt |
| Privát csevegésben válaszol, csoportban néma | Adatvédelmi mód | Válaszd a „Turn off” lehetőséget a BotFatherrel, majd távolítsd el a botot a csoportból, és add hozzá újra, vagy tedd adminná |
| A hangüzeneteket nem írja át szöveggé | Nincs beállítva a beszédfelismerés | A helyi felismerés a faster-whisper csomaggal települ; a felhőalapú lehetőségekhez saját kulcs szükséges |
| Az Edge TTS-sel készülő hangválasz normál hangüzenet helyett fájlként érkezik | Hiányzik az ffmpeg | Telepítsd az ffmpeget — az Edge TTS-nek szüksége van rá, hogy Telegram-hangüzenet formátumba alakítsa a fájlt |
| A token már nem működik | Visszavonták a tokent | Kérj új tokent a BotFatherrel a `/revoke` és a `/newbot` (vagy `/token`) használatával, cseréld ki az értéket a `.env` fájlban, majd indítsd újra a gatewayt |
## Mit kérdeznek még az emberek a Hermes Agentről a Telegramon?
Főbb pontok
Szerverre nincs szükség, de a bot csak addig aktív, amíg a gateway fut. A csatlakoztatás ingyenes; csak a modellért fizetsz. A listában szereplő azonosítók segítségével többen is csatlakozhatnak. A bot nem látja a privát csevegéseket. A 20 MB-nál nagyobb fájlokhoz további beállítás szükséges.
### Gyakran ismételt kérdések
Szükség van szerverre a bot működéséhez?
Nem, az induláshoz elegendő az a számítógép, amelyre a Hermes telepítve van. Ne feledd: a bot addig aktív, amíg a gateway fut. Kapcsold ki a számítógépet, vagy helyezd alvó módba, és a bot néma marad, amíg a gép újra működésbe nem lép. Ha azt szeretnéd, hogy éjjel-nappal fusson, költöztesd az ügynököt egy szerverre — erről külön útmutatónk van.
Mennyibe kerül egy bot csatlakoztatása?
A csatlakoztatás ingyenes. A Telegram nem számít fel díjat a botokért, a Hermes Agent pedig nyílt forráskódú projekt. Külön költség merülhet fel az ügynökhöz csatlakoztatott modell és a szerver miatt, ha azt szeretnéd, hogy éjjel-nappal fusson.
Csatlakoztathatom a feleségemet vagy a csapatomat a bothoz?
Igen. A `TELEGRAM_ALLOWED_USERS` listában az azonosítókat vesszővel kell elválasztani, és a listán szereplők mindegyike írhat privát üzenetet a botnak. Ha magát a csevegést is engedélyezed a `TELEGRAM_GROUP_ALLOWED_CHATS` beállítással, a csoport bármely tagja használhatja a botot — a dokumentáció szerint így működik az engedélyezett csevegések listája.
Láthatja a bot a privát beszélgetéseimet?
Nem. A Bot API csak azokat az üzeneteket adja át a botnak, amelyeket privát csevegésben neki címeztek; csoportokban pedig a Telegram adatvédelmi módja érvényes, ahogy azt a csoportokról szóló rész ismerteti. A bot nem fér hozzá a másokkal folytatott beszélgetéseidhez.
Miért nem fogadta el a bot a nagy méretű hangüzenetet?
A nyilvános Bot API fájlletöltési korlátja 20 MB; az ennél nagyobb fájlokat elutasítja. A Hermes dokumentációja a helyi Bot API-szerver használatát ismerteti megoldásként; ez 2 GB-ra emeli a korlátot. Erre csak akkor van szükséged, ha 20 MB-nál nagyobb fájlokat szeretnél fogadni; a dokumentációra mutató hivatkozás a cikk végén, a „Források” részben található.
Adhatok új képességeket a botnak?
Igen. A Hermesben vannak skill-ek és pluginek — kész képességek az ügynök számára. Azt, hogyan telepíthetsz plugint egy ilyen AI-ügynökbotba, külön ismertetjük: hogyan telepíts plugint egy Telegramon működő AI-ügynökbotba.
### Források
- [Hermes Agent: Telegram beállítása](https://hermes-agent.nousresearch.com/docs/user-guide/messaging/telegram) — az eredeti útmutató fő forrása, amelyet a szerzője 12.09.2026-án ellenőrzött
- [Hermes Agent: üzenetküldési gateway](https://hermes-agent.nousresearch.com/docs/user-guide/messaging)
- [Hermes Agent: telepítés](https://hermes-agent.nousresearch.com/docs/getting-started/installation)
- [Hermes Agent: gyorsindítás](https://hermes-agent.nousresearch.com/docs/getting-started/quickstart)
- [Hermes Agent: ütemezett feladatok](https://hermes-agent.nousresearch.com/docs/user-guide/features/cron)
- [BotFather](https://t.me/BotFather) — a Telegram hivatalos botja botok létrehozásához
Ha készen állsz, ismerkedj meg az [Ailoottal](https://ailoot.ai/).
## Kérdések és válaszok: A Hermes Agent csatlakoztatása a Telegramhoz és a feladatok kezelése telefonról
### A személyes engedélylista letiltja a nem listázott embereket egy engedélyezett csoportban?
Nem, ha a teljes chat a TELEGRAM_GROUP_ALLOWED_CHATS beállítással engedélyezett: akkor bármely tagja jogosult. A TELEGRAM_ALLOWED_USERS egyéni küldőket engedélyez; csoport megnyitása előtt mindkét beállítást nézd át.
### A kötelező @-megemlítés csak a kiválasztott emberek számára teszi elérhetővé a csoportot?
Nem. A megemlítési és mintabeállítások azt szabályozzák, mely üzenetek váltanak ki választ. Nem vonják vissza az engedélyezett chat minden tagjának adott jogosultságot.
## Ailoot · A vállalat és projektportfóliója
Az Ailoot felhalmozott működési tapasztalatra, széles ügyfélkörre, stabil szolgáltatásra és folyamatos KPI-ellenőrzésre épít.
A vállalat és projektportfóliója: ügyfelek milliói; havi értékesítés milliárdos nagyságrendben.
Az Ailoot ezt a működési tapasztalatot használja az ügyfelek termékeiben, ágenseiben, alkalmazásaiban és automatizálásaiban elérhető AI-funkciók API-hozzáféréséhez.