​

Telegram (Bot API)

​

Szybka konfiguracja (dla początkujących)

1. Utwórz bota za pomocą @BotFather (bezpośredni link). Potwierdź, że uchwyt to dokładnie @BotFather, a następnie skopiuj token.
2. Ustaw token:
   • Env: TELEGRAM_BOT_TOKEN=...
   • Lub konfiguracja: channels.telegram.botToken: "...".
   • Jeśli oba są ustawione, konfiguracja ma pierwszeństwo (fallback do env dotyczy tylko konta domyślnego).
3. Uruchom gateway.
4. Dostęp do DM-ów domyślnie wymaga parowania; zatwierdź kod parowania przy pierwszym kontakcie.

{
  channels: {
    telegram: {
      enabled: true,
      botToken: "123:abc",
      dmPolicy: "pairing",
    },
  },
}

​

Czym to jest

• Kanał Telegram Bot API należący do Gateway.
• Deterministyczne routowanie: odpowiedzi wracają do Telegrama; model nigdy nie wybiera kanałów.
• DM-y współdzielą główną sesję agenta; grupy pozostają odizolowane (agent:<agentId>:telegram:group:<chatId>).

​

Konfiguracja (szybka ścieżka)

​

1. Utwórz token bota (BotFather)

1. Otwórz Telegram i porozmawiaj z @BotFather (bezpośredni link). Potwierdź, że uchwyt to dokładnie @BotFather.
2. Uruchom /newbot, a następnie postępuj zgodnie z instrukcjami (nazwa + nazwa użytkownika kończąca się na bot).
3. Skopiuj token i przechowuj go w bezpiecznym miejscu.

• /setjoingroups — zezwól/zabroń dodawania bota do grup.
• /setprivacy — kontroluj, czy bot widzi wszystkie wiadomości w grupach.

​

2. Skonfiguruj token (env lub konfiguracja)

{
  channels: {
    telegram: {
      enabled: true,
      botToken: "123:abc",
      dmPolicy: "pairing",
      groups: { "*": { requireMention: true } },
    },
  },
}

3. Uruchom gateway. Telegram startuje, gdy token zostanie rozpoznany (najpierw konfiguracja, fallback do env).
4. Dostęp do DM-ów domyślnie wymaga parowania. Zatwierdź kod przy pierwszym kontakcie z botem.
5. Dla grup: dodaj bota, zdecyduj o zachowaniu prywatności/uprawnieniach admina (poniżej), a następnie ustaw channels.telegram.groups, aby kontrolować bramkowanie wzmianek + listy dozwolonych.

​

Token + prywatność + uprawnienia (po stronie Telegrama)

​

Tworzenie tokena (BotFather)

• /newbot tworzy bota i zwraca token (zachowaj go w tajemnicy).
• Jeśli token wycieknie, unieważnij/wygeneruj go ponownie przez @BotFather i zaktualizuj konfigurację.

​

Widoczność wiadomości w grupach (Tryb prywatności)

• Wyłącz tryb prywatności za pomocą /setprivacy lub
• Dodaj bota jako administratora grupy (boty admini otrzymują wszystkie wiadomości).

​

Uprawnienia grupowe (prawa administratora)

​

Jak to działa (zachowanie)

• Wiadomości przychodzące są normalizowane do wspólnej koperty kanału z kontekstem odpowiedzi i placeholderami multimediów.
• Odpowiedzi w grupach domyślnie wymagają wzmianki (natywna @wzmianka lub agents.list[].groupChat.mentionPatterns / messages.groupChat.mentionPatterns).
• Nadpisanie wieloagentowe: ustaw wzorce per agent w agents.list[].groupChat.mentionPatterns.
• Odpowiedzi zawsze wracają do tego samego czatu Telegrama.
• Long-polling używa runnera grammY z sekwencjonowaniem per czat; całkowita współbieżność jest ograniczona przez agents.defaults.maxConcurrent.
• Telegram Bot API nie obsługuje potwierdzeń odczytu; nie ma opcji sendReadReceipts.

​

Szkic streamingu

