Telegram

Telegram-bots gebruiken standaard Privacy Mode, waardoor ze slechts een beperkt aantal groepsberichten ontvangen.

Om alle groepsberichten te zien, kun je:

• de privacymodus uitschakelen via /setprivacy, of
• de bot groepsbeheerder maken.

Nadat je de privacymodus hebt gewijzigd, moet je de bot uit elke groep verwijderen en opnieuw toevoegen, zodat Telegram de wijziging toepast.

De beheerdersstatus wordt beheerd in de groepsinstellingen van Telegram. Bots met beheerdersrechten ontvangen alle groepsberichten, wat nuttig is voor permanent actief groepsgedrag.

• /setjoingroups — toevoegen aan groepen toestaan/weigeren
• /setprivacy — gedrag voor zichtbaarheid in groepen

Dezelfde instellingen zijn beschikbaar in de webapp van BotFather als je liever een gebruikersinterface dan chatopdrachten gebruikt.

OpenClaw streamt gedeeltelijke antwoorden in realtime in directe chats, groepen en onderwerpen: het verzendt een voorbeeldbericht, voert vervolgens herhaaldelijk editMessageText uit en voltooit het bericht ter plaatse.

• channels.telegram.streaming is off | partial | block | progress (standaard: partial)
• korte eerste antwoordvoorbeelden worden gedebounced en vervolgens na een begrensde vertraging weergegeven als de uitvoering nog actief is
• progress houdt één bewerkbaar statusconcept bij voor de voortgang van tools, toont het stabiele statuslabel wanneer antwoordactiviteit vóór toolvoortgang binnenkomt, wist dit bij voltooiing en verzendt het definitieve antwoord als een normaal bericht
• streaming.preview.toolProgress bepaalt of updates over tools/voortgang hetzelfde bewerkte voorbeeldbericht hergebruiken (standaard: true wanneer voorbeeldstreaming actief is)
• streaming.preview.commandText bepaalt de details van opdrachten/uitvoering in die regels: raw (standaard) of status (alleen het toollabel)
• streaming.progress.commentary (standaard: false) schakelt tekst met commentaar/inleiding van de assistent in het tijdelijke voortgangsconcept in
• verouderde channels.telegram.streamMode-, booleaanse streaming-waarden en ingetrokken sleutels voor native conceptvoorbeelden worden gedetecteerd; voer openclaw doctor --fix uit om ze te migreren

Toolvoortgangsregels zijn de korte statusupdates die worden weergegeven terwijl tools worden uitgevoerd (opdrachtuitvoering, bestanden lezen, planningsupdates, patchsamenvattingen, Codex-inleiding/commentaar in app-servermodus). Telegram houdt deze standaard ingeschakeld (komt overeen met het uitgebrachte gedrag vanaf v2026.4.22+).

Behoud bewerkingen van antwoordvoorbeelden, maar verberg toolvoortgangsregels:

{  "channels": {    "telegram": {      "streaming": {        "mode": "partial",        "preview": { "toolProgress": false }      }    }  }}

Houd toolvoortgang zichtbaar, maar verberg tekst van opdrachten/uitvoering:

{  "channels": {    "telegram": {      "streaming": {        "mode": "partial",        "preview": { "commandText": "status" }      }    }  }}

De modus progress toont toolvoortgang zonder het definitieve antwoord in dat bericht te bewerken. Plaats het beleid voor opdrachttekst onder streaming.progress:

{  "channels": {    "telegram": {      "streaming": {        "mode": "progress",        "progress": {          "toolProgress": true,          "commandText": "status"        }      }    }  }}

streaming.mode: "off" schakelt voorbeeldbewerkingen uit en onderdrukt algemene meldingen over tools/voortgang in plaats van deze als afzonderlijke statusberichten te verzenden; goedkeuringsvragen, media en fouten worden nog steeds via de normale definitieve levering gerouteerd. streaming.preview.toolProgress: false behoudt alleen bewerkingen van antwoordvoorbeelden.

Voor antwoorden met alleen tekst: korte voorbeelden worden ter plaatse definitief bewerkt; bij lange definitieve antwoorden die over meerdere berichten worden verdeeld, wordt het voorbeeld als eerste deel hergebruikt en wordt daarna alleen de rest verzonden; definitieve antwoorden in voortgangsmodus wissen het statusconcept en gebruiken de normale definitieve levering; als de definitieve bewerking mislukt voordat de voltooiing is bevestigd, valt OpenClaw terug op de normale definitieve levering en ruimt het verouderde voorbeeld op. Voor complexe antwoorden (medialadingen) valt OpenClaw altijd terug op de normale definitieve levering en ruimt het voorbeeld op.

Voorbeeldstreaming en blokstreaming sluiten elkaar uit — wanneer blokstreaming expliciet is ingeschakeld, slaat OpenClaw de voorbeeldstream over om dubbele streaming te voorkomen.

Redenering: /reasoning stream streamt de redenering tijdens het genereren naar het live voorbeeld en verwijdert het redeneringsvoorbeeld na de definitieve levering (gebruik /reasoning on om het zichtbaar te houden). Het definitieve antwoord wordt zonder redeneringstekst verzonden.

Uitgaande tekst gebruikt standaard gewone Telegram-HTML-berichten, die leesbaar zijn in huidige clients: vet, cursief, links, code, spoilers, citaten — geen blokken die uitsluitend de uitgebreide mogelijkheden van Bot API 10.2 gebruiken (native tabellen, details, uitgebreide media, formules).

Schakel uitgebreide berichten van Bot API 10.2 in:

{channels: {telegram: {  richMessages: true,},},}

Wanneer dit is ingeschakeld: de agent krijgt te horen dat uitgebreide berichten beschikbaar zijn voor deze bot/dit account (met het ondersteunde auteurscontract voor Markdown + HTML-eilanden); Markdown-tekst wordt via de Markdown-IR van OpenClaw weergegeven als getypeerde uitgebreide blokken van Bot API 10.2 (koppen, tabellen, details, controlelijsten, uitgebreide media, formules, kaarten, collages); mediabijschriften gebruiken nog steeds Telegram-HTML-bijschriften (uitgebreide berichten vervangen bijschriften niet en bijschriften zijn beperkt tot 1024 tekens).

Hierdoor blijft modeltekst uit de buurt van Telegrams markeringen voor uitgebreide Markdown, zodat valuta zoals $400-600K niet als wiskunde wordt geïnterpreteerd. Lange uitgebreide tekst wordt automatisch opgesplitst volgens de limieten van Telegram. Tabellen die de limiet van 20 kolommen overschrijden, vallen terug op een codeblok.

Standaard: uitgeschakeld, voor clientcompatibiliteit — sommige huidige Desktop-, Web-, Android- en clients van derden geven geaccepteerde uitgebreide berichten weer als niet ondersteund. Houd dit uitgeschakeld tenzij elke client die met de bot wordt gebruikt deze berichten kan weergeven. /status toont of uitgebreide berichten voor de huidige sessie zijn in- of uitgeschakeld.

Linkvoorbeelden zijn standaard ingeschakeld. channels.telegram.linkPreview: false schakelt automatische entiteitsdetectie voor uitgebreide tekst uit.

Het opdrachtenmenu van Telegram wordt bij het opstarten geregistreerd met setMyCommands. commands.native: "auto" schakelt native opdrachten voor Telegram in.

Voeg aangepaste vermeldingen aan het opdrachtenmenu toe:

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

Regels: namen worden genormaliseerd (voorafgaande / verwijderen, omzetten naar kleine letters); geldig patroon a-z, 0-9, _, lengte 1-32; aangepaste opdrachten kunnen native opdrachten niet overschrijven; conflicten/dubbele vermeldingen worden overgeslagen en gelogd.

Aangepaste opdrachten zijn uitsluitend menuvermeldingen — ze implementeren niet automatisch gedrag. Opdrachten van Plugins/Skills kunnen nog steeds werken wanneer ze worden getypt, zelfs als ze niet in het Telegram-menu worden weergegeven. Als native opdrachten zijn uitgeschakeld, worden ingebouwde opdrachten verwijderd; aangepaste opdrachten/Plugin-opdrachten kunnen nog steeds worden geregistreerd als ze zijn geconfigureerd.

Veelvoorkomende installatiefouten:

• setMyCommands failed met BOT_COMMANDS_TOO_MUCH na een nieuwe poging met inkorting betekent dat het menu nog steeds te groot is; verminder het aantal Plugin-/Skill-/aangepaste opdrachten of schakel channels.telegram.commands.native uit.
• Als deleteWebhook, deleteMyCommands of setMyCommands mislukt met 404: Not Found, terwijl directe curl-opdrachten voor de Bot API wel werken, betekent dit meestal dat channels.telegram.apiRoot op het volledige /bot<TOKEN>-eindpunt is ingesteld. apiRoot mag alleen de hoofd-URL van de Bot API zijn; openclaw doctor --fix verwijdert een onbedoelde afsluitende /bot<TOKEN>.
• getMe returned 401 betekent dat Telegram het geconfigureerde bottoken heeft geweigerd. Werk botToken, tokenFile of TELEGRAM_BOT_TOKEN (standaardaccount) bij met het huidige BotFather-token; OpenClaw stopt vóór het pollen, zodat dit niet als een fout bij het opschonen van een Webhook wordt gemeld.
• setMyCommands failed met netwerk-/ophaalfouten betekent meestal dat uitgaande DNS/HTTPS-toegang tot api.telegram.org is geblokkeerd.

Opdrachten voor apparaatkoppeling (device-pair-Plugin)

Na installatie:

1. /pair genereert een installatiecode
2. plak de code in de iOS-app
3. /pair pending geeft openstaande verzoeken weer (inclusief rol/bereiken)
4. goedkeuren: /pair approve <requestId>, /pair approve (enige openstaande verzoek) of /pair approve latest

Als een apparaat het opnieuw probeert met gewijzigde authenticatiegegevens (rol, bereiken, openbare sleutel), wordt het vorige openstaande verzoek vervangen door een nieuwe requestId; voer /pair pending opnieuw uit voordat je het goedkeurt.

Meer informatie: Koppelen.

Configureer het bereik van het inline-toetsenbord:

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

Overschrijving per account:

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

Bereiken: off, dm, group, all, allowlist (standaard). Verouderde capabilities: ["inlineButtons"] wordt toegewezen aan "all".

Voorbeeld van een berichtactie:

{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" }],],}

Voorbeeld van een Mini App-knop:

{action: "send",channel: "telegram",to: "123456789",message: "Open app:",presentation: {blocks: [  {    type: "buttons",    buttons: [{ label: "Launch", web_app: { url: "https://example.com/app" } }],  },],},}

web_app-knoppen werken alleen in privéchats tussen een gebruiker en de bot.

Klikken op callbacks die niet door een geregistreerde interactieve handler van een Plugin worden geclaimd, worden als tekst aan de agent doorgegeven: callback_data: <value>.

Acties:

• sendMessage (to, content, optioneel mediaUrl, replyToMessageId, messageThreadId)
• react (chatId, messageId, emoji)
• deleteMessage (chatId, messageId)
• editMessage (chatId, messageId, content of caption, optioneel presentation inlineknoppen; bewerkingen met alleen knoppen werken de antwoordopmaak bij)
• createForumTopic (chatId, name, optioneel iconColor, iconCustomEmojiId)

Ergonomische aliassen: send, react, delete, edit, sticker, sticker-search, topic-create.

Beperking: channels.telegram.actions.sendMessage, deleteMessage, reactions, sticker (standaard: uitgeschakeld). edit, createForumTopic en editForumTopic zijn standaard ingeschakeld zonder afzonderlijke schakelaar. Verzendingen tijdens runtime gebruiken de actieve momentopname van configuratie/geheimen vanaf het opstarten of herladen, zodat actiepaden de waarden van SecretRef niet voor elke verzending opnieuw herleiden.

Semantiek voor het verwijderen van reacties: /tools/reactions.

Expliciete tags voor antwoordthreads in gegenereerde uitvoer:

• [[reply_to_current]] — antwoordt op het activerende bericht
• [[reply_to:<id>]] — antwoordt op een specifieke bericht-ID

channels.telegram.replyToMode: off (standaard), first, all.

Wanneer antwoordthreads zijn ingeschakeld en de oorspronkelijke tekst of het oorspronkelijke bijschrift beschikbaar is, voegt OpenClaw automatisch een systeemeigen citaatfragment toe. Telegram beperkt systeemeigen citaattekst tot 1024 UTF-16-code-eenheden; bij langere berichten wordt vanaf het begin geciteerd en wordt teruggevallen op een gewoon antwoord als Telegram het citaat weigert.

off schakelt alleen impliciete antwoordthreads uit; expliciete [[reply_to_*]]-tags worden nog steeds gerespecteerd.

Forumsupergroepen: aan onderwerpssessiesleutels wordt :topic:<threadId> toegevoegd; antwoorden en type-indicaties zijn gericht op de onderwerpthread; het configuratiepad voor onderwerpen is channels.telegram.groups.<chatId>.topics.<threadId>.

Het algemene onderwerp (threadId=1) is een speciaal geval: bij het verzenden van berichten wordt message_thread_id weggelaten (Telegram weigert sendMessage(...thread_id=1) met "thread not found"), maar typeacties bevatten nog steeds message_thread_id (empirisch vereist om de type-indicator te laten verschijnen).

Onderwerpvermeldingen nemen groepsinstellingen over, tenzij deze worden overschreven (requireMention, allowFrom, skills, systemPrompt, enabled, groupPolicy). agentId geldt uitsluitend voor onderwerpen en neemt geen standaardwaarden van de groep over. topics."*" stelt standaardwaarden in voor elk onderwerp in die groep; exacte onderwerp-ID's hebben nog steeds voorrang op "*".

Agentroutering per onderwerp: elk onderwerp kan via agentId in de onderwerpconfiguratie naar een andere agent worden gerouteerd, waardoor het een eigen werkruimte, geheugen en sessie krijgt:

{  channels: {    telegram: {      groups: {        "-1001234567890": {          topics: {            "1": { agentId: "main" },      // Algemeen onderwerp -> hoofdagent            "3": { agentId: "zu" },        // Ontwikkelonderwerp -> zu-agent            "5": { agentId: "coder" }      // Codebeoordeling -> coder-agent          }        }      }    }  }}

Elk onderwerp heeft vervolgens een eigen sessiesleutel, bijvoorbeeld agent:zu:telegram:group:-1001234567890:topic:3.

Permanente ACP-onderwerpkoppeling: forumonderwerpen kunnen ACP-harnesssessies vastzetten via getypeerde koppelingen op het hoogste niveau (bindings[] met type: "acp", match.channel: "telegram", peer.kind: "group" en een onderwerpspecifieke ID zoals -1001234567890:topic:42). Momenteel beperkt tot forumonderwerpen in groepen/supergroepen. Zie ACP-agenten.

Aan een thread gebonden ACP-start vanuit de chat: /acp spawn <agent> --thread here|auto koppelt het huidige onderwerp aan een nieuwe ACP-sessie; vervolgberichten worden daar rechtstreeks naartoe gerouteerd en OpenClaw zet de startbevestiging vast in het onderwerp. Wordt beheerd door session.threadBindings.spawnSessions (standaard: true).

De sjablooncontext stelt MessageThreadId en IsForum beschikbaar. Privéchats met message_thread_id behouden antwoordmetadata, maar gebruiken alleen threadbewuste sessiesleutels wanneer Telegram getMe rapporteert als has_topics_enabled: true. De uitgefaseerde overschrijvingen dm.threadReplies en direct.*.threadReplies zijn verwijderd; de threadmodus van BotFather is de enige bron van waarheid. Voer openclaw doctor --fix uit om verouderde configuratiesleutels te verwijderen.

Audioberichten

Telegram maakt onderscheid tussen spraaknotities en audiobestanden. Standaard: gedrag als audiobestand; plaats de tag [[audio_as_voice]] in het antwoord van de agent om verzending als spraaknotitie af te dwingen. Transcripties van inkomende spraaknotities worden in de agentcontext gekaderd als machinaal gegenereerde, niet-vertrouwde tekst, maar vermeldingsdetectie gebruikt nog steeds de onbewerkte transcriptie, zodat spraakberichten waarvoor een vermelding vereist is blijven werken.

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

Videoberichten

Telegram maakt onderscheid tussen videobestanden en videonotities. Videonotities ondersteunen geen bijschriften; opgegeven berichttekst wordt afzonderlijk verzonden.

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

Locaties en locaties met details

Gebruik de bestaande actie send met één zelfstandig location-object. Coördinaten verzenden een systeemeigen locatiepin; als zowel name als address worden toegevoegd, wordt een systeemeigen locatiekaart verzonden. Locatieverzendingen kunnen niet worden gecombineerd met berichttekst of media.

{action: "send",channel: "telegram",to: "123456789",location: {latitude: 48.858844,longitude: 2.294351,accuracy: 12,name: "Eiffeltoren",address: "Champ de Mars, Parijs",},}

Stickers

Inkomend: statische WEBP wordt gedownload en verwerkt (tijdelijke aanduiding <media:sticker>); geanimeerde TGS en video-WEBM worden overgeslagen.

Stickercontextvelden: Sticker.emoji, Sticker.setName, Sticker.fileId, Sticker.fileUniqueId, Sticker.cachedDescription. Beschrijvingen worden opgeslagen in de OpenClaw SQLite-pluginstatus om herhaalde vision-aanroepen te beperken.

Stickeracties inschakelen:

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

Verzenden:

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

Opgeslagen stickers doorzoeken:

{action: "sticker-search",channel: "telegram",query: "zwaaiende kat",limit: 5,}

Telegram-reacties komen binnen als message_reaction-updates, los van de berichtpayloads. Wanneer dit is ingeschakeld, plaatst OpenClaw systeemgebeurtenissen zoals Telegram reaction added: 👍 by Alice (@alice) on msg 42 in de wachtrij.

• channels.telegram.reactionNotifications: off | own | all (standaard: own)
• channels.telegram.reactionLevel: off | ack | minimal | extensive (standaard: minimal)

own betekent uitsluitend gebruikersreacties op door de bot verzonden berichten (op basis van beste inspanning via een cache van verzonden berichten). Reactiegebeurtenissen respecteren nog steeds de toegangscontroles van Telegram (dmPolicy, allowFrom, groupPolicy, groupAllowFrom); onbevoegde afzenders worden genegeerd.

Telegram verstrekt geen thread-ID's in reactie-updates: niet-forumgroepen worden naar de groepschatsessie gerouteerd; forumgroepen worden naar de sessie van het algemene onderwerp (:topic:1) gerouteerd, niet naar het exacte oorspronkelijke onderwerp.

allowed_updates voor polling/webhook bevat automatisch message_reaction.

ackReaction verzendt een bevestigingsemoji terwijl OpenClaw een inkomend bericht verwerkt. messages.ackReactionScope bepaalt wanneer deze wordt verzonden.

Volgorde voor het bepalen van de emoji:

• channels.telegram.accounts.<accountId>.ackReaction
• channels.telegram.ackReaction
• messages.ackReaction
• terugval op de identiteitsemoji van de agent (agents.entries.*.identity.emoji, anders "👀")

Telegram verwacht een unicode-emoji (bijvoorbeeld "👀"); gebruik "" om de reactie voor een kanaal of account uit te schakelen.

Bereik (messages.ackReactionScope, standaard "group-mentions"; momenteel geen overschrijving per Telegram-account of Telegram-kanaal):

all (privéchats + groepen, inclusief omgevingsgebeurtenissen in ruimten), direct (alleen privéchats), group-all (elk groepsbericht behalve omgevingsgebeurtenissen in ruimten, geen privéchats), group-mentions (groepen wanneer de bot wordt vermeld; geen privéchats — standaard), off / none (uitgeschakeld).

Schrijfbewerkingen aan de kanaalconfiguratie zijn standaard ingeschakeld (configWrites !== false). Door Telegram geactiveerde schrijfbewerkingen omvatten groepsmigratiegebeurtenissen (migrate_to_chat_id, werkt channels.telegram.groups bij) en /config set / /config unset (vereist dat opdrachten zijn ingeschakeld).

Uitschakelen:

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

Standaard wordt long polling gebruikt. Stel voor de webhookmodus channels.telegram.webhookUrl en channels.telegram.webhookSecret in; optioneel webhookPath (standaard /telegram-webhook), webhookHost (standaard 127.0.0.1), webhookPort (standaard 8787), webhookCertPath (zelfondertekend certificaat in PEM-indeling voor configuraties met een rechtstreeks IP-adres of zonder domein).

In de long-pollingmodus slaat OpenClaw het herstartwatermerk pas permanent op nadat een update met succes is doorgegeven; na een mislukte handler kan die update in hetzelfde proces opnieuw worden geprobeerd in plaats van als voltooid te worden gemarkeerd.

De lokale listener bindt standaard aan 127.0.0.1:8787. Plaats voor openbare toegang een reverse proxy vóór de lokale poort of stel webhookHost: "0.0.0.0" bewust in.

De webhookmodus valideert aanvraagbeveiligingen, het geheime token van Telegram en de JSON-body, en legt de update vervolgens vast in de duurzame wachtrij voor inkomend verkeer voordat een lege 200 wordt geretourneerd. Succesvolle duurzame overname bevat x-openclaw-delivery-accepted: durable; antwoorden voor statuscontroles, routering, authenticatie, validatie en opslagfouten laten deze header weg. Reverse proxy's en hostcontrollers kunnen de header vereisen om overname door OpenClaw te onderscheiden van een generieke lege 200, zonder acceptatie af te leiden uit de responstijd.

Na de duurzame schrijfbewerking claimt en verwerkt OpenClaw updates via de afvoer voor inkomend kanaalverkeer in de kern (banen per chat/per onderwerp, voltooid bij overname van de beurt, time-out bij stilstand vóór overname). Trage agentbeurten houden de afleveringsbevestiging van Telegram niet tegen.

• channels.telegram.textChunkLimit standaard 4000; streaming.chunkMode="newline" geeft vóór splitsing op lengte de voorkeur aan alineagrenzen (lege regels).
• channels.telegram.mediaMaxMb (standaard 100) begrenst de grootte van inkomende en uitgaande media.
• de groepscontextgeschiedenis gebruikt channels.telegram.historyLimit of messages.groupChat.historyLimit (standaard 50); 0 schakelt dit uit.
• aanvullende context voor antwoorden/citaten/doorgestuurde berichten wordt genormaliseerd tot één geselecteerd contextvenster van het gesprek wanneer de Gateway de bovenliggende berichten heeft waargenomen; de cache met waargenomen berichten bevindt zich in de SQLite-pluginstatus van OpenClaw en openclaw doctor --fix importeert verouderde zijbestanden. Telegram bevat per update slechts één oppervlakkige reply_to_message, waardoor ketens die ouder zijn dan de cache tot die payload beperkt blijven.
• Telegram-toelatingslijsten bepalen hoofdzakelijk wie de agent kan activeren en vormen geen volledige redactiegrens voor aanvullende context.
• DM-geschiedenis: channels.telegram.dmHistoryLimit, channels.telegram.dms["<user_id>"].historyLimit.

Verzenddoelen voor de CLI en berichttool accepteren een numerieke chat-ID, gebruikersnaam of forumonderwerpdoel:

openclaw message send --channel telegram --target 123456789 --message "hi"openclaw message send --channel telegram --target @name --message "hi"openclaw message send --channel telegram --target -1001234567890:topic:42 --message "hi topic"

Peilingen gebruiken openclaw message poll en ondersteunen forumonderwerpen:

openclaw message poll --channel telegram --target 123456789 \--poll-question "Ship it?" --poll-option "Yes" --poll-option "No"openclaw message poll --channel telegram --target -1001234567890:topic:42 \--poll-question "Pick a time" --poll-option "10am" --poll-option "2pm" \--poll-duration-seconds 300 --poll-public

Peilingsvlaggen die alleen voor Telegram gelden: --poll-duration-seconds (5-600), --poll-anonymous, --poll-public, --thread-id (of een :topic:-doel). --poll-option wordt 2-12 keer herhaald (de optielimiet van Telegram).

Verzenden via Telegram ondersteunt ook --presentation met buttons-blokken voor inline toetsenborden (wanneer channels.telegram.capabilities.inlineButtons dit toestaat), --pin of --delivery '{"pin":true}' om vastgezette bezorging aan te vragen wanneer de bot berichten in die chat kan vastzetten, en --force-document om uitgaande afbeeldingen, GIF's en video's als documenten te verzenden in plaats van als gecomprimeerde/geanimeerde/video-uploads.

Actiebeperking: channels.telegram.actions.sendMessage=false schakelt alle uitgaande berichten uit, inclusief peilingen; channels.telegram.actions.poll=false schakelt het maken van peilingen uit terwijl normale verzending ingeschakeld blijft.

Telegram ondersteunt uitvoeringsgoedkeuringen in DM's van goedkeurders en kan optioneel prompts plaatsen in de oorspronkelijke chat of het oorspronkelijke onderwerp. Goedkeurders moeten numerieke Telegram-gebruikers-ID's zijn.

• channels.telegram.execApprovals.enabled ("auto" schakelt dit in wanneer ten minste één goedkeurder kan worden bepaald)
• channels.telegram.execApprovals.approvers (valt terug op numerieke eigenaars-ID's uit commands.ownerAllowFrom)
• channels.telegram.execApprovals.target: dm (standaard) | channel | both
• agentFilter, sessionFilter

channels.telegram.allowFrom, groupAllowFrom en defaultTo bepalen wie met de bot kan communiceren en waar deze normale antwoorden verzendt — ze maken iemand niet tot een goedkeurder van uitvoeringen. De eerste goedgekeurde DM-koppeling initialiseert commands.ownerAllowFrom wanneer er nog geen opdrachteigenaar bestaat, zodat configuraties met één eigenaar werken zonder ID's onder execApprovals.approvers te dupliceren.

Bij bezorging in het kanaal wordt de opdrachttekst in de chat weergegeven; schakel channel of both alleen in voor vertrouwde groepen/onderwerpen. Wanneer de prompt in een forumonderwerp terechtkomt, behoudt OpenClaw het onderwerp voor de goedkeuringsprompt en de opvolging. Uitvoeringsgoedkeuringen verlopen standaard na 30 minuten.

Inline goedkeuringsknoppen vereisen ook dat channels.telegram.capabilities.inlineButtons het doeloppervlak toestaat (dm, group of all). Goedkeurings-ID's met het voorvoegsel plugin: worden via plugingoedkeuringen afgehandeld; andere worden eerst via uitvoeringsgoedkeuringen afgehandeld.

Zie Uitvoeringsgoedkeuringen.

• Als requireMention=false, moet de privacymodus van Telegram volledige zichtbaarheid toestaan: BotFather /setprivacy -> Disable, verwijder de bot vervolgens uit de groep en voeg deze opnieuw toe.
• openclaw channels status waarschuwt wanneer de configuratie groepsberichten zonder vermelding verwacht.
• openclaw channels status --probe controleert expliciete numerieke groeps-ID's; voor jokerteken "*" kan lidmaatschap niet worden gecontroleerd.
• Snelle sessietest: /activation always.

• Wanneer channels.telegram.groups bestaat, moet de groep worden vermeld (of "*" bevatten).
• Controleer of de bot lid is van de groep.
• Bekijk openclaw logs --follow voor redenen waarom berichten worden overgeslagen.

• Autoriseer je afzenderidentiteit (koppeling en/of numerieke allowFrom); opdrachtautorisatie blijft van toepassing, zelfs wanneer het groepsbeleid open is.
• setMyCommands failed met BOT_COMMANDS_TOO_MUCH betekent dat het systeemeigen menu te veel items bevat; verminder het aantal plugin-/skill-/aangepaste opdrachten of schakel systeemeigen menu's uit.
• Opstartaanroepen van deleteMyCommands / setMyCommands en typeaanroepen van sendChatAction zijn begrensd en worden bij een time-out van de aanvraag één keer opnieuw geprobeerd via de transportterugval van Telegram. Aanhoudende netwerk-/ophaalfouten betekenen meestal dat DNS/HTTPS naar api.telegram.org onbereikbaar is.

• getMe returned 401 is een Telegram-authenticatiefout voor het geconfigureerde bottoken. Kopieer het token opnieuw of genereer het opnieuw in BotFather en werk vervolgens channels.telegram.botToken, tokenFile, accounts.<id>.botToken of TELEGRAM_BOT_TOKEN (standaardaccount) bij.
• deleteWebhook 401 Unauthorized tijdens het opstarten is ook een authenticatiefout; dit behandelen als "er bestaat geen Webhook" zou dezelfde fout door het onjuiste token alleen uitstellen tot een latere API-aanroep.

• Node 22+ met een aangepaste fetch/proxy kan onmiddellijk afbreekgedrag veroorzaken als de typen van AbortSignal niet overeenkomen.
• Sommige hosts zetten api.telegram.org eerst om naar IPv6; defect uitgaand IPv6-verkeer veroorzaakt incidentele API-fouten.
• Logboeken met TypeError: fetch failed of Network request for 'getUpdates' failed! worden opnieuw geprobeerd als herstelbare netwerkfouten.
• Tijdens het opstarten van het peilen hergebruikt OpenClaw de geslaagde getMe-opstartcontrole voor grammY, zodat de runner geen tweede getMe nodig heeft vóór de eerste getUpdates.
• Als deleteWebhook tijdens het opstarten van het peilen mislukt door een tijdelijke netwerkfout, gaat OpenClaw door met lang peilen in plaats van nog een besturingsvlak-aanroep vóór het peilen uit te voeren. Een nog actieve Webhook verschijnt vervolgens als een getUpdates-conflict; OpenClaw bouwt het transport opnieuw op en probeert de Webhook opnieuw op te schonen.
• Polling stall detected in logboeken betekent dat OpenClaw het peilen opnieuw start en het transport opnieuw opbouwt nadat standaard gedurende 120 seconden geen voltooide vitaliteitscontrole van lang peilen is geregistreerd.
• openclaw channels status --probe en openclaw doctor waarschuwen wanneer een actief peilaccount na de respijtperiode voor opstarten geen getUpdates heeft voltooid, een actief Webhook-account na de respijtperiode voor opstarten geen setWebhook heeft voltooid, of de laatste geslaagde peiltransportactiviteit verouderd is.
• Telegram respecteert proxy-omgevingsvariabelen van het proces voor Bot API-transport: HTTP_PROXY, HTTPS_PROXY, ALL_PROXY en varianten in kleine letters. NO_PROXY / no_proxy kunnen api.telegram.org nog steeds omzeilen.
• Als OPENCLAW_PROXY_URL is ingesteld voor een serviceomgeving en er geen standaard proxy-omgevingsvariabele aanwezig is, gebruikt Telegram die URL ook voor Bot API-transport.
• Leid Telegram API-aanroepen op VPS-hosts met instabiel direct uitgaand verkeer/TLS via een proxy:

channels:telegram:proxy: socks5://<user>:<password>@proxy-host:1080

• Node 22+ gebruikt standaard autoSelectFamily=true (behalve WSL2). De resultaatvolgorde van Telegram-DNS volgt OPENCLAW_TELEGRAM_DNS_RESULT_ORDER, daarna channels.telegram.network.dnsResultOrder en vervolgens de processtandaard (bijvoorbeeld NODE_OPTIONS=--dns-result-order=ipv4first), met een terugval naar ipv4first op Node 22+ als geen daarvan van toepassing is.
• Dwing op WSL2, of wanneer uitsluitend IPv4 beter werkt, de familieselectie af:

channels:telegram:network:  autoSelectFamily: false

• Antwoorden uit het RFC 2544-benchmarkbereik (198.18.0.0/15) zijn standaard al toegestaan voor Telegram-mediadownloads. Als een vertrouwde nep-IP- of transparante proxy api.telegram.org tijdens mediadownloads herschrijft naar een ander privé/intern/speciaal adres, meld je dan aan voor de omzeiling die alleen voor Telegram geldt:

channels:telegram:network:  dangerouslyAllowPrivateNetwork: true

• Dezelfde opt-in is per account beschikbaar via channels.telegram.accounts.<accountId>.network.dangerouslyAllowPrivateNetwork.
• Als je proxy Telegram-mediahosts omzet naar 198.18.x.x, laat de gevaarlijke vlag dan eerst uitgeschakeld — dat bereik is standaard al toegestaan.

• Tijdelijke omgevingsoverschrijvingen: OPENCLAW_TELEGRAM_DISABLE_AUTO_SELECT_FAMILY=1, OPENCLAW_TELEGRAM_ENABLE_AUTO_SELECT_FAMILY=1, OPENCLAW_TELEGRAM_DNS_RESULT_ORDER=ipv4first.
• Valideer DNS-antwoorden:

dig +short api.telegram.org Adig +short api.telegram.org AAAA