# Jak propojit Hermes Agent s Telegramem a spravovat úlohy z telefonu > Nastavení krok za krokem: vytvořte bota přes BotFather, přidejte token a seznam povolených uživatelů do Hermes Agent a spusťte gateway. Hlasové zprávy, plánované úlohy a ovládání z telefonu. Source: https://ailoot.ai/blog/cs/hermes-agent-telegram-setup/ Canonical: https://ailoot.ai/blog/cs/hermes-agent-telegram-setup/ Language: cs Publisher: Ailoot (https://ailoot.ai/) Translation: guide-118 Revision: sha256-bf7f1dd534ad8583902f4e0f2b045e045645e6d0a7c0c3f24e839e8fd124db45 Když nejste u počítače, můžete Hermes Agentovi psát nebo mu v Telegramu z telefonu diktovat úlohy a výsledek dostanete ve stejném chatu. Výsledky naplánovaných úloh dorazí do chatu, který jednou určíte jako svůj hlavní chat. Pokud Hermes ještě nemáte, začněte návodem [co je tento agent a jak ho nainstalovat](https://ailoot.ai/blog/cs/hermes-agent-install-setup/) a pak se vraťte k propojení Telegramu. Další pokyny najdete v [dokumentaci Ailoot](https://ailoot.ai/docs/). ## Co potřebujete k propojení Hermes Agent s Telegramem?
Klíčové body Potřebujete nainstalovaný Hermes Agent s připojeným modelem a účet v Telegramu. Vytvoření bota v Telegramu je zdarma a Hermes je open-source projekt. Samostatné náklady mohou vzniknout za model, cloudové rozpoznávání řeči a server, pokud se rozhodnete nechat bota běžet nepřetržitě.
Příkaz `hermes doctor` zkontroluje instalaci Hermes a připojení modelu. Bota vytvoříme v aplikaci Telegram a k zadávání příkazů v terminálu budete potřebovat počítač. ## Jak vytvořit Telegram bota pro Hermes Agent přes BotFather?
Klíčové body Otevřete v Telegramu @BotFather, pošlete /newbot, vyberte zobrazované jméno a jedinečné uživatelské jméno končící na `bot`. BotFather odpoví tokenem ve tvaru 123456789:ABCdef... — to je klíč k vašemu botovi. Uložte si ho a nikomu ho neukazujte.
Každý bot v Telegramu má token — tajný klíč k ovládání bota. Vydává ho oficiální telegramový bot @BotFather. 1. ### Otevřete @BotFather Vyhledejte v Telegramu `@BotFather` nebo otevřete [t.me/BotFather](https://t.me/BotFather). Skutečný BotFather má modrou ověřovací značku. Konverzaci zahájíte klepnutím na „Start“. 2. ### Pošlete příkaz /newbot BotFather si vyžádá dvě jména. Prvním je zobrazované jméno; může být libovolné, například „Můj agent“. Druhým je uživatelské jméno: musí být jedinečné a končit na `bot`, například `moy_agent_bot`. 3. ### Získejte token BotFather vám pošle blahopřejnou zprávu a dlouhý řetězec ve tvaru `123456789:ABCdefGHIjklMNOpqrSTUvwxYZ`. To je token bota. Zkopírujte celý řetězec.
Pozor Token poskytuje úplnou kontrolu nad botem: kdokoli, kdo ho zná, bota ovládá. Pokud token unikne, okamžitě ho zneplatněte příkazem `/revoke` v konverzaci s BotFatherem a získejte nový.
Existuje také rychlý způsob, který nevyžaduje ruční konverzaci s BotFatherem. Ve webovém ovládacím panelu Hermes (`hermes dashboard`) i v desktopové aplikaci na stránce „Messaging → Telegram“ najdete tlačítko „Create with QR“: naskenujte kód telefonem a Hermes vytvoří bota, zjistí vaše ID, uloží token do nastavení a restartuje gateway. Níže jsou popsány ruční kroky; pokud jste zvolili QR, přejděte rovnou ke kontrole připojení. ## Jak zjistit své ID v Telegramu a proč ho potřebujete?
Klíčové body Find your numeric ID in the form 123456789. Jde o číslo vašeho účtu; uživatelské jméno se zavináčem v seznamu povolených uživatelů fungovat nebude. Hermes používá ID pro seznam povolených uživatelů: bez tohoto seznamu gateway neodpoví nikomu, ani vám.
Účet v Telegramu má dva identifikátory: veřejné uživatelské jméno se zavináčem a interní číselné ID. Hermes používá číslo. The quick “Create with QR” method described above detects your ID automatically. Write it down next to your token. ## Jak předat token Hermes Agent a spustit gateway?
Klíčové body Spusťte průvodce nastavením příkazem `hermes gateway setup` a vyberte Telegram: vyžádá si váš token a ID a pak vše uloží. Ruční metoda používá dva řádky v souboru `~/.hermes/.env`. Poté spusťte gateway příkazem `hermes gateway` a bot bude během několika sekund připravený.
| | Průvodce nastavením | Ručně | |----|----|----| | Co spustíte | `hermes gateway setup` | Editor se souborem `~/.hermes/.env` | | Co zadáte | Token a ID na výzvu průvodce | Dvě proměnné ručně | | Kam se údaje uloží | Průvodce je uloží přímo do nastavení | Údaje se zadají přímo do `.env` | | Pro koho je metoda určena | Pro všechny; doporučený postup | Pro ty, kdo jsou zvyklí upravovat konfiguraci nebo nastavovat vše skriptem | 1. ### Spusťte průvodce nastavením ```bash hermes gateway setup ``` Spusťte příkaz na počítači, kde je Hermes nainstalovaný. Průvodce nabídne seznam aplikací pro zasílání zpráv. 2. ### Vyberte Telegram a zadejte své údaje Průvodce si vyžádá token bota a povolená ID (můžete zadat několik ID oddělených čárkami) a vše uloží přímo do nastavení. 3. ### Spusťte gateway ```bash hermes gateway ``` Gateway se spustí a připojí k Telegramu. Po několika sekundách pošlete botovi v aplikaci libovolnou zprávu: pokud Hermes odpoví, připojení je připravené. Ruční postup místo použití průvodce vypadá takto: otevřete soubor `~/.hermes/.env` a přidejte dva řádky. Nahraďte hodnoty tokenem od BotFather a svým číselným ID: ```bash TELEGRAM_BOT_TOKEN=123456789:ABCdefGHIjklMNOpqrSTUvwxYZ TELEGRAM_ALLOWED_USERS=123456789 ``` Druhý řádek povoluje tyto osoby v soukromých i skupinových chatech; přístup ale může udělit i samostatné povolení skupinového chatu. Více lidí oddělte čárkami. Po uložení souboru spusťte gateway stejným příkazem `hermes gateway`. Pokud bot mlčí i v soukromém chatu, zkontrolujte protokoly gateway ve stejném terminálu a nejprve ověřte token a své ID v seznamu povolených uživatelů; další chyby jsou popsány v tabulce na konci článku. ## Co umí telegramový bot ve vašem telefonu?
Klíčové body Telegramový bot čte textové i hlasové zprávy, přijímá soubory a obrázky, žádá o povolení před nebezpečnými příkazy přímo v chatu a zobrazuje volby modelů jako tlačítka. Ve výchozím nastavení mají zvuk pouze oznámení o konečných odpovědích, žádostech o potvrzení a potvrzených příkazech.
Na telefonu nejčastěji využijete pět funkcí. **Textové a hlasové zprávy.** Zadejte úlohu slovy nebo nadiktujte hlasovou zprávu — pokud je nastavené rozpoznávání řeči, Hermes ji přepíše a porozumí jí. U místního poskytovatele nejsou potřeba žádné klíče; vše se zpracovává na počítači, kde agent běží. **Soubory a obrázky.** Botovi můžete přeposlat dokument, tabulku nebo snímek obrazovky — agent je obdrží jako přílohu. Může také posílat vytvořené soubory zpět: požádejte o zprávu a pošle vám ji jako soubor v chatu. **Potvrzení nebezpečných akcí.** Když se agent chystá provést něco riskantního, například smazat soubory, nejprve se zeptá v chatu: odpovězte „yes“ nebo „y“ a provede to; odpovězte „no“ nebo „n“ a akci zruší. **Tlačítka místo psaní odpovědi.** Když agent potřebuje upřesnění, pošle otázku s tlačítky možností přímo ve zprávě — klepněte na možnost a agent pokračuje v práci. Příkaz `/model` bez argumentů zobrazí nabídku výběru modelu se stejnými tlačítky. **Tichá oznámení.** Ve výchozím nastavení telefon zazvoní jen při konečných odpovědích, žádostech o potvrzení a potvrzených příkazech. Služební oznámení, například „volání nástroje“ a „komprimace kontextu“, přicházejí potichu, takže telefon nezvoní při každém kroku. Pokud chcete zvuková oznámení při každém kroku, změňte režim v nastavení. ## Jak dostávat výsledky úloh na pozadí v chatu?
Klíčové body Naplánované úlohy posílají výsledky do hlavního chatu: otevřete konverzaci s botem a pošlete příkaz `/sethome`. Úlohy na pozadí spuštěné z tématu vrátí výsledek do stejného tématu. Hlavním požadavkem je, aby gateway zůstala spuštěná; jinak bot při vypnutém počítači mlčí.
**Hlavní chat pro naplánované úlohy.** Hermes podporuje naplánované úlohy: „každé ráno v 7:43 mi připrav přehled“. Výsledky posílá do hlavního chatu, který jednou určíte odesláním příkazu `/sethome` přímo v konverzaci s botem. Dokud gateway běží, přehledy přicházejí automaticky. **Úlohy na pozadí.** Můžete zadat dlouhou úlohu, která poběží na pozadí, a věnovat se svému dni: bot vám napíše, až bude hotová. Úloha spuštěná z tématu vrátí odpověď do stejného tématu, takže se nic neztratí. Důležité omezení: bot odpovídá pouze tehdy, když běží gateway. Pokud vypnete počítač, na kterém Hermes běží, nebo ho uspíte, bot nebude odpovídat, dokud počítač znovu nespustíte. Chcete-li, aby byl bot stále online, přesuňte agenta na server: máme samostatný návod [jak nechat Hermes Agent běžet nepřetržitě](https://ailoot.ai/blog/cs/hermes-agent-vps-24-7/). Gateway ve výchozím nastavení zjišťuje nové zprávy dotazováním Telegramu; pro cloudové platformy, které bez příchozího provozu přecházejí do režimu spánku, dokumentace nabízí režim webhooku. Ten obrací směr připojení, takže Telegram posílá požadavky botovi. ## Jak zabránit cizím lidem v přístupu k botovi?
Klíčové body `TELEGRAM_ALLOWED_USERS` povoluje uvedená ID odesílatelů v soukromých i skupinových chatech. Skupinový přístup lze udělit zvlášť: `TELEGRAM_GROUP_ALLOWED_CHATS` povoluje každého člena uvedené skupiny. Token udržujte v tajnosti; filtry zmínek řídí okamžik odpovědi, nikoli oprávnění přístupu.
Vašeho bota lze v Telegramu najít podle uživatelského jména, proto ochrana závisí na dvou věcech: seznamu povolených uživatelů a utajení tokenu. Nejprve nastavte přístup odesílatelů přes `TELEGRAM_ALLOWED_USERS`. U skupin prohlédněte i `TELEGRAM_GROUP_ALLOWED_CHATS`: uvedení chatu povoluje každého člena, i když jeho ID chybí v osobním seznamu. Samotný prázdný osobní seznam proto nedokazuje uzavření všech skupin. Druhou věcí je token. Nesmí se objevit na snímcích obrazovky, v přeposlaných zprávách ani v repozitářích. Pokud token unikne, zneplatněte ho příkazem `/revoke` v BotFatheru. Poté zadejte nový token do nastavení a restartujte gateway. Zvláštní poznámka ke skupinám: oprávnění odesílatele a chatu jsou odlišná. Člen skupiny povolené přes `TELEGRAM_GROUP_ALLOWED_CHATS` může bota používat i bez svého ID v `TELEGRAM_ALLOWED_USERS`. Má-li přístup zůstat individuální, nepovolujte celou skupinu; nastavte a ověřte omezení odesílatelů pro nainstalovanou verzi. Pokud chcete, aby bot ve skupině odpovídal pouze při oslovení, použijte nastavení `telegram.require_mention`. Pak odpovídá na zmínku @, odpověď na jeho zprávu, příkaz jako `/command@yourbot` a shody s vašimi vzory v `telegram.mention_patterns`, zatímco běžné skupinové zprávy ignoruje. ## Proč bot ve skupině mlčí a jak to napravit?
Klíčové body Příčinou je režim soukromí Telegramu: ve výchozím nastavení bot ve skupině vidí pouze příkazy a odpovědi na vlastní zprávy. Vypněte ho přes @BotFather: /mybots → Bot Settings → Group Privacy → Turn off. Potom musíte bota odebrat ze skupiny a znovu ho přidat — Telegram si pamatuje staré nastavení. Případně z bota udělejte správce skupiny, aniž byste režim soukromí vypínali.
Noví telegramoví boti mají ve výchozím nastavení zapnutý režim soukromí; dokumentace Hermes ho označuje za nejčastější zdroj nejasností při používání botů ve skupinách. V tomto režimu bot dostává pouze zprávy začínající příkazem `/`, odpovědi na vlastní zprávy a služební oznámení. Běžné skupinové zprávy jednoduše nedostává — Telegram mu je neposílá a žádné nastavení agenta to nenapraví. Jak to napravit: 1. Otevřete @BotFather a pošlete `/mybots`. 2. Vyberte svého bota. 3. Otevřete „Bot Settings“ → „Group Privacy“ → „Turn off“. 4. Odeberte bota ze skupiny a znovu ho přidejte. Na čtvrtý krok se snadno zapomene, a pak bot „stále mlčí“. Telegram si pamatuje nastavení soukromí platné v době, kdy se bot připojil ke skupině, a nezmění ho, dokud bota neodeberete ze skupiny a znovu nepřidáte. Pokud nechcete soukromí vypnout globálně, existuje druhá možnost: udělejte z bota správce skupiny. Boti se správcovskými právy dostávají všechny zprávy bez ohledu na režim soukromí. ## Časté chyby při připojení a co s nimi dělat
Klíčové body Nejprve zkontrolujte, zda běží gateway a zda jsou token a ID v seznamu povolených uživatelů správné. U skupin zkontrolujte režim soukromí; u rozpoznávání hlasu poskytovatele STT a u hlasových odpovědí přes Edge TTS přítomnost ffmpeg.
| Příznak | Příčina | Co dělat | |----|----|----| | Bot vůbec neodpovídá | Nesprávný token nebo neběží gateway | Zkontrolujte token v `.env`, restartujte `hermes gateway` a prohlédněte protokoly ve stejném terminálu | | Bot odpovídá „unauthorized“ | Vaše ID není v seznamu povolených uživatelů | Ověřte své ID, přidejte ho do `TELEGRAM_ALLOWED_USERS` a restartujte gateway | | V soukromém chatu odpovídá, ve skupině mlčí | Režim soukromí | Přes BotFather vyberte „Turn off“, potom bota odeberte ze skupiny a znovu přidejte, nebo z něj udělejte správce | | Hlasové zprávy se nepřepisují | Není nastavené rozpoznávání řeči | Místní rozpoznávání se instaluje pomocí balíčku faster-whisper; cloudové možnosti vyžadují vlastní klíč | | Hlasová odpověď přes Edge TTS dorazí jako soubor místo běžné hlasové zprávy | Chybí ffmpeg | Nainstalujte ffmpeg — Edge TTS ho potřebuje ke konverzi do formátu hlasové zprávy Telegramu | | Token přestal fungovat | Token byl zneplatněn | Získejte nový přes `/revoke` a `/newbot` (nebo `/token`) u BotFatheru, nahraďte hodnotu v `.env` a restartujte gateway | ## Na co dalšího se lidé ptají o Hermes Agent v Telegramu?
Klíčové body Server není nutný, ale bot je aktivní pouze tehdy, když běží gateway. Připojení je zdarma; platíte jen za model. Přes seznam ID se může připojit více lidí. Bot nevidí soukromé chaty. Soubory větší než 20 MB vyžadují další nastavení.
### Často kladené otázky Potřebujete k fungování bota server? Ne, pro začátek stačí počítač s nainstalovaným Hermes. Jen nezapomeňte: bot je aktivní, když běží gateway. Vypněte počítač nebo ho uspěte a bot zmlkne, dokud počítač znovu nespustíte. Až budete chtít, aby běžel nepřetržitě, přesuňte agenta na server — máme o tom samostatný návod. Kolik stojí připojení bota? Připojení je zdarma. Telegram si za boty neúčtuje poplatky a Hermes Agent je open-source projekt. Samostatné náklady mohou vzniknout za model připojený k agentovi a za server, pokud chcete, aby běžel nepřetržitě. Mohu k botovi připojit manželku nebo tým? Ano. V seznamu `TELEGRAM_ALLOWED_USERS` se ID oddělují čárkami a každý ze seznamu může botovi posílat soukromé zprávy. A pokud povolíte samotný chat prostřednictvím `TELEGRAM_GROUP_ALLOWED_CHATS`, může bota používat kterýkoli člen skupiny — tak podle dokumentace funguje seznam povolených chatů. Může bot vidět mé soukromé konverzace? Ne. Bot API poskytuje botovi pouze zprávy, které jsou mu určeny v soukromých chatech, zatímco ve skupinách platí režim soukromí Telegramu, jak je popsáno v části o skupinách. Bot nemá přístup k vašim konverzacím s jinými lidmi. Proč bot odmítl přijmout velkou hlasovou zprávu? Veřejné Bot API má limit 20 MB pro stahování souborů; větší soubory odmítá. Dokumentace Hermes popisuje řešení pomocí místního serveru Bot API, které limit zvyšuje na 2 GB. Potřebujete ho pouze tehdy, pokud plánujete přijímat soubory větší než 20 MB; odkaz na dokumentaci najdete v části „Zdroje“ na konci článku. Mohu botovi přidat nové schopnosti? Ano. Hermes má dovednosti a pluginy — hotové schopnosti pro agenta. Samostatně se dozvíte, jak nainstalovat plugin do takového bota s AI agentem: jak nainstalovat plugin do bota s AI agentem v Telegramu.
### Zdroje - [Hermes Agent: nastavení Telegramu](https://hermes-agent.nousresearch.com/docs/user-guide/messaging/telegram) — hlavní zdroj původního návodu, jehož autor jej ověřil 12.09.2026 - [Hermes Agent: messaging gateway](https://hermes-agent.nousresearch.com/docs/user-guide/messaging) - [Hermes Agent: instalace](https://hermes-agent.nousresearch.com/docs/getting-started/installation) - [Hermes Agent: rychlý start](https://hermes-agent.nousresearch.com/docs/getting-started/quickstart) - [Hermes Agent: naplánované úlohy](https://hermes-agent.nousresearch.com/docs/user-guide/features/cron) - [BotFather](https://t.me/BotFather) — oficiální bot Telegramu pro vytváření botů
Až budete připraveni, seznamte se s [Ailoot](https://ailoot.ai/). ## Časté otázky ### Zablokuje osobní seznam nepovolené osoby uvnitř povolené skupiny? Ne, pokud je celý chat povolen přes TELEGRAM_GROUP_ALLOWED_CHATS: oprávněný je každý člen skupiny. TELEGRAM_ALLOWED_USERS povoluje jednotlivé odesílatele; před zpřístupněním bota skupině prohlédněte obě nastavení. ### Omezí požadavek zmínky @ přístup ve skupině na vybrané uživatele? Ne. Nastavení zmínek a vzorů určuje zprávy spouštějící odpověď. Neruší oprávnění udělené všem členům povoleného chatu. ## Ailoot · Společnost a její portfolio projektů Ailoot staví na dlouhodobých provozních zkušenostech, široké klientské základně, stabilních službách a průběžném sledování KPI. Společnost a její portfolio projektů: miliony zákazníků; měsíční tržby v miliardách. Ailoot využívá tyto provozní zkušenosti k poskytování přístupu přes API k funkcím AI v produktech zákazníků, agentech, aplikacích a automatizacích.