Hermes Agent i Telegram: jak połączyć agenta z botem

Krótka odpowiedź. Utwórz bota w @BotFather na Telegramie (/newbot) i skopiuj jego token. Podaj Hermes Agent token oraz swoje numeryczne ID użytkownika Telegrama: rozmawiać z nim mogą tylko ID z listy dozwolonych albo osoby, które zatwierdzisz kodem parowania; bez listy obca osoba dostaje tylko kod parowania, który musiałbyś zatwierdzić. Na własnej maszynie to TELEGRAM_BOT_TOKEN i TELEGRAM_ALLOWED_USERS w ~/.hermes/.env albo hermes gateway setup. Na PlayNHost wklejasz token i swoje ID na stronie Agent i restartujesz.

Sprawdzone 7 listopada 2026, aktualne dla Hermes Agent v0.23.0.

Ten poradnik korzysta z dokumentacji Hermes Agent o Telegramie i bezpieczeństwie oraz z panelu PlayNHost w obecnym kształcie. Obsługa Telegrama jest wbudowana w bramkę wiadomości Hermes Agent: nie trzeba niczego doinstalowywać.

Krok 1: utwórz bota i skopiuj jego token

1. Na Telegramie otwórz czat z @BotFather (albo t.me/BotFather). Sprawdź, czy nazwa to dokładnie @BotFather.
2. Wyślij /newbot, wybierz wyświetlaną nazwę, potem nazwę użytkownika kończącą się na bot.
3. BotFather odpowie tokenem, który wygląda jak 123456789:ABCdefGHIjklMNOpqrSTUvwxYZ. Zachowaj go w tajemnicy: każdy, kto go ma, może sterować twoim botem. Jeśli wycieknie, unieważnij go przez /revoke w BotFather.

Jeden program na bota. FAQ Hermes Agent mówi, że każda platforma czatu potrzebuje wyłącznego użycia tokena bota. Jeśli starsza kopia Hermes Agent albo jakikolwiek inny program nadal używa tego samego tokena, najpierw ją zatrzymaj albo utwórz nowego bota.

Krok 2: znajdź swoje ID użytkownika Telegrama

Lista dozwolonych Hermes Agent przyjmuje twoje numeryczne ID użytkownika, liczbę taką jak 123456789, a nie twoją nazwę @użytkownika. Sposoby, żeby je zdobyć:

• Na PlayNHost, z konsoli. Napisz do swojego bota, zanim ustawisz jakiekolwiek ID: konsola wypisze twoje ID. Szczegóły w kroku 3 poniżej.
• Z logu Hermes Agent. Gdy ktoś spoza listy wyśle wiadomość prywatną, w logu (~/.hermes/logs/gateway.log) pojawia się ostrzeżenie zaczynające się od „Unauthorized user” z numerycznym ID nadawcy (w nawiasie po jego nazwie, gdy obcy mają być ignorowani, jak na PlayNHost).
• Bot zewnętrzny. Dokumentacja Hermes Agent podpowiada @userinfobot lub @get_id_bot, które odpowiadają twoim ID.

Krok 3 na PlayNHost: wklej token i swoje ID

Na tej samej stronie potrzebujesz klucza dostawcy AI. Bez niego Uruchom zatrzymuje się z komunikatem „Your agent is not set up yet: it needs an API key from one AI provider and a Telegram or Discord bot token.” (komunikat panelu: agent nie jest jeszcze skonfigurowany, potrzebuje klucza API jednego dostawcy AI oraz tokena bota Telegram lub Discord).

