Jak połączyć OpenClaw z Telegramem

Krótka odpowiedź. Utwórz bota w Telegramie przez @BotFather (/newbot) i skopiuj jego token. Przekaż token OpenClaw, a potem pozwól pisać do bota tylko swojemu numerycznemu ID użytkownika Telegram. Na własnej maszynie to openclaw channels add --channel telegram --token <token> plus dmPolicy: "allowlist" z twoim ID w allowFrom. W PlayNHost wklejasz token i swoje ID na stronie Agent, i restartujesz.

Sprawdzone 6 listopada 2026, aktualne dla OpenClaw 2026.11.1.

Ten poradnik opiera się na dokumentacji Telegrama w OpenClaw i na panelu PlayNHost w obecnym kształcie. Telegram jest wbudowany w OpenClaw: nie trzeba instalować żadnej wtyczki.

Krok 1: utwórz bota i skopiuj jego token

1. W Telegramie otwórz czat z @BotFather. Sprawdź, czy nazwa to dokładnie @BotFather.
2. Wyślij /newbot, wybierz nazwę wyświetlaną, a potem nazwę użytkownika kończącą się na bot.
3. BotFather odpowie tokenem, który wygląda tak: 123456789:AAH.... Zachowaj go dla siebie: każdy, kto go ma, może kontrolować twojego bota.

BotFather ma też aplikację webową (t.me/BotFather?startapp), która robi to samo przyciskami.

Użyj bota, na którym nic innego nie działa. Jeśli starszy OpenClaw na twoim laptopie albo jakiś inny program nadal używa tego samego tokenu, najpierw go zatrzymaj albo utwórz nowego bota.

Krok 2: znajdź swoje ID użytkownika Telegram

Allowlista OpenClaw przyjmuje twoje numeryczne ID użytkownika, a nie @nazwę użytkownika, numer telefonu ani ID bota. Sposoby wymienione w dokumentacji OpenClaw:

• Od samego bota (bez osób trzecich). Gdy bot jest w trybie pairing, wyślij mu dowolną wiadomość. Jego odpowiedź z parowaniem zawiera "Your Telegram user id". W PlayNHost polecamy tę drogę, zobacz niżej.
• Z logu OpenClaw. Uruchom openclaw logs --follow, napisz do bota i odczytaj senderUserId we wpisie telegram pairing request.
• Z API Telegrama. Napisz do bota, potem otwórz https://api.telegram.org/bot<bot_token>/getUpdates i odczytaj message.from.id.
• Bot firmy trzeciej, taki jak @userinfobot lub @getidsbot. Dokumentacja OpenClaw uznaje to za mniej prywatne.

Krok 3 w PlayNHost: wklej token i swoje ID

Na tej samej stronie potrzebujesz klucza dostawcy AI. Bez niego Start 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."

1. Otwórz swój 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 kształt; źle wklejony token dostaje komunikat "That is not a valid telegram bot token." Po zapisaniu wiersz pokazuje tylko ostatnie cztery znaki, a token nigdy więcej nie jest pokazywany.
4. Nie znasz jeszcze swojego ID? Zostaw pole ID użytkowników Telegram puste i naciśnij Uruchom. Gdy agent wstanie, konsola wypisze:

   [PlayNHost] Your agent is running
   [PlayNHost] Telegram: nobody can message your agent yet. Send your bot any message: it answers with your Telegram user ID. Copy that ID, put it on the Agent page, then restart. Ignore the pairing code in its reply.

   Napisz do swojego bota w Telegramie. Odpowie jednorazowo kodem parowania i twoim ID użytkownika Telegram (OpenClaw wysyła kod mniej więcej raz na godzinę na osobę, a wiadomości między nimi ignoruje). Skopiuj ID i zignoruj kod: na PlayNHost nic nie trzeba zatwierdzać. Ten krok nikogo nie wpuszcza.
5. W sekcji Kto może do niego pisać wpisz swoje ID w polu ID użytkowników Telegram i naciśnij Zapisz. Kilka ID wpisujesz w jednej linii, oddzielając je przecinkami.
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. Agent odpowie. Wiadomości z każdego innego konta Telegram są ignorowane.

Co PlayNHost ustawia za ciebie

• Gdy w panelu Agent są ID, wiadomości prywatne w Telegramie używają dmPolicy: "allowlist" dokładnie z tymi ID, co zaleca dokumentacja OpenClaw dla bota z jednym właścicielem. Bez ID używają pairing: obcy dostają kod i są ignorowani, a nikt nie może ich zatwierdzić bez wiersza poleceń lub dashboardu OpenClaw, a serwer PlayNHost nie oferuje żadnego z nich.
• ID, które wpiszesz, stają się też właścicielami poleceń w OpenClaw (commands.ownerAllowFrom), więc polecenia tylko dla właściciela działają u ciebie od pierwszej wiadomości.
• Token trafia do OpenClaw jako TELEGRAM_BOT_TOKEN w jego środowisku. Token zapisany w pliku ustawień OpenClaw miałby pierwszeństwo, więc start usuwa go z pliku: używany jest token z panelu Agent.
• Grupy pozostają zamknięte: OpenClaw nie wpuszcza żadnej grupy, dopóki nie zostanie dodana do jego ustawień, a ustawienie pozwalające rozmawiać z agentem każdemu jest przy następnym starcie cofane do twoich ID.

Krok 3 na własnej maszynie

1. Dodaj token:

   openclaw channels add --channel telegram --token <bot-token>

   albo ustaw TELEGRAM_BOT_TOKEN w środowisku Gateway. Token w pliku konfiguracji ma pierwszeństwo przed zmienną środowiskową.
2. Zezwól tylko sobie w ~/.openclaw/openclaw.json:

   {
     channels: {
       telegram: {
         enabled: true,
         dmPolicy: "allowlist",
         allowFrom: ["123456789"],
       },
     },
     commands: {
       ownerAllowFrom: ["telegram:123456789"],
     },
   }

   Część commands robi z ciebie właściciela dla poleceń tylko dla właściciela: OpenClaw nie robi tego dla ręcznie napisanej allowlisty. allowlist z pustym allowFrom blokuje każdą wiadomość prywatną i jest odrzucana przez sprawdzanie konfiguracji OpenClaw.
3. Albo zostaw domyślny tryb pairing i zatwierdź siebie po pierwszej wiadomości:

   openclaw pairing list telegram
   openclaw pairing approve telegram <CODE>

   Kody wygasają po godzinie. Pierwsze zatwierdzone parowanie robi z ciebie także właściciela poleceń.
4. Sprawdź kanał poleceniem openclaw channels status --probe.

Gdy bot nie odpowiada

Chcesz też Discorda? Zobacz jak połączyć OpenClaw z Discordem. Jeszcze nie skonfigurowane? Utwórz serwer OpenClaw.

PlayNHost nie jest powiązany z OpenClaw Foundation. OpenClaw to oprogramowanie open source na licencji MIT.