Hermes Agent i Telegram: połączenie i zadania z telefonu

Gdy jesteś z dala od komputera, możesz wysyłać Hermes Agent wiadomości lub dyktować mu zadania w Telegramie na telefonie, a wyniki otrzymywać na tym samym czacie. Wyniki zaplanowanych zadań będą trafiać do wyznaczonego przez Ciebie czatu głównego; wystarczy wskazać go raz.

Jeśli nie masz jeszcze Hermesa, zacznij od przewodnika czym jest ten agent i jak go zainstalować, a potem wróć, aby połączyć go z Telegramem.

Dodatkowe instrukcje znajdziesz w dokumentacji Ailoot.

Czego potrzebujesz, aby połączyć Hermes Agent z Telegramem?#

Polecenie hermes doctor sprawdza instalację Hermesa i połączenie z modelem. Utworzymy bota w aplikacji Telegram; do uruchomienia poleceń w terminalu będzie Ci potrzebny komputer.

Jak utworzyć bota przez BotFather?#

Każdy bot Telegrama ma token — tajny klucz do sterowania botem. Wydaje go oficjalny bot Telegrama, @BotFather.

1. Otwórz @BotFather

   Wyszukaj @BotFather w Telegramie lub otwórz t.me/BotFather. Prawdziwy BotFather ma niebieski znacznik weryfikacji. Rozpocznij rozmowę, naciskając „Start”.

2. Wyślij polecenie /newbot

   BotFather poprosi o dwie nazwy. Pierwsza to nazwa wyświetlana; może być dowolna, na przykład „My Agent”. Druga to nazwa użytkownika: musi być unikalna i kończyć się na bot, na przykład moy_agent_bot.

3. Uzyskaj token

   BotFather wyśle gratulacje i długi ciąg znaków w formacie 123456789:ABCdefGHIjklMNOpqrSTUvwxYZ. To token bota. Skopiuj cały ciąg.

Jest też szybki sposób, który nie wymaga ręcznej rozmowy z BotFatherem. W panelu internetowym Hermesa (hermes dashboard) oraz w aplikacji komputerowej, na stronie „Messaging → Telegram”, znajduje się przycisk „Create with QR”: zeskanuj kod telefonem, a Hermes utworzy bota, wykryje Twoje ID, zapisze token w ustawieniach i ponownie uruchomi bramę. Poniższe kroki opisują metodę ręczną; jeśli wybierzesz QR, przejdź od razu do sprawdzenia połączenia.

Jak znaleźć swój identyfikator Telegrama i dlaczego jest potrzebny?#

Konto Telegrama ma dwa identyfikatory: publiczną nazwę użytkownika ze znakiem @ oraz wewnętrzne numeryczne ID. Hermes używa numeru.

Zapisz swoje numeryczne ID obok tokenu. Szybka metoda „Create with QR” opisana powyżej wykrywa ID automatycznie.

Jak przekazać token do Hermes Agent i uruchomić bramę?#

1. Uruchom kreator konfiguracji

   hermes gateway setup
   

   Uruchom polecenie na komputerze, na którym zainstalowano Hermesa. Kreator wyświetli listę aplikacji do przesyłania wiadomości.

2. Wybierz Telegram i podaj dane

   Kreator poprosi o token bota i dozwolone ID (możesz podać kilka, oddzielając je przecinkami), a następnie zapisze wszystko w ustawieniach.

3. Uruchom bramę

   hermes gateway
   

   Brama uruchomi się i połączy z Telegramem. Po kilku sekundach wyślij botowi dowolną wiadomość z aplikacji: jeśli Hermes odpowie, połączenie jest gotowe.

Metoda ręczna zamiast kreatora wygląda tak: otwórz plik ~/.hermes/.env i dodaj dwa wiersze, wstawiając token otrzymany od BotFathera oraz swoje numeryczne ID:

TELEGRAM_BOT_TOKEN=123456789:ABCdefGHIjklMNOpqrSTUvwxYZ
TELEGRAM_ALLOWED_USERS=123456789

Drugi wiersz uprawnia te osoby w czatach prywatnych i grupach; osobna autoryzacja czatu grupowego także może nadać dostęp. Wiele osób oddziel przecinkami. Po zapisaniu pliku uruchom bramę tym samym poleceniem hermes gateway.

Jeśli bot milczy nawet na czacie prywatnym, sprawdź logi bramy w tym samym terminalu i najpierw upewnij się, że token oraz Twoje ID na liście dostępu są poprawne; inne błędy opisano w tabeli na końcu artykułu.

Co potrafi bot Telegrama w telefonie?#

Na telefonie najczęściej przyda Ci się pięć możliwości.

Wiadomości tekstowe i głosowe. Napisz zadanie lub podyktuj wiadomość głosową — po skonfigurowaniu rozpoznawania mowy Hermes przepisze ją na tekst i zrozumie. Lokalny dostawca nie wymaga kluczy; wszystko jest przetwarzane na komputerze, na którym działa agent.

Pliki i zdjęcia. Możesz przekazać botowi dokument, arkusz kalkulacyjny lub zrzut ekranu — agent otrzyma je jako załącznik. Może też odesłać wygenerowane pliki: poproś o raport, a prześle go jako plik na czacie.

Potwierdzanie niebezpiecznych działań. Gdy agent zamierza zrobić coś ryzykownego, na przykład usunąć pliki, najpierw zapyta na czacie: odpowiedz „yes” lub „y”, aby wykonał działanie, albo „no” lub „n”, aby je anulował.