• Włączony Tryb wątków dla bota w @BotFather (tryb tematów forum).
• Tylko prywatne wątki czatu (Telegram dołącza message_thread_id do wiadomości przychodzących).
• channels.telegram.streamMode nie ustawione na "off" (domyślnie: "partial", "block" włącza aktualizacje szkicu w kawałkach).

​

Formatowanie (HTML Telegrama)

• Tekst wychodzący Telegrama używa parse_mode: "HTML" (obsługiwany podzbiór tagów Telegrama).
• Wejście „markdownopodobne” jest renderowane do bezpiecznego HTML dla Telegrama (pogrubienie/kursywa/przekreślenie/kod/linki); elementy blokowe są spłaszczane do tekstu z nowymi liniami/punktami.
• Surowy HTML z modeli jest escapowany, aby uniknąć błędów parsowania Telegrama.
• Jeśli Telegram odrzuci ładunek HTML, OpenClaw ponawia wysyłkę tej samej wiadomości jako zwykły tekst.

​

Polecenia (natywne + niestandardowe)

{
  channels: {
    telegram: {
      customCommands: [
        { command: "backup", description: "Git backup" },
        { command: "generate", description: "Create an image" },
      ],
    },
  },
}

​

Rozwiązywanie problemów konfiguracji (polecenia)

• setMyCommands failed w logach zwykle oznacza zablokowane wyjściowe HTTPS/DNS do api.telegram.org.
• Jeśli widzisz błędy sendMessage lub sendChatAction, sprawdź trasowanie IPv6 i DNS.

• Niestandardowe polecenia to wyłącznie wpisy menu; OpenClaw ich nie implementuje, chyba że obsłużysz je gdzie indziej.
• Some commands can be handled by plugins/skills without being registered in Telegram’s command menu. These still work when typed (they just won’t show up in /commands / the menu).
• Nazwy poleceń są normalizowane (usuwany wiodący /, zamieniane na małe litery) i muszą pasować do a-z, 0-9, _ (1–32 znaki).
• Niestandardowe polecenia nie mogą nadpisywać poleceń natywnych. Konflikty są ignorowane i logowane.
• Jeśli commands.native jest wyłączone, rejestrowane są tylko niestandardowe polecenia (lub czyszczone, jeśli ich brak).

​

Device pairing commands (device-pair plugin)

1. /pair generates a setup code (sent as a separate message for easy copy/paste).
2. Wklej kod konfiguracji w aplikacji iOS, aby się połączyć.
3. /pair approve approves the latest pending device request.

​

Limity

• Tekst wychodzący jest dzielony na kawałki do channels.telegram.textChunkLimit (domyślnie 4000).
• Opcjonalne dzielenie po nowych liniach: ustaw channels.telegram.chunkMode="newline", aby dzielić po pustych liniach (granice akapitów) przed dzieleniem długości.
• Pobieranie/wysyłanie multimediów jest ograniczone do channels.telegram.mediaMaxMb (domyślnie 5).
• Żądania Telegram Bot API wygasają po channels.telegram.timeoutSeconds (domyślnie 500 przez grammY). Ustaw niżej, aby uniknąć długich zawieszeń.
• Kontekst historii grup używa channels.telegram.historyLimit (lub channels.telegram.accounts.*.historyLimit), z fallbackiem do messages.groupChat.historyLimit. Ustaw 0, aby wyłączyć (domyślnie 50).
• Historia DM-ów może być ograniczona przez channels.telegram.dmHistoryLimit (tury użytkownika). Nadpisania per użytkownik: channels.telegram.dms["<user_id>"].historyLimit.

​

Tryby aktywacji w grupach

​

Przez konfigurację (zalecane)

{
  channels: {
    telegram: {
      groups: {
        "-1001234567890": { requireMention: false }, // always respond in this group
      },
    },
  },
}

{
  channels: {
    telegram: {
      groups: {
        "*": { requireMention: false }, // all groups, always respond
      },
    },
  },
}

{
  channels: {
    telegram: {
      groups: {
        "*": { requireMention: true }, // or omit groups entirely
      },
    },
  },
}

​

Przez polecenie (poziom sesji)

• /activation always — odpowiadaj na wszystkie wiadomości
• /activation mention — wymagaj wzmianek (domyślne)

