Jak stworzyć bota Telegram z Claude Code lub Codex (przewodnik dla początkujących)

Nigdy nie tworzyłeś bota, ale chcesz automatyzować wiadomości na Telegramie? Claude Code, Codex lub inne asystenci kodowania AI mogą wykonać większość pracy technicznej za Ciebie, pod warunkiem że dobrze nimi pokierujesz. W kilku krokach przechodzimy od pomysłu do bota, który naprawdę działa. Oto jak to zrobić.

1. Utwórz swojego bota na Telegramie

Otwórz Telegram i porozmawiaj z @BotFather, oficjalnym botem, który tworzy boty. Wpisz /newbot, wybierz nazwę i identyfikator (który musi kończyć się na „bot”). BotFather da Ci token : długi ciąg znaków, który służy jako tajny klucz do kontrolowania Twojego bota. Trzymaj go w bezpiecznym miejscu, nigdy nie udostępniaj go publicznie — a jeśli wycieknie (na przykład przez pomyłkę opublikowany na GitHubie), wróć do BotFather, aby go unieważnić i wygenerować nowy.

2. Otwórz swojego asystenta AI w folderze projektu

Utwórz pusty folder na swoim komputerze, a następnie uruchom asystenta w terminalu w tym miejscu. Zawsze pracuje w bieżącym folderze: to tam będzie czytać i zapisywać Twoje pliki.

3. Daj mu precyzyjny prompt na start

Nie potrzebujesz technicznego słownictwa, ale im bardziej precyzyjne będzie Twoje polecenie, tym lepszy będzie wynik. Oto prompt, który możesz skopiować i wkleić bez zmian (zastępując wartości w nawiasach):

Stwórz bota Telegram w Pythonie z biblioteką python-telegram-bot.
Bot ma wysyłać codziennie rano pogodę dla [MIASTO] o [GODZINA].

Ograniczenia:
- Przechowuj token Telegram w pliku .env, nigdy na sztywno w kodzie.
- Utwórz plik .gitignore, który wyklucza .env.
- Nie wymyślaj żadnych tajnych wartości (token, klucz API): jasno mi wskaż,
  gdzie i jak mam je samodzielnie wpisać.
- Wyjaśnij mi każdy krok przed jego wykonaniem.
- Przetestuj bota, zanim uznasz projekt za zakończony.

Aby wiadomość była wysyłana codziennie bez konieczności pisania do bota, musisz też znać swój chat ID (identyfikator Twojej rozmowy z botem). Po prostu poproś AI, aby wyjaśniła Ci, jak go zdobyć — zazwyczaj wystarczy wysłać pierwszą wiadomość do bota, a następnie odczytać odpowiedź z API Telegrama.

4. Zabezpiecz token od samego początku

AI powinna utworzyć plik .env do przechowywania tokena.

5. Pozwól AI wykonywać polecenia, ale z ostrożnością

AI może sama uruchamiać polecenia instalacyjne (pip install, npm install itp.) i uruchomić bot , aby go przetestować. Poprosi Cię o zgodę przed każdą ważną czynnością. To normalne, to zabezpieczenie. Kiedy początkująca osoba nie ma punktu odniesienia, by ocenić „co jest logiczne”, wystarczy prosta zasada: jeśli polecenie prosi o Twoje hasło, modyfikuje pliki, których nie rozpoznajesz, lub instaluje oprogramowanie, o którym nigdy nie słyszałeś, najpierw poproś AI, aby wyjaśniła, co zamierza zrobić i dlaczego, zanim zaakceptujesz.

6. Przetestuj swojego bota

Gdy bot zostanie uruchomiony, otwórz Telegram i wyślij mu wiadomość. Jeśli nie odpowie zgodnie z oczekiwaniami, po prostu opisz problem AI („bot nie odpowiada na /start” lub „mam błąd XYZ”) : odczyta komunikaty o błędach i poprawi kod.

7. Dodawaj funkcje stopniowo

Gdy podstawa będzie działać, rozbudowuj ją bot stopniowo: automatyczne odpowiedzi, zaplanowane przypomnienia, integracja z zewnętrznym API… Proś o jedną funkcję naraz, testuj, a potem przechodź do następnej. Jeśli twój bot ma zapamiętywać użytkowników, ich preferencje lub przypomnienia, poproś AI o przewidzenie trwałego przechowywania danych: prosty plik lokalny może wystarczyć na prototyp, ale nie zawsze przetrwa restart na hostingu, wtedy konieczna staje się mała baza danych.

8. Hostuj bota w trybie ciągłym