Przyciski zamiast wpisywania odpowiedzi. Gdy agent potrzebuje wyjaśnienia, zada pytanie z wbudowanymi przyciskami opcji — dotknij jednej z nich, a agent będzie kontynuować pracę. Polecenie /model bez argumentów wyświetla menu wyboru modelu z takimi samymi przyciskami.

Ciche powiadomienia. Domyślnie telefon dzwoni tylko przy odpowiedziach końcowych, prośbach o potwierdzenie i potwierdzeniach poleceń. Powiadomienia serwisowe, takie jak „calling a tool” i „compressing context”, docierają bez dźwięku, więc telefon nie dzwoni przy każdym kroku. Jeśli chcesz otrzymywać dźwiękowe powiadomienia na każdym etapie, zmień tryb w ustawieniach.

Jak otrzymywać wyniki zadań w tle na czacie?#

Czat główny dla zaplanowanych zadań. Hermes obsługuje zaplanowane zadania, na przykład: „codziennie o 7:43 przygotuj dla mnie podsumowanie”. Wyniki wysyła na czat główny, który wskazujesz raz, wysyłając polecenie /sethome bezpośrednio w rozmowie z botem. Dopóki brama działa, podsumowania będą przychodzić automatycznie.

Zadania w tle. Możesz wysłać długie zadanie do wykonania w tle i zająć się swoim dniem: bot napisze do Ciebie, gdy będzie gotowe. Zadanie rozpoczęte w temacie zwróci odpowiedź do tego samego tematu, więc nic nie zginie.

Ważne ograniczenie: bot odpowiada tylko wtedy, gdy działa brama. Jeśli wyłączysz komputer z Hermesem lub uśpisz go, bot nie będzie odpowiadać, dopóki urządzenie ponownie nie zacznie działać. Aby utrzymywać bota stale online, przenieś agenta na serwer: mamy osobny przewodnik o tym, jak utrzymywać Hermes Agent w działaniu przez całą dobę. Domyślnie brama odpytuje Telegram o nowe wiadomości; w przypadku platform chmurowych, które usypiają się bez ruchu przychodzącego, dokumentacja oferuje tryb webhook, który odwraca kierunek połączenia, tak aby to Telegram wysyłał żądania do bota.

Jak nie dopuścić obcych do bota?#

Twój bot może być widoczny w wyszukiwarce Telegrama pod swoją nazwą użytkownika, więc ochrona opiera się na dwóch rzeczach: liście dostępu i zachowaniu tokenu w tajemnicy.

Najpierw skonfiguruj dostęp nadawców przez TELEGRAM_ALLOWED_USERS. Dla grup sprawdź też TELEGRAM_GROUP_ALLOWED_CHATS: umieszczenie tam czatu dopuszcza każdego jego członka, nawet bez jego identyfikatora na liście osobistej. Sama pusta lista osobista nie dowodzi więc zamknięcia wszystkich grup.

Po drugie, jest token. Nie może znaleźć się na zrzutach ekranu, w przekazywanych wiadomościach ani w repozytoriach. Jeśli token wycieknie, unieważnij go poleceniem /revoke w BotFatherze. Następnie wpisz nowy token w ustawieniach i uruchom ponownie bramę.

Osobna uwaga dotycząca grup: autoryzacja nadawcy i autoryzacja czatu to różne rzeczy. Członek grupy dopuszczonej przez TELEGRAM_GROUP_ALLOWED_CHATS może używać bota bez identyfikatora w TELEGRAM_ALLOWED_USERS. Jeśli dostęp ma pozostać indywidualny, nie uprawniaj całej grupy; skonfiguruj i sprawdź ograniczenia nadawców dla zainstalowanej wersji. Jeśli chcesz, aby bot odpowiadał w grupie tylko po wywołaniu, użyj ustawienia telegram.require_mention — wtedy zareaguje na wzmiankę @, odpowiedź na swoją wiadomość, polecenie takie jak /command@yourbot oraz dopasowania do wzorców w telegram.mention_patterns, ignorując zwykłe wiadomości grupowe.

Dlaczego bot milczy w grupie i jak to naprawić?#

W nowych botach Telegrama tryb prywatności jest domyślnie włączony; dokumentacja Hermesa opisuje go jako najczęstsze źródło nieporozumień związanych z botami w grupach. W tym trybie bot otrzymuje tylko wiadomości zaczynające się od polecenia /, odpowiedzi na własne wiadomości i powiadomienia serwisowe. Zwykłe wiadomości grupowe po prostu do niego nie docierają — Telegram ich nie wysyła i żadne ustawienie agenta tego nie naprawi.

Jak to naprawić:

1. Otwórz @BotFather i wyślij /mybots.
2. Wybierz swojego bota.
3. Otwórz „Bot Settings” → „Group Privacy” → „Turn off”.
4. Usuń bota z grupy i dodaj go ponownie.

Łatwo przeoczyć czwarty krok — wtedy bot „nadal milczy”. Telegram zapamiętuje ustawienie prywatności z chwili dołączenia bota do grupy i nie aktualizuje go, dopóki bot nie zostanie usunięty z grupy i dodany ponownie.

Jeśli nie chcesz globalnie wyłączać trybu prywatności, istnieje druga możliwość: nadaj botowi uprawnienia administratora grupy. Boty z uprawnieniami administratora otrzymują wszystkie wiadomości niezależnie od trybu prywatności.

Częste błędy połączenia i sposoby ich rozwiązania#

O co jeszcze pytają użytkownicy o Hermes Agent w Telegramie?#

Gdy będziesz gotowy, poznaj Ailoot.