​

Uzyskanie identyfikatora czatu grupy

​

Zapisy konfiguracji

• Grupa zostanie uaktualniona do supergrupy i Telegram wyemituje migrate_to_chat_id (zmiana ID czatu). OpenClaw może automatycznie migrować channels.telegram.groups.
• Uruchomisz /config set lub /config unset w czacie Telegrama (wymaga commands.config: true).

{
  channels: { telegram: { configWrites: false } },
}

​

Tematy (supergrupy forum)

• Dołącza :topic:<threadId> do klucza sesji grupy Telegrama, aby każdy temat był odizolowany.
• Wysyła wskaźniki pisania i odpowiedzi z message_thread_id, aby odpowiedzi pozostawały w temacie.
• Temat ogólny (id wątku 1) jest specjalny: wysyłanie wiadomości pomija message_thread_id (Telegram je odrzuca), ale wskaźniki pisania nadal je zawierają.
• Udostępnia MessageThreadId + IsForum w kontekście szablonu do routingu/templatingu.
• Konfiguracja specyficzna dla tematu jest dostępna w channels.telegram.groups.<chatId>.topics.<threadId> (skills, listy dozwolonych, auto-odpowiedź, prompty systemowe, wyłączenie).
• Konfiguracje tematów dziedziczą ustawienia grupy (requireMention, listy dozwolonych, skills, prompty, włączone), chyba że zostaną nadpisane per temat.

​

Przyciski inline

{
  channels: {
    telegram: {
      capabilities: {
        inlineButtons: "allowlist",
      },
    },
  },
}

{
  channels: {
    telegram: {
      accounts: {
        main: {
          capabilities: {
            inlineButtons: "allowlist",
          },
        },
      },
    },
  },
}

• off — przyciski inline wyłączone
• dm — tylko DM-y (cele grupowe zablokowane)
• group — tylko grupy (cele DM zablokowane)
• all — DM-y + grupy
• allowlist — DM-y + grupy, ale tylko nadawcy dozwoleni przez allowFrom/groupAllowFrom (te same zasady co dla poleceń sterujących)

​

Wysyłanie przycisków

{
  action: "send",
  channel: "telegram",
  to: "123456789",
  message: "Choose an option:",
  buttons: [
    [
      { text: "Yes", callback_data: "yes" },
      { text: "No", callback_data: "no" },
    ],
    [{ text: "Cancel", callback_data: "cancel" }],
  ],
}

​

Opcje konfiguracji

• channels.telegram.capabilities: Globalna domyślna konfiguracja możliwości stosowana do wszystkich kont Telegrama, chyba że zostanie nadpisana.
• channels.telegram.accounts.<account>.capabilities: Możliwości per konto, które nadpisują globalne domyślne dla danego konta.

​

Kontrola dostępu (DM-y + grupy)

​

Dostęp do DM-ów

• Domyślnie: channels.telegram.dmPolicy = "pairing". Nieznani nadawcy otrzymują kod parowania; wiadomości są ignorowane do czasu zatwierdzenia (kody wygasają po 1 godzinie).
• Zatwierdzanie przez:
  • openclaw pairing list telegram
  • openclaw pairing approve telegram <CODE>
• Parowanie jest domyślną wymianą tokenów dla DM-ów Telegrama. Szczegóły: Parowanie
• channels.telegram.allowFrom akceptuje numeryczne identyfikatory użytkowników (zalecane) lub wpisy @username. To nie jest nazwa użytkownika bota; użyj identyfikatora nadawcy (człowieka). Kreator akceptuje @username i w miarę możliwości rozwiązuje go do identyfikatora numerycznego.

​

Znajdowanie identyfikatora użytkownika Telegrama

1. Uruchom gateway i wyślij DM do bota.
2. Uruchom openclaw logs --follow i poszukaj from.id.

1. Wyślij DM do bota.
2. Pobierz aktualizacje z tokenem bota i odczytaj message.from.id:
   curl "https://api.telegram.org/bot<bot_token>/getUpdates"
   

• Wyślij DM do @userinfobot lub @getidsbot i użyj zwróconego identyfikatora użytkownika.