1. Otwórz serwer na panel.playnhost.com, potem kartę Agent.
2. W sekcji Dostawca AI ustaw jeden klucz, jeśli jeszcze go nie masz (zobacz jaki klucz dostawcy AI wybrać).
3. W sekcji Aplikacje czatu naciśnij Ustaw przy Token bota Telegram, wklej token z BotFather i naciśnij Zapisz. Panel sprawdza jego format; błędne wklejenie daje komunikat „That is not a valid telegram bot token.” (to nie jest prawidłowy token bota Telegram). Po zapisaniu wiersz pokazuje tylko ostatnie cztery znaki, a token nigdy więcej nie jest pokazywany.
4. Nie znasz jeszcze swojego ID? Zostaw ID użytkowników Telegram puste i naciśnij Uruchom. Pierwszy start instaluje Hermes Agent, co w naszych testach trwało około 2,5 do 4 minut. Gdy agent działa, konsola wypisuje:

   [PlayNHost] Your agent is running
   [PlayNHost] Telegram: nobody can message your agent yet. Send your bot any message: your Telegram user ID appears here in the console. Put it on the Agent page, then restart.

   Wyślij swojemu botowi wiadomość na Telegramie. Nie odpowie, nawet kodem parowania: na PlayNHost Hermes Agent ignoruje każdego, kogo nie ma na liście. W ciągu około 20 sekund (konsola sprawdza log Hermes Agent co 20 sekund) pokaże twoje ID:

   [PlayNHost] Telegram user 123456789 messaged your agent and was ignored. If that is you, add 123456789 to the Telegram user IDs on the Agent page, then restart.

5. W sekcji Kto może do niego pisać wpisz liczbę w pole ID użytkowników Telegram i naciśnij Zapisz. Kilka ID wpisujesz w jednym wierszu, oddzielone przecinkami lub spacjami.
6. Strona pokazuje „Zmiany zadziałają przy następnym uruchomieniu twojego agenta.” Naciśnij Zrestartuj teraz. Konsola potwierdzi:

   [PlayNHost] Telegram: only user 123456789 can message your agent.

7. Napisz do swojego bota. Twój agent odpowie. Wiadomości z każdego innego konta Telegrama są ignorowane, a każdy nowy nadawca, który napisze do bota prywatnie, pojawia się w konsoli raz na start, więc w ten sam sposób dodasz znajomego.

Co PlayNHost ustawia za ciebie

• ID ze strony Agent trafiają do Hermes Agent jako TELEGRAM_ALLOWED_USERS. Każdy inny sposób wpuszczenia ludzi (przełączniki „zezwól wszystkim”, inne listy dozwolonych, uprawnienia grup, zatwierdzenia parowania) jest wyłączany przy każdym starcie, a agent jest zatrzymywany, jeśli któryś pojawi się w trakcie pracy.
• Obcy są ignorowani (unauthorized_dm_behavior: ignore) zamiast dostawać domyślny kod parowania Hermes Agent, ponieważ serwer PlayNHost nie ma wiersza poleceń, którym można by taki kod zatwierdzić.
• Token trafia do Hermes Agent jako TELEGRAM_BOT_TOKEN. Jego kopia zapisana w .hermes/.env jest usuwana przy następnym starcie, więc używany jest token ze strony Agent.
• Włączone są tylko Telegram i Discord. WhatsApp jest odrzucany: dokumentacja Hermes Agent mówi, że jego most do WhatsApp emuluje sesję WhatsApp Web i niesie ryzyko bana.

Krok 3 na własnej maszynie

1. Uruchom kreator konfiguracji i wybierz Telegram. Poprosi o token i dozwolone ID użytkowników i zapisze je za ciebie:

   hermes gateway setup

2. Albo dodaj je ręcznie do ~/.hermes/.env:

   TELEGRAM_BOT_TOKEN=123456789:ABCdefGHIjklMNOpqrSTUvwxYZ
   TELEGRAM_ALLOWED_USERS=123456789

   Kilka ID oddziela się przecinkami.
3. Uruchom bramkę przez hermes gateway i wyślij botowi wiadomość. Żeby działała po wylogowaniu, zobacz jak uruchomić Hermes Agent 24/7.

Bez żadnej listy dozwolonych Hermes Agent odrzuca wszystkich. Jego domyślna odpowiedź dla obcych to kod parowania, który zatwierdzasz przez hermes pairing approve telegram <code>; kody wygasają po godzinie. Dokumentacja Hermes Agent oferuje też GATEWAY_ALLOW_ALL_USERS=true, ale odradza to dla bota, który może wykonywać polecenia.

Gdy nie odpowiada

Na PlayNHost własny log Hermes Agent to .hermes/logs/gateway.log w Files. Chcesz też Discorda? Zobacz połączenie Hermes Agent z Discordem. Jeszcze nie skonfigurowane? Utwórz serwer Hermes Agent.

PlayNHost nie jest powiązany z Nous Research. Hermes Agent to oprogramowanie open source na licencji MIT.