Wiki · Začínáme
Telegram a Discord
Aby vám agent odpovídal z mobilu — a aby s ním nikdo cizí nic nespustil.
📱
Agent nemusí žít jen v terminálu.
Připojíte ho k Telegramu nebo Discordu a píšete mu z mobilu jako kamarádovi — odpovídá, spouští příkazy
a pošle vám i soubor. S botem smíte mluvit jen vy (a kdo je na seznamu) — ověření je na
číselné ID, ne na jménu.
Co si připravit
| Co | K čemu |
|---|---|
| Běžící agent na serveru | Brána (gateway) je součást agenta — když agent běží, stačí ji zapnout |
| Bot v Telegramu nebo Discordu | Vytvoříte ho zdarma, je to práce na dvě minuty (postup níže) |
| Svoje číselné ID | Není to vaše jméno ani přezdívka. Podle čísla se pozná, že jste to vy — a nikdo cizí s botem nic neudělá |
Vyberte si jednu platformu, nebo klidně obě. Většina lidí začne Telegramem — je to nejrychlejší cesta na mobil.
Telegram — krok za krokem
- Vytvořte bota v Telegramu. Napište @BotFather zprávu
/newbot, zeptá se na jméno a na přezdívku končící nabot. Na konci vám pošle token (dlouhý řetězec). Ten je jako heslo — nikomu ho nedávejte. - Zjistěte svoje číslo. Napište @userinfobot a on vám
vaše ID hned pošle (např.
123456789). Pozor, není to vaše přezdívka. - Nastavte agenta. Nejsnáz průvodcem, který se zeptá na token a na vaše ID a všechno zapíše:
$ hermes gateway setupRučně to jde taky — do souboru
~/.hermes/.envpřidejte dva řádky:# ~/.hermes/.env TELEGRAM_BOT_TOKEN=123456789:ABCdefGHIjklMNOpqrSTUvwxYZ TELEGRAM_ALLOWED_USERS=123456789 # víc lidí oddělte čárkou - Zapněte bránu a zkontrolujte ji.
$ hermes gateway start $ hermes gateway status
- Napište botovi. V Telegramu mu pošlete zprávu — do pár vteřin odpoví.
Do skupiny bota přidat můžete, ale Telegram mu ve výchozím nastavení nedovolí číst běžné zprávy
(ochrana soukromí) — uvidí jen příkazy a zmínky @vasebot. Pro skupinové použití se v @BotFather vypíná
přepínač Group Privacy.
Co umí navíc: přeposílat soubory a fotky oběma směry, zpracovat hlasovou zprávu a posílat výsledky
pravidelných úloh do zvolené konverzace (nastavení TELEGRAM_HOME_CHANNEL).
Discord — krok za krokem
- Vytvořte aplikaci a bota. Na discord.com/developers/applications zvolte New Application, pak v levém menu Bot.
- Zapněte čtení zpráv. V nastavení bota zapněte Message Content Intent (privilegované oprávnění). Bez něj bot zprávy nevidí a bude vypadat mrtvý.
- Zkopírujte token (Reset Token) — zobrazí se jen jednou, proto si ho hned uložte.
- Pozvěte bota na svůj server. V záložce Installation vygenerujte odkaz a přes něj bota přidejte (práva: čtení a psaní zpráv, posílání souborů).
- Zjistěte svoje ID. V Discordu zapněte Vývojářský režim (Uživatelská nastavení → Rozšířené), pak na sebe klikněte pravým tlačítkem a zvolte Kopírovat ID uživatele.
- Nastavte a spusťte agenta — stejně jako u Telegramu:
# průvodce (doporučeno) — vyberte Discord $ hermes gateway setup # nebo ručně do ~/.hermes/.env DISCORD_BOT_TOKEN=vase-token DISCORD_ALLOWED_USERS=284102345871466496 # víc lidí oddělte čárkou # a spuštění $ hermes gateway start
V kanálu bota oslovte @vasebot — v běžných kanálech reaguje na zmínky, aby se nemíchal do hovoru.
V přímé zprávě odpovídá na cokoli. Umí i lomítkové příkazy přímo v Discordu (např. stav nebo změnu modelu).
V nastavení lze rozdělit lidi na správce (všechny příkazy) a běžné uživatele
(povolené příkazy zvlášť) pomocí allow_admin_from a user_allowed_commands. Pro rodinu nebo tým
je to praktické — ostatní se dostanou jen k tomu, co jim dovolíte.
Kdo s botem může mluvit
| Pravidlo | Proč |
|---|---|
| Token je jako heslo | Kdo ho získá, ovládá vašeho bota. Nikdy ho nevkládejte do chatu ani do repozitáře. Když ho omylem zveřejníte, ihned ho v @BotFather / Developer Portalu zneplatněte (Reset Token) |
| Seznam povolených ID | Bot odpovídá jen ID na seznamu. Cizí člověk, který bota najde, nedostane odpověď — a hlavně nic nespustí |
| Prázdný seznam = otevřené dveře | Když seznam necháte prázdný (u Discordu přepínač pro všechny), může bota použít kdokoli. Vždy doplňte svoje ID |
| Jen jedna běžící brána na token | Dva agenti se stejným tokenem si zprávy přetahují a jeden druhému je „kradou“ |
Když to nefunguje
| Co se děje | Nejčastější příčina a co s tím |
|---|---|
| Bot mlčí úplně | Brána neběží — ověřte hermes gateway status, případně ji spusťte hermes gateway start |
| Bot běží, ale neodpovídá mně | Vaše ID není na seznamu, nebo je na seznamu jiné číslo (zkontrolujte přes @userinfobot). Častá chyba: opsané jméno místo čísla |
| Ve skupině mlčí, v soukromé zprávě funguje | Ochrana soukromí (Group Privacy) — v @BotFather ji vypněte; nebo bota oslovte zmínkou @vasebot |
| Na Discordu vypadá mrtvý | Chybí Message Content Intent, nebo není vygenerovaný odkaz s potřebnými právy |
| Odpověděl jednou a pak nic | Nejspíš běží druhá kopie agenta se stejným tokenem, nebo chybí kredit u modelu (viz výběr modelu) |
| Po restartu serveru bot zmizel | Brána musí běžet jako služba (systemd), aby se spustila sama. Postup je v oficiální dokumentaci k nasazení |
Naše tipy z provozu
| Tip | Proč |
|---|---|
| Začněte Telegramem | Dvě minuty práce a funguje na mobilu i bez otevírání počítače |
| Discord se hodí pro partu | Kanály, zmínky a oddělená práva — agent v jednom kanálu neruší ostatní |
| Nechte si posílat delší výsledky jako soubor | Agent umí přiložit soubor (např. výpis nebo tabulku), což se v chatu čte lépe než dlouhý text |
| Ověřte stav po každé změně | hermes gateway status řekne, jestli brána běží a která platforma je připojená |
| Zkuste hlasovku | V Telegramu můžete agentovi nadiktovat zadání hlasovou zprávou |