Aby bot działał nawet wtedy, gdy twój komputer jest wyłączony, trzeba hostować go na serwerze. Poproś AI, aby wyjaśniła ci aktualne opcje (mały serwer w chmurze, platformy takie jak Railway lub Fly.io, funkcje serverless takie jak Cloudflare Workers) i przygotowała wdrożenie. Zawsze sprawdzaj warunki i cenniki obowiązujące w momencie, gdy to czytasz: darmowe oferty tych platform regularnie się zmieniają.

9. Naprawiaj i utrzymuj swojego bota

Bot, który działa dziś, może przestać działać jutro: zaktualizowana zależność, hosting zmieniający zasady, wygasły token… Prowadź zapis tego, co AI wdrożyła (poproś ją o udokumentowanie claude.md), aby móc łatwo przekazać jej kontekst ponownie. W razie awarii po prostu skopiuj i wklej komunikat o błędzie do AI: to często wystarczy, aby zidentyfikowała i naprawiła problem.

Odpowiadać, planować czy rozsyłać: trzy różne logiki

Bot Telegram może robić trzy zupełnie różne rzeczy: odpowiadać na otrzymaną wiadomość, wysyłać zaplanowaną wiadomość o ustalonej godzinie lub rozsyłać powiadomienie do wielu użytkowników. Ten ostatni przypadek jest bardziej wymagający: trzeba zarządzać listą osób, które rozpoczęły rozmowę z botem, ich preferencjami i przestrzegać limitów wysyłki narzuconych przez Telegram. Bot nie może sam z siebie napisać do dowolnego konta Telegram; każdy użytkownik musi najpierw rozpocząć rozmowę.

Co jest darmowe, a co płatne

Utworzenie bota za pomocą BotFather jest darmowe, a API Bot Telegram zazwyczaj nie jest rozliczane za wywołanie, ale Telegram narzuca limity przepustowości, a niektóre funkcje mogą mieć własne warunki. Po stronie asystenta AI korzystanie zależy od twojego planu: subskrypcja typu Claude Pro lub Max lub ChatGPT Pro obejmuje korzystanie z narzędzia.

Jeśli chodzi o hosting, kilka platform (Cloudflare Workers, Railway, Fly.io…) oferuje zazwyczaj darmowy poziom odpowiedni dla małego osobistego bota o niewielkim ruchu. Ale te oferty regularnie się zmieniają i zależą od rzeczywistego użycia twojego bot : zawsze sprawdzaj aktualne warunki, zanim się zobowiążesz. Podsumowując: całkiem możliwe jest uruchomienie pierwszego bota Telegram bez wydawania ani grosza.

Kilka pomysłów na boty Telegram

Śledzenie cen i zakupy

• Alert o obniżce ceny: obserwuj produkt i otrzymaj powiadomienie, gdy jego cena spadnie poniżej ustalonego progu.
• Porównywarka cen paliw: alert, gdy najbliższa stacja obniży cenę za litr poniżej określonego poziomu.
• Śledzenie dostępności: powiadomienie, gdy niedostępny artykuł znów pojawi się w sprzedaży.

Finanse i rynki

• Kursy akcji / kryptowalut: wysyła cenę Bitcoina, akcji lub ETF albo alarmuje przy dużej zmianie.
• Śledzenie portfela: codziennie oblicza łączną wartość Twoich inwestycji.
• Kursy walut: alert, gdy para walutowa osiągnie interesujący poziom.

Pogoda i środowisko

• Codzienna prognoza pogody dla Twojego miasta, wysyłana każdego ranka.
• Alert pogodowy w przypadku burzy, ulewy lub prognozowanego przymrozku.
• Jakość powietrza / pyłki.

Produktywność i życie prywatne

• Osobisty bot do zadań: dodawaj, usuwaj i przypominaj zadania bezpośrednio w Telegramie.
• Bot monitorujący RSS: obserwuje kilka stron i wysyła tylko nowe artykuły.
• Bot streszczający: wyślij artykuł lub tekst do bota i otrzymaj streszczenie.
• Bot powiadomień dla Twojej własnej strony: nowe zamówienie, nowy formularz, błąd serwera.
• Bot do śledzenia smart home: alert, gdy urządzenie lub czujnik zmieni stan.
• Bot osobistego dziennika: szybko zapisuj notatki i wyszukuj je później.
• Śledzenie przesyłek: status wszystkich Twoich dostaw w jednym bocie.

Do zapamiętania

Nie musisz umieć programować aby stworzyć działającego bota Telegram. Rolą AI jest przełożenie Twoich pomysłów na kod, wykonanie technicznych poleceń i poprawianie błędów. Twoją rolą jest jasne opisanie, co bot ma robić, zabezpieczenie dostępów, zadawanie pytań, pytanie AI, czy ma jakieś pytania, oraz testowanie efektu. To prawdziwa praca zespołowa między Twoją wizją a technicznym wykonaniem AI.