​

Dostęp do grup

• Brak konfiguracji groups = wszystkie grupy dozwolone
• Z konfiguracją groups = dozwolone tylko wymienione grupy lub "*"
• Przykład: "groups": { "-1001234567890": {}, "*": {} } zezwala na wszystkie grupy

• "open" = wszyscy nadawcy w dozwolonych grupach mogą pisać
• "allowlist" = tylko nadawcy z channels.telegram.groupAllowFrom mogą pisać
• "disabled" = żadnych wiadomości grupowych w ogóle Domyślnie groupPolicy: "allowlist" (zablokowane, dopóki nie dodasz groupAllowFrom).

{
  channels: {
    telegram: {
      groups: {
        "-1001234567890": {
          groupPolicy: "open",
          requireMention: false,
        },
      },
    },
  },
}

​

Long-polling vs webhook

• Domyślnie: long-polling (nie wymaga publicznego URL).
• Tryb webhook: ustaw channels.telegram.webhookUrl i channels.telegram.webhookSecret (opcjonalnie channels.telegram.webhookPath).
  • Lokalny listener wiąże się z 0.0.0.0:8787 i domyślnie serwuje POST /telegram-webhook.
  • Jeśli publiczny URL jest inny, użyj reverse proxy i skieruj channels.telegram.webhookUrl na publiczny endpoint.

​

Wątkowanie odpowiedzi

• [[reply_to_current]] — odpowiedź na wyzwalającą wiadomość.
• [[reply_to:<id>]] — odpowiedź na konkretny identyfikator wiadomości.

• first (domyślnie), all, off.

​

Wiadomości audio (głos vs plik)

• [[audio_as_voice]] — wyślij audio jako notatkę głosową zamiast pliku.

{
  action: "send",
  channel: "telegram",
  to: "123456789",
  media: "https://example.com/voice.ogg",
  asVoice: true,
}

​

Video messages (video vs video note)

{
  action: "send",
  channel: "telegram",
  to: "123456789",
  media: "https://example.com/video.mp4",
  asVideoNote: true,
}

​

Naklejki

​

Odbieranie naklejek

• Naklejki statyczne (WEBP): Pobierane i przetwarzane przez wizję. Naklejka pojawia się jako placeholder <media:sticker> w treści wiadomości.
• Naklejki animowane (TGS): Pomijane (format Lottie nie jest obsługiwany do przetwarzania).
• Naklejki wideo (WEBM): Pomijane (format wideo nie jest obsługiwany do przetwarzania).

• Sticker — obiekt z:
  • emoji — emoji powiązane z naklejką
  • setName — nazwa zestawu naklejek
  • fileId — identyfikator pliku Telegrama (umożliwia odesłanie tej samej naklejki)
  • fileUniqueId — stabilny identyfikator do wyszukiwania w cache
  • cachedDescription — zbuforowany opis wizji, gdy dostępny

​

Cache naklejek

1. Pierwsze spotkanie: Obraz naklejki jest wysyłany do AI do analizy wizyjnej. AI generuje opis (np. „Kreskówkowy kot entuzjastycznie machający”).
2. Zapis w cache: Opis jest zapisywany wraz z identyfikatorem pliku, emoji i nazwą zestawu.
3. Kolejne spotkania: Gdy ta sama naklejka pojawi się ponownie, używany jest opis z cache. Obraz nie jest wysyłany do AI.

{
  "fileId": "CAACAgIAAxkBAAI...",
  "fileUniqueId": "AgADBAADb6cxG2Y",
  "emoji": "👋",
  "setName": "CoolCats",
  "description": "A cartoon cat waving enthusiastically",
  "cachedAt": "2026-01-15T10:30:00.000Z"
}

• Redukcja kosztów API dzięki unikaniu powtarzanych wywołań wizji dla tej samej naklejki
• Szybsze czasy odpowiedzi dla zbuforowanych naklejek (brak opóźnienia przetwarzania wizji)
• Umożliwia wyszukiwanie naklejek na podstawie zbuforowanych opisów

​

Wysyłanie naklejek

{
  channels: {
    telegram: {
      actions: {
        sticker: true,
      },
    },
  },
}

{
  action: "sticker",
  channel: "telegram",
  to: "123456789",
  fileId: "CAACAgIAAxkBAAI...",
}

• fileId (wymagane) — identyfikator pliku Telegrama naklejki. Uzyskaj go z Sticker.fileId przy odbiorze naklejki lub z wyniku sticker-search.
• replyTo (opcjonalne) — identyfikator wiadomości, na którą odpowiedzieć.
• threadId (opcjonalne) — identyfikator wątku wiadomości dla tematów forum.

{
  action: "sticker-search",
  channel: "telegram",
  query: "cat waving",
  limit: 5,
}

{
  ok: true,
  count: 2,
  stickers: [
    {
      fileId: "CAACAgIAAxkBAAI...",
      emoji: "👋",
      description: "A cartoon cat waving enthusiastically",
      setName: "CoolCats",
    },
  ],
}

{
  action: "sticker",
  channel: "telegram",
  to: "-1001234567890",
  fileId: "CAACAgIAAxkBAAI...",
  replyTo: 42,
  threadId: 123,
}

​

Strumieniowanie (szkicy)

• Prywatne czaty z włączonymi tematami (tryb tematów forum dla bota).
• Wiadomości przychodzące muszą zawierać message_thread_id (prywatny wątek tematu).
• Strumieniowanie jest ignorowane dla grup/supergrup/kanałów.

• channels.telegram.streamMode: "off" | "partial" | "block" (domyślnie: partial)
  • partial: aktualizuj dymek szkicu najnowszym tekstem strumieniowania.
  • block: aktualizuj dymek szkicu w większych blokach (kawałkami).
  • off: wyłącz strumieniowanie szkiców.
• Opcjonalnie (tylko dla streamMode: "block"):
  • channels.telegram.draftChunk: { minChars?, maxChars?, breakPreference? }
    • domyślne: minChars: 200, maxChars: 800, breakPreference: "paragraph" (ograniczone do channels.telegram.textChunkLimit).

• /reasoning stream strumieniuje rozumowanie do dymka szkicu podczas generowania odpowiedzi, a następnie wysyła odpowiedź końcową bez rozumowania.
• Jeśli channels.telegram.streamMode to off, strumień rozumowania jest wyłączony. Więcej kontekstu: Strumieniowanie + dzielenie.

​

Polityka ponowień

​

Narzędzie agenta (wiadomości + reakcje)

• Narzędzie: telegram z akcją sendMessage (to, content, opcjonalnie mediaUrl, replyToMessageId, messageThreadId).
• Narzędzie: telegram z akcją react (chatId, messageId, emoji).
• Narzędzie: telegram z akcją deleteMessage (chatId, messageId).
• Semantyka usuwania reakcji: zobacz /tools/reactions.
• Bramkowanie narzędzi: channels.telegram.actions.reactions, channels.telegram.actions.sendMessage, channels.telegram.actions.deleteMessage (domyślnie: włączone) oraz channels.telegram.actions.sticker (domyślnie: wyłączone).

​

Powiadomienia o reakcjach

1. Otrzymuje aktualizację message_reaction z Telegram API
2. Konwertuje ją na zdarzenie systemowe w formacie: "Telegram reaction added: {emoji} by {user} on msg {id}"
3. Kolejkuje zdarzenie systemowe używając tego samego klucza sesji co zwykłe wiadomości
4. Gdy nadejdzie kolejna wiadomość w tej rozmowie, zdarzenia systemowe są opróżniane i dołączane na początku kontekstu agenta

• channels.telegram.reactionNotifications: Kontroluje, które reakcje wyzwalają powiadomienia
  • "off" — ignoruj wszystkie reakcje
  • "own" — powiadamiaj, gdy użytkownicy reagują na wiadomości bota (best-effort; w pamięci) (domyślnie)
  • "all" — powiadamiaj o wszystkich reakcjach
• channels.telegram.reactionLevel: Kontroluje zdolność agenta do reagowania
  • "off" — agent nie może reagować na wiadomości
  • "ack" — bot wysyła reakcje potwierdzające (👀 podczas przetwarzania) (domyślnie)
  • "minimal" — agent może reagować oszczędnie (wytyczna: 1 na 5–10 wymian)
  • "extensive" — agent może reagować swobodnie, gdy to właściwe

{
  channels: {
    telegram: {
      reactionNotifications: "all", // See all reactions
      reactionLevel: "minimal", // Agent can react sparingly
    },
  },
}

• Boty Telegrama muszą jawnie zażądać message_reaction w allowed_updates (konfigurowane automatycznie przez OpenClaw)
• W trybie webhook reakcje są dołączane do webhooka allowed_updates
• W trybie pollingu reakcje są dołączane do getUpdates allowed_updates

​

Cele dostarczania (CLI/cron)

• Użyj identyfikatora czatu (123456789) lub nazwy użytkownika (@name) jako celu.
• Przykład: openclaw message send --channel telegram --target 123456789 --message "hi".

​

Rozwiązywanie problemów

• Jeśli ustawiono channels.telegram.groups.*.requireMention=false, tryb prywatności Telegram Bot API musi być wyłączony.
  • BotFather: /setprivacy → Wyłącz (następnie usuń i dodaj bota ponownie do grupy)
• openclaw channels status pokazuje ostrzeżenie, gdy konfiguracja oczekuje nieoznaczonych wzmianek wiadomości grupowych.
• openclaw channels status --probe może dodatkowo sprawdzić członkostwo dla jawnych numerycznych identyfikatorów grup (nie potrafi audytować reguł z symbolem wieloznacznym "*").
• Szybki test: /activation always (tylko sesja; użyj konfiguracji dla trwałości)

• Jeśli ustawiono channels.telegram.groups, grupa musi być wymieniona lub używać "*"
• Sprawdź Ustawienia prywatności w @BotFather → „Group Privacy” powinno być OFF
• Zweryfikuj, czy bot faktycznie jest członkiem (a nie tylko adminem bez dostępu do odczytu)
• Sprawdź logi gateway: openclaw logs --follow (szukaj „skipping group message”)

• Polecenie /activation aktualizuje stan sesji, ale nie zapisuje się do konfiguracji
• Dla trwałego zachowania dodaj grupę do channels.telegram.groups z requireMention: false

• Upewnij się, że Twój identyfikator użytkownika Telegrama jest autoryzowany (przez parowanie lub channels.telegram.allowFrom)
• Polecenia wymagają autoryzacji nawet w grupach z groupPolicy: "open"

• Node 22+ jest bardziej rygorystyczny wobec instancji AbortSignal; obce sygnały mogą natychmiast przerywać wywołania fetch.
• Zaktualizuj do kompilacji OpenClaw, która normalizuje sygnały abort, lub uruchamiaj gateway na Node 20 do czasu aktualizacji.

• Niektóre hosty rozwiązują api.telegram.org najpierw do IPv6. Jeśli serwer nie ma działającego wyjścia IPv6, grammY może utknąć na żądaniach tylko-IPv6.
• Naprawa: włącz wyjście IPv6 lub wymuś rozwiązywanie IPv4 dla api.telegram.org (np. dodaj wpis /etc/hosts używając rekordu A IPv4 lub preferuj IPv4 w stosie DNS systemu), a następnie zrestartuj gateway.
• Szybka kontrola: dig +short api.telegram.org A i dig +short api.telegram.org AAAA, aby potwierdzić, co zwraca DNS.

​

Referencja konfiguracji (Telegram)

• channels.telegram.enabled: włącz/wyłącz start kanału.
• channels.telegram.botToken: token bota (BotFather).
• channels.telegram.tokenFile: odczytaj token ze ścieżki pliku.
• channels.telegram.dmPolicy: pairing | allowlist | open | disabled (domyślnie: parowanie).
• channels.telegram.allowFrom: lista dozwolonych DM-ów (id/nazwy użytkowników). open wymaga "*".
• channels.telegram.groupPolicy: open | allowlist | disabled (domyślnie: lista dozwolonych).
• channels.telegram.groupAllowFrom: lista dozwolonych nadawców grupowych (id/nazwy użytkowników).
• channels.telegram.groups: domyślne ustawienia per grupa + lista dozwolonych (użyj "*" dla domyślnych globalnych).
  • channels.telegram.groups.<id>.groupPolicy: nadpisanie per grupa dla groupPolicy (open | allowlist | disabled).
  • channels.telegram.groups.<id>.requireMention: domyślne bramkowanie wzmianek.
  • channels.telegram.groups.<id>.skills: filtr skills (pominięcie = wszystkie skills, puste = brak).
  • channels.telegram.groups.<id>.allowFrom: nadpisanie listy dozwolonych nadawców per grupa.
  • channels.telegram.groups.<id>.systemPrompt: dodatkowy prompt systemowy dla grupy.
  • channels.telegram.groups.<id>.enabled: wyłącz grupę, gdy false.
  • channels.telegram.groups.<id>.topics.<threadId>.*: nadpisania per temat (te same pola co grupa).
  • channels.telegram.groups.<id>.topics.<threadId>.groupPolicy: nadpisanie per temat dla groupPolicy (open | allowlist | disabled).
  • channels.telegram.groups.<id>.topics.<threadId>.requireMention: nadpisanie bramkowania wzmianek per temat.
• channels.telegram.capabilities.inlineButtons: off | dm | group | all | allowlist (domyślnie: lista dozwolonych).
• channels.telegram.accounts.<account>.capabilities.inlineButtons: nadpisanie per konto.
• channels.telegram.replyToMode: off | first | all (domyślnie: first).
• channels.telegram.textChunkLimit: rozmiar kawałka wyjściowego (znaki).
• channels.telegram.chunkMode: length (domyślne) lub newline, aby dzielić po pustych liniach (granice akapitów) przed dzieleniem długości.
• channels.telegram.linkPreview: przełącz podglądy linków dla wiadomości wychodzących (domyślnie: true).
• channels.telegram.streamMode: off | partial | block (strumieniowanie szkiców).
• channels.telegram.mediaMaxMb: limit multimediów przychodzących/wychodzących (MB).
• channels.telegram.retry: polityka ponowień dla wywołań Telegram API (liczba prób, minDelayMs, maxDelayMs, jitter).
• channels.telegram.network.autoSelectFamily: nadpisanie Node autoSelectFamily (true=włącz, false=wyłącz). Domyślnie wyłączone na Node 22, aby uniknąć timeoutów Happy Eyeballs.
• channels.telegram.proxy: URL proxy dla wywołań Bot API (SOCKS/HTTP).
• channels.telegram.webhookUrl: włącz tryb webhook (wymaga channels.telegram.webhookSecret).
• channels.telegram.webhookSecret: sekret webhooka (wymagany, gdy webhookUrl jest ustawiony).
• channels.telegram.webhookPath: lokalna ścieżka webhooka (domyślnie /telegram-webhook).
• channels.telegram.actions.reactions: bramkuj reakcje narzędzia Telegrama.
• channels.telegram.actions.sendMessage: bramkuj wysyłanie wiadomości narzędzia Telegrama.
• channels.telegram.actions.deleteMessage: bramkuj usuwanie wiadomości narzędzia Telegrama.
• channels.telegram.actions.sticker: bramkuj akcje naklejek Telegrama — wysyłanie i wyszukiwanie (domyślnie: false).
• channels.telegram.reactionNotifications: off | own | all — kontroluj, które reakcje wyzwalają zdarzenia systemowe (domyślnie: own, gdy nie ustawiono).
• channels.telegram.reactionLevel: off | ack | minimal | extensive — kontroluj zdolność agenta do reagowania (domyślnie: minimal, gdy nie ustawiono).

• agents.list[].groupChat.mentionPatterns (wzorce bramkowania wzmianek).
• messages.groupChat.mentionPatterns (globalny fallback).
• commands.native (domyślnie "auto" → włączone dla Telegram/Discord, wyłączone dla Slack), commands.text, commands.useAccessGroups (zachowanie poleceń). Nadpisz przez channels.telegram.commands.native.
• messages.responsePrefix, messages.ackReaction, messages.ackReactionScope, messages.removeAckAfterReply.