Telegram

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

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

• 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

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

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

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

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

• 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)

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

• 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)

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

​

Audioberichten

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

​

Videoberichten

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

​

Locaties en locaties met details

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

​

Stickers

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

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

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

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

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

• 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.

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"

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

• 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

• 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 A
dig +short api.telegram.org AAAA