Telegram

Für Telegram-Bots ist standardmäßig der Privacy Mode aktiviert, der einschränkt, welche Gruppennachrichten sie empfangen.

Um alle Gruppennachrichten zu sehen, können Sie entweder:

• den Datenschutzmodus über /setprivacy deaktivieren oder
• den Bot zum Gruppenadministrator machen.

Nachdem Sie den Datenschutzmodus umgeschaltet haben, entfernen Sie den Bot aus jeder Gruppe und fügen Sie ihn erneut hinzu, damit Telegram die Änderung anwendet.

Der Administratorstatus wird in den Telegram-Gruppeneinstellungen gesteuert. Administrator-Bots empfangen alle Gruppennachrichten, was für ein dauerhaft aktives Gruppenverhalten nützlich ist.

• /setjoingroups — Hinzufügen zu Gruppen zulassen/verbieten
• /setprivacy — Verhalten der Gruppensichtbarkeit

Dieselben Einstellungen sind in der Web-App von BotFather verfügbar, wenn Sie eine Benutzeroberfläche gegenüber Chat-Befehlen bevorzugen.

OpenClaw streamt Teilantworten in Echtzeit in Direktchats, Gruppen und Themen: Es sendet eine Vorschaunachricht, führt dann wiederholt editMessageText aus und schließt die Nachricht direkt an Ort und Stelle ab.

• channels.telegram.streaming ist off | partial | block | progress (Standard: partial)
• Kurze anfängliche Antwortvorschauen werden entprellt und anschließend nach einer begrenzten Verzögerung angezeigt, falls die Ausführung noch aktiv ist
• progress behält einen bearbeitbaren Statusentwurf für den Werkzeugfortschritt bei, zeigt die stabile Statusbezeichnung an, wenn Antwortaktivität vor dem Werkzeugfortschritt eintritt, löscht ihn nach Abschluss und sendet die endgültige Antwort als normale Nachricht
• streaming.preview.toolProgress steuert, ob Werkzeug-/Fortschrittsaktualisierungen dieselbe bearbeitete Vorschaunachricht wiederverwenden (Standard: true, wenn Vorschau-Streaming aktiv ist)
• streaming.preview.commandText steuert die Befehls-/Ausführungsdetails innerhalb dieser Zeilen: raw (Standard) oder status (nur Werkzeugbezeichnung)
• streaming.progress.commentary (Standard: false) aktiviert Kommentar-/Präambeltext des Assistenten im temporären Fortschrittsentwurf
• Veraltete channels.telegram.streamMode-, boolesche streaming-Werte und eingestellte Schlüssel für native Entwurfsvorschauen werden erkannt; führen Sie openclaw doctor --fix aus, um sie zu migrieren

Werkzeugfortschrittszeilen sind die kurzen Statusaktualisierungen, die während der Ausführung von Werkzeugen angezeigt werden (Befehlsausführung, Lesen von Dateien, Planungsaktualisierungen, Patch-Zusammenfassungen sowie Codex-Präambeln/-Kommentare im App-Server-Modus). Bei Telegram sind sie standardmäßig aktiviert (entspricht dem veröffentlichten Verhalten ab v2026.4.22).

Antwortvorschau-Bearbeitungen beibehalten, aber Werkzeugfortschrittszeilen ausblenden:

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

Werkzeugfortschritt sichtbar lassen, aber Befehls-/Ausführungstext ausblenden:

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

Der Modus progress zeigt den Werkzeugfortschritt an, ohne die endgültige Antwort in diese Nachricht einzufügen. Legen Sie die Richtlinie für Befehlstext unter streaming.progress fest:

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

streaming.mode: "off" deaktiviert Vorschaubearbeitungen und unterdrückt allgemeine Werkzeug-/Fortschrittsmeldungen, anstatt sie als eigenständige Statusnachrichten zu senden; Genehmigungsaufforderungen, Medien und Fehler werden weiterhin über die normale endgültige Zustellung übermittelt. streaming.preview.toolProgress: false behält nur Bearbeitungen der Antwortvorschau bei.

Bei reinen Textantworten werden kurze Vorschauen direkt mit der endgültigen Fassung aktualisiert; lange endgültige Antworten, die auf mehrere Nachrichten aufgeteilt werden, verwenden die Vorschau als ersten Abschnitt und senden anschließend nur den Rest; endgültige Antworten im Fortschrittsmodus löschen den Statusentwurf und verwenden die normale endgültige Zustellung; schlägt die endgültige Bearbeitung fehl, bevor der Abschluss bestätigt wurde, greift OpenClaw auf die normale endgültige Zustellung zurück und entfernt die veraltete Vorschau. Bei komplexen Antworten (Medien-Nutzlasten) greift OpenClaw immer auf die normale endgültige Zustellung zurück und entfernt die Vorschau.

Vorschau-Streaming und Block-Streaming schließen sich gegenseitig aus — wenn Block-Streaming ausdrücklich aktiviert ist, überspringt OpenClaw den Vorschau-Stream, um doppeltes Streaming zu vermeiden.

Schlussfolgerungen: /reasoning stream streamt Schlussfolgerungen während der Generierung in die Live-Vorschau und löscht die Schlussfolgerungsvorschau nach der endgültigen Zustellung (verwenden Sie /reasoning on, um sie sichtbar zu lassen). Die endgültige Antwort wird ohne Schlussfolgerungstext gesendet.

Ausgehender Text verwendet standardmäßig reguläre Telegram-HTML-Nachrichten, die in aktuellen Clients lesbar sind: Fettdruck, Kursivschrift, Links, Code, Spoiler und Zitate — keine ausschließlich vielfältigen Blöcke der Bot API 10.2 (native Tabellen, Details, vielfältige Medien, Formeln).

Vielfältige Nachrichten der Bot API 10.2 aktivieren:

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

Wenn aktiviert: Der Agent wird darüber informiert, dass vielfältige Nachrichten für diesen Bot bzw. dieses Konto verfügbar sind (einschließlich des unterstützten Erstellungsvertrags mit Markdown und HTML-Inseln); Markdown-Text wird über die Markdown-IR von OpenClaw als typisierte vielfältige Blöcke der Bot API 10.2 gerendert (Überschriften, Tabellen, Details, Checklisten, vielfältige Medien, Formeln, Karten, Collagen); Medienbeschriftungen verwenden weiterhin Telegram-HTML-Beschriftungen (vielfältige Nachrichten ersetzen Beschriftungen nicht, und Beschriftungen sind auf 1024 Zeichen begrenzt).

Dadurch bleiben Telegram-Sigillen für vielfältiges Markdown aus Modelltexten heraus, sodass Währungsangaben wie $400-600K nicht als Mathematik interpretiert werden. Langer vielfältiger Text wird automatisch entsprechend den Telegram-Beschränkungen aufgeteilt. Tabellen, die die Grenze von 20 Spalten überschreiten, werden stattdessen als Codeblock dargestellt.

Standard: deaktiviert, um die Client-Kompatibilität zu gewährleisten — einige aktuelle Desktop-, Web-, Android- und Drittanbieter-Clients stellen akzeptierte vielfältige Nachrichten als nicht unterstützt dar. Lassen Sie diese Option deaktiviert, sofern nicht jeder mit dem Bot verwendete Client sie darstellen kann. /status zeigt an, ob vielfältige Nachrichten für die aktuelle Sitzung aktiviert oder deaktiviert sind.

Linkvorschauen sind standardmäßig aktiviert. channels.telegram.linkPreview: false deaktiviert die automatische Entitätserkennung für vielfältigen Text.

Das Befehlsmenü von Telegram wird beim Start mit setMyCommands registriert. commands.native: "auto" aktiviert native Befehle für Telegram.

Benutzerdefinierte Einträge zum Befehlsmenü hinzufügen:

{channels: {telegram: {  customCommands: [    { command: "backup", description: "Git-Sicherung" },    { command: "generate", description: "Ein Bild erstellen" },  ],},},}

Regeln: Namen werden normalisiert (führendes / entfernen, in Kleinbuchstaben umwandeln); gültiges Muster a-z, 0-9, _, Länge 1-32; benutzerdefinierte Befehle können native Befehle nicht überschreiben; Konflikte/Duplikate werden übersprungen und protokolliert.

Benutzerdefinierte Befehle sind lediglich Menüeinträge — sie implementieren nicht automatisch ein Verhalten. Plugin-/Skill-Befehle können weiterhin funktionieren, wenn sie eingegeben werden, auch wenn sie nicht im Telegram-Menü angezeigt werden. Wenn native Befehle deaktiviert sind, werden integrierte Befehle entfernt; benutzerdefinierte Befehle und Plugin-Befehle können bei entsprechender Konfiguration weiterhin registriert werden.

Häufige Einrichtungsfehler:

• setMyCommands failed mit BOT_COMMANDS_TOO_MUCH nach einem erneuten Kürzungsversuch bedeutet, dass das Menü weiterhin zu groß ist; reduzieren Sie die Anzahl der Plugin-, Skill- oder benutzerdefinierten Befehle oder deaktivieren Sie channels.telegram.commands.native.
• Wenn deleteWebhook, deleteMyCommands oder setMyCommands mit 404: Not Found fehlschlägt, während direkte Bot-API-cURL-Befehle funktionieren, bedeutet dies in der Regel, dass channels.telegram.apiRoot auf den vollständigen /bot<TOKEN>-Endpunkt festgelegt wurde. apiRoot darf nur die Stammadresse der Bot API enthalten; openclaw doctor --fix entfernt ein versehentlich angehängtes /bot<TOKEN>.
• getMe returned 401 bedeutet, dass Telegram das konfigurierte Bot-Token abgelehnt hat. Aktualisieren Sie botToken, tokenFile oder TELEGRAM_BOT_TOKEN (Standardkonto) mit dem aktuellen BotFather-Token; OpenClaw hält vor dem Polling an, sodass dies nicht als Fehler bei der Webhook-Bereinigung gemeldet wird.
• setMyCommands failed zusammen mit Netzwerk-/Abruffehlern bedeutet in der Regel, dass ausgehende DNS-/HTTPS-Verbindungen zu api.telegram.org blockiert sind.

Befehle zur Gerätekopplung (device-pair-Plugin)

Wenn installiert:

1. /pair erzeugt einen Einrichtungscode
2. Fügen Sie den Code in die iOS-App ein
3. /pair pending listet ausstehende Anfragen auf (einschließlich Rolle/Berechtigungsumfängen)
4. Genehmigen: /pair approve <requestId>, /pair approve (nur ausstehende Anfrage) oder /pair approve latest

Wenn ein Gerät den Vorgang mit geänderten Authentifizierungsdetails (Rolle, Berechtigungsumfänge, öffentlicher Schlüssel) erneut versucht, wird die vorherige ausstehende Anfrage durch eine neue requestId ersetzt; führen Sie vor der Genehmigung /pair pending erneut aus.

Weitere Einzelheiten: Kopplung.

Geltungsbereich der Inline-Tastatur konfigurieren:

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

Kontospezifische Überschreibung:

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

Geltungsbereiche: off, dm, group, all, allowlist (Standard). Das veraltete capabilities: ["inlineButtons"] wird "all" zugeordnet.

Beispiel für eine Nachrichtenaktion:

{action: "send",channel: "telegram",to: "123456789",message: "Wählen Sie eine Option:",buttons: [[  { text: "Ja", callback_data: "yes" },  { text: "Nein", callback_data: "no" },],[{ text: "Abbrechen", callback_data: "cancel" }],],}

Beispiel für eine Mini-App-Schaltfläche:

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

web_app-Schaltflächen funktionieren nur in privaten Chats zwischen einem Benutzer und dem Bot.

Callback-Klicks, die nicht von einem registrierten interaktiven Plugin-Handler übernommen werden, werden als Text an den Agenten weitergegeben: callback_data: <value>.

Aktionen:

• sendMessage (to, content, optional mediaUrl, replyToMessageId, messageThreadId)
• react (chatId, messageId, emoji)
• deleteMessage (chatId, messageId)
• editMessage (chatId, messageId, content oder caption, optionale presentation-Inline-Schaltflächen; Änderungen, die nur Schaltflächen betreffen, aktualisieren das Antwort-Markup)
• createForumTopic (chatId, name, optional iconColor, iconCustomEmojiId)

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

Aktivierung: channels.telegram.actions.sendMessage, deleteMessage, reactions, sticker (Standard: deaktiviert). edit, createForumTopic und editForumTopic sind standardmäßig ohne eigenen Umschalter aktiviert. Laufzeitsendungen verwenden den aktiven Konfigurations-/Secret-Snapshot vom Start bzw. Neuladen, daher lösen Aktionspfade die SecretRef-Werte nicht bei jeder Sendung erneut auf.

Semantik beim Entfernen von Reaktionen: /tools/reactions.

Explizite Tags für Antwort-Threads in generierter Ausgabe:

• [[reply_to_current]] — antwortet auf die auslösende Nachricht
• [[reply_to:<id>]] — antwortet auf eine bestimmte Nachrichten-ID

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

Wenn Antwort-Threads aktiviert sind und der ursprüngliche Text bzw. die ursprüngliche Beschriftung verfügbar ist, fügt OpenClaw automatisch einen nativen Zitat-Auszug hinzu. Telegram begrenzt nativen Zitattext auf 1024 UTF-16-Codeeinheiten; bei längeren Nachrichten wird vom Anfang an zitiert und auf eine einfache Antwort zurückgegriffen, wenn Telegram das Zitat ablehnt.

off deaktiviert nur implizite Antwort-Threads; explizite [[reply_to_*]]-Tags werden weiterhin berücksichtigt.

Forum-Supergruppen: An Sitzungsschlüssel für Themen wird :topic:<threadId> angehängt; Antworten und Tippanzeigen richten sich an den Themen-Thread; der Konfigurationspfad für Themen lautet channels.telegram.groups.<chatId>.topics.<threadId>.

Das allgemeine Thema (threadId=1) ist ein Sonderfall: Beim Senden von Nachrichten wird message_thread_id weggelassen (Telegram lehnt sendMessage(...thread_id=1) mit „Thread nicht gefunden“ ab), Tippaktionen enthalten jedoch weiterhin message_thread_id (empirisch erforderlich, damit die Tippanzeige erscheint).

Themeneinträge erben Gruppeneinstellungen, sofern diese nicht überschrieben werden (requireMention, allowFrom, skills, systemPrompt, enabled, groupPolicy). agentId gilt nur für Themen und wird nicht von den Gruppenstandards geerbt. topics."*" legt Standards für jedes Thema in dieser Gruppe fest; exakte Themen-IDs haben weiterhin Vorrang vor "*".

Agent-Routing pro Thema: Jedes Thema kann über agentId in der Themenkonfiguration an einen anderen Agenten weitergeleitet werden und erhält dadurch einen eigenen Arbeitsbereich, Speicher und eine eigene Sitzung:

{  channels: {    telegram: {      groups: {        "-1001234567890": {          topics: {            "1": { agentId: "main" },      // Allgemeines Thema -> Hauptagent            "3": { agentId: "zu" },        // Entwicklungsthema -> Agent zu            "5": { agentId: "coder" }      // Code-Review -> Agent coder          }        }      }    }  }}

Jedes Thema verfügt dann über einen eigenen Sitzungsschlüssel, beispielsweise agent:zu:telegram:group:-1001234567890:topic:3.

Persistente ACP-Themenbindung: Forenthemen können ACP-Harness-Sitzungen über typisierte Bindungen auf oberster Ebene anheften (bindings[] mit type: "acp", match.channel: "telegram", peer.kind: "group" und einer themenspezifischen ID wie -1001234567890:topic:42). Derzeit auf Forenthemen in Gruppen/Supergruppen beschränkt. Siehe ACP-Agenten.

Thread-gebundener ACP-Start aus dem Chat: /acp spawn <agent> --thread here|auto bindet das aktuelle Thema an eine neue ACP-Sitzung; Folgenachrichten werden direkt dorthin weitergeleitet, und OpenClaw heftet die Startbestätigung im Thema an. Gesteuert durch session.threadBindings.spawnSessions (Standard: true).

Der Vorlagenkontext stellt MessageThreadId und IsForum bereit. Direktnachrichten-Chats mit message_thread_id behalten Antwortmetadaten bei, verwenden Thread-bezogene Sitzungsschlüssel jedoch nur, wenn Telegram getMe als has_topics_enabled: true meldet. Die außer Betrieb genommenen Überschreibungen dm.threadReplies und direct.*.threadReplies wurden entfernt; der Thread-Modus von BotFather ist die alleinige maßgebliche Quelle. Führen Sie openclaw doctor --fix aus, um veraltete Konfigurationsschlüssel zu entfernen.

Audionachrichten

Telegram unterscheidet Sprachnachrichten von Audiodateien. Standard: Verhalten einer Audiodatei; verwenden Sie im Agenten-Reply das Tag [[audio_as_voice]], um das Senden als Sprachnachricht zu erzwingen. Transkripte eingehender Sprachnachrichten werden im Agentenkontext als maschinell erzeugter, nicht vertrauenswürdiger Text gekennzeichnet, die Erwähnungserkennung verwendet jedoch weiterhin das Rohtranskript, damit durch Erwähnungen gesteuerte Sprachnachrichten weiterhin funktionieren.

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

Videonachrichten

Telegram unterscheidet Videodateien von Videonachrichten. Videonachrichten unterstützen keine Beschriftungen; bereitgestellter Nachrichtentext wird separat gesendet.

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

Standorte und Orte

Verwenden Sie die vorhandene Aktion send mit einem eigenständigen location-Objekt. Koordinaten senden eine native Markierung; wenn sowohl name als auch address hinzugefügt werden, wird eine native Ortskarte gesendet. Standortsendungen können nicht mit Nachrichtentext oder Medien kombiniert werden.

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

Sticker

Eingehend: Statisches WEBP wird heruntergeladen und verarbeitet (Platzhalter <media:sticker>); animiertes TGS und Video-WEBM werden übersprungen.

Sticker-Kontextfelder: Sticker.emoji, Sticker.setName, Sticker.fileId, Sticker.fileUniqueId, Sticker.cachedDescription. Beschreibungen werden im SQLite-Plugin-Status von OpenClaw zwischengespeichert, um wiederholte Vision-Aufrufe zu reduzieren.

Sticker-Aktionen aktivieren:

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

Senden:

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

Zwischengespeicherte Sticker durchsuchen:

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

Telegram-Reaktionen gehen als message_reaction-Updates getrennt von Nachrichten-Payloads ein. Wenn dies aktiviert ist, stellt OpenClaw Systemereignisse wie Telegram reaction added: 👍 by Alice (@alice) on msg 42 in die Warteschlange.

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

own bedeutet nur Benutzerreaktionen auf vom Bot gesendete Nachrichten (Best-Effort über einen Cache gesendeter Nachrichten). Reaktionsereignisse berücksichtigen weiterhin die Telegram-Zugriffskontrollen (dmPolicy, allowFrom, groupPolicy, groupAllowFrom); nicht autorisierte Absender werden verworfen.

Telegram stellt in Reaktionsupdates keine Thread-IDs bereit: Gruppen ohne Forum werden zur Gruppenchat-Sitzung weitergeleitet; Forum-Gruppen zur Sitzung des allgemeinen Themas (:topic:1), nicht zum exakten Ursprungsthema.

allowed_updates für Polling/Webhook schließt message_reaction automatisch ein.

ackReaction sendet ein Bestätigungs-Emoji, während OpenClaw eine eingehende Nachricht verarbeitet. messages.ackReactionScope bestimmt, wann es gesendet wird.

Reihenfolge der Emoji-Auflösung:

• channels.telegram.accounts.<accountId>.ackReaction
• channels.telegram.ackReaction
• messages.ackReaction
• Fallback auf das Emoji der Agentenidentität (agents.entries.*.identity.emoji, andernfalls „👀“)

Telegram erwartet ein Unicode-Emoji (zum Beispiel „👀“); verwenden Sie "", um die Reaktion für einen Kanal oder ein Konto zu deaktivieren.

Geltungsbereich (messages.ackReactionScope, Standard "group-mentions"; derzeit keine Überschreibung pro Telegram-Konto oder Telegram-Kanal):

all (Direktnachrichten + Gruppen, einschließlich Ereignissen in Umgebungsräumen), direct (nur Direktnachrichten), group-all (jede Gruppennachricht außer Ereignissen in Umgebungsräumen, keine Direktnachrichten), group-mentions (Gruppen, wenn der Bot erwähnt wird; keine Direktnachrichten — Standard), off / none (deaktiviert).

Schreibvorgänge an der Kanalkonfiguration sind standardmäßig aktiviert (configWrites !== false). Von Telegram ausgelöste Schreibvorgänge umfassen Gruppenmigrationsereignisse (migrate_to_chat_id, aktualisiert channels.telegram.groups) sowie /config set / /config unset (erfordert die Aktivierung von Befehlen).

Deaktivieren:

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

Standard ist Long Polling. Legen Sie für den Webhook-Modus channels.telegram.webhookUrl und channels.telegram.webhookSecret fest; optional webhookPath (Standard /telegram-webhook), webhookHost (Standard 127.0.0.1), webhookPort (Standard 8787), webhookCertPath (selbstsigniertes Zertifikat im PEM-Format für Einrichtungen mit direkter IP oder ohne Domain).

Im Long-Polling-Modus persistiert OpenClaw seine Neustart-Wassermarke erst, nachdem ein Update erfolgreich verarbeitet wurde; bei einem fehlgeschlagenen Handler kann dieses Update im selben Prozess erneut versucht werden, statt es als abgeschlossen zu markieren.

Der lokale Listener bindet sich standardmäßig an 127.0.0.1:8787. Stellen Sie für öffentlichen Eingang einen Reverse-Proxy vor den lokalen Port oder setzen Sie webhookHost: "0.0.0.0" bewusst.

Der Webhook-Modus validiert Anfrageschutzmechanismen, das geheime Telegram-Token und den JSON-Body und übergibt das Update anschließend an seine persistente Eingangswarteschlange, bevor eine leere 200-Antwort zurückgegeben wird. Eine erfolgreiche persistente Übernahme enthält x-openclaw-delivery-accepted: durable; Antworten für Integritätsprüfung, Routing, Authentifizierung, Validierung und Speicherfehler lassen diesen Header weg. Reverse-Proxys und Host-Controller können den Header voraussetzen, um die Übernahme durch OpenClaw von einer generischen leeren 200-Antwort zu unterscheiden, ohne die Annahme aus dem Antwortzeitpunkt abzuleiten.

Nach dem persistenten Schreibvorgang beansprucht und verarbeitet OpenClaw Updates über die zentrale Kanal-Eingangsverarbeitung (Lanes pro Chat/pro Thema, Abschluss bei Übernahme des Turns, Zeitüberschreitung bei Stillstand vor der Übernahme). Langsame Agenten-Turns halten die Telegram-Zustellbestätigung nicht auf.

• channels.telegram.textChunkLimit standardmäßig 4000; streaming.chunkMode="newline" bevorzugt Absatzgrenzen (Leerzeilen) vor der Aufteilung nach Länge.
• channels.telegram.mediaMaxMb (Standardwert 100) begrenzt die Größe eingehender und ausgehender Medien.
• Der Gruppen-Kontextverlauf verwendet channels.telegram.historyLimit oder messages.groupChat.historyLimit (Standardwert 50); 0 deaktiviert ihn.
• Zusätzlicher Kontext aus Antworten/Zitaten/Weiterleitungen wird in einem ausgewählten Konversationskontextfenster zusammengeführt, wenn das Gateway die übergeordneten Nachrichten erfasst hat; der Cache erfasster Nachrichten befindet sich im SQLite-Plugin-Status von OpenClaw, und openclaw doctor --fix importiert veraltete Sidecars. Telegram enthält pro Aktualisierung nur einen flachen reply_to_message, daher sind Ketten, die älter als der Cache sind, auf diese Nutzlast beschränkt.
• Telegram-Zulassungslisten steuern in erster Linie, wer den Agenten auslösen kann; sie bilden keine vollständige Schwärzungsgrenze für zusätzlichen Kontext.
• DM-Verlauf: channels.telegram.dmHistoryLimit, channels.telegram.dms["<user_id>"].historyLimit.

Sendeziele der CLI und des Nachrichten-Tools akzeptieren eine numerische Chat-ID, einen Benutzernamen oder ein Forenthemenziel:

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

Umfragen verwenden openclaw message poll und unterstützen Forenthemen:

openclaw message poll --channel telegram --target 123456789 \--poll-question "Ausliefern?" --poll-option "Ja" --poll-option "Nein"openclaw message poll --channel telegram --target -1001234567890:topic:42 \--poll-question "Zeit auswählen" --poll-option "10 Uhr" --poll-option "14 Uhr" \--poll-duration-seconds 300 --poll-public

Nur für Telegram verfügbare Umfrage-Flags: --poll-duration-seconds (5-600), --poll-anonymous, --poll-public, --thread-id (oder ein :topic:-Ziel). --poll-option wird 2-12 Mal wiederholt (Telegrams Begrenzung für Optionen).

Das Senden über Telegram unterstützt außerdem --presentation mit buttons-Blöcken für Inline-Tastaturen (wenn channels.telegram.capabilities.inlineButtons dies erlaubt), --pin oder --delivery '{"pin":true}', um eine angeheftete Zustellung anzufordern, sofern der Bot in diesem Chat Nachrichten anheften kann, sowie --force-document, um ausgehende Bilder, GIFs und Videos als Dokumente statt als komprimierte, animierte oder Video-Uploads zu senden.

Aktionssteuerung: channels.telegram.actions.sendMessage=false deaktiviert alle ausgehenden Nachrichten einschließlich Umfragen; channels.telegram.actions.poll=false deaktiviert die Erstellung von Umfragen, während reguläre Sendungen aktiviert bleiben.

Telegram unterstützt Ausführungsgenehmigungen in DMs der Genehmigenden und kann Aufforderungen optional im ursprünglichen Chat oder Thema veröffentlichen. Genehmigende müssen numerische Telegram-Benutzer-IDs besitzen.

• channels.telegram.execApprovals.enabled ("auto" aktiviert die Funktion, wenn mindestens eine genehmigende Person aufgelöst werden kann)
• channels.telegram.execApprovals.approvers (greift auf numerische Eigentümer-IDs aus commands.ownerAllowFrom zurück)
• channels.telegram.execApprovals.target: dm (Standardwert) | channel | both
• agentFilter, sessionFilter

channels.telegram.allowFrom, groupAllowFrom und defaultTo steuern, wer mit dem Bot kommunizieren kann und wohin er normale Antworten sendet – sie machen eine Person nicht zu einer genehmigenden Person für Ausführungen. Die erste genehmigte DM-Kopplung initialisiert commands.ownerAllowFrom, wenn noch kein Befehlseigentümer vorhanden ist, sodass Konfigurationen mit einem Eigentümer funktionieren, ohne IDs unter execApprovals.approvers zu duplizieren.

Bei der Zustellung im Kanal wird der Befehlstext im Chat angezeigt; aktivieren Sie channel oder both nur in vertrauenswürdigen Gruppen/Themen. Wenn die Aufforderung in einem Forenthema eingeht, behält OpenClaw das Thema für die Genehmigungsaufforderung und die nachfolgende Nachricht bei. Ausführungsgenehmigungen laufen standardmäßig nach 30 Minuten ab.

Inline-Genehmigungsschaltflächen erfordern außerdem, dass channels.telegram.capabilities.inlineButtons die Zieloberfläche zulässt (dm, group oder all). Genehmigungs-IDs mit dem Präfix plugin: werden über Plugin-Genehmigungen aufgelöst; andere werden zuerst über Ausführungsgenehmigungen aufgelöst.

Siehe Ausführungsgenehmigungen.

• Wenn requireMention=false, muss der Datenschutzmodus von Telegram vollständige Sichtbarkeit erlauben: BotFather /setprivacy -> Disable, entfernen Sie den Bot anschließend aus der Gruppe und fügen Sie ihn erneut hinzu.
• openclaw channels status warnt, wenn die Konfiguration Gruppennachrichten ohne Erwähnung erwartet.
• openclaw channels status --probe prüft explizite numerische Gruppen-IDs; beim Platzhalter "*" kann die Mitgliedschaft nicht geprüft werden.
• Schneller Sitzungstest: /activation always.

• Wenn channels.telegram.groups vorhanden ist, muss die Gruppe aufgeführt sein (oder "*" enthalten).
• Überprüfen Sie die Mitgliedschaft des Bots in der Gruppe.
• Prüfen Sie openclaw logs --follow auf Gründe für das Überspringen.

• Autorisieren Sie Ihre Absenderidentität (Kopplung und/oder numerische allowFrom); die Befehlsautorisierung gilt auch dann, wenn die Gruppenrichtlinie open lautet.
• setMyCommands failed mit BOT_COMMANDS_TOO_MUCH bedeutet, dass das native Menü zu viele Einträge enthält; reduzieren Sie Plugin-/Skill-/benutzerdefinierte Befehle oder deaktivieren Sie native Menüs.
• Die Startaufrufe deleteMyCommands / setMyCommands und die Tippstatusaufrufe sendChatAction sind zeitlich begrenzt und werden bei einer Anfragezeitüberschreitung einmal über Telegrams Transport-Fallback wiederholt. Dauerhafte Netzwerk-/Abruffehler bedeuten üblicherweise, dass DNS/HTTPS zu api.telegram.org nicht erreichbar ist.

• getMe returned 401 ist ein Telegram-Authentifizierungsfehler für das konfigurierte Bot-Token. Kopieren Sie das Token erneut oder generieren Sie es in BotFather neu und aktualisieren Sie anschließend channels.telegram.botToken, tokenFile, accounts.<id>.botToken oder TELEGRAM_BOT_TOKEN (Standardkonto).
• deleteWebhook 401 Unauthorized während des Starts ist ebenfalls ein Authentifizierungsfehler; die Behandlung als „kein Webhook vorhanden“ würde denselben Fehler aufgrund eines ungültigen Tokens lediglich bis zu einem späteren API-Aufruf verzögern.

• Node 22+ mit einer benutzerdefinierten Fetch-/Proxy-Konfiguration kann sofortiges Abbruchverhalten auslösen, wenn die Typen von AbortSignal nicht übereinstimmen.
• Einige Hosts lösen api.telegram.org zuerst zu IPv6 auf; ein fehlerhafter ausgehender IPv6-Zugriff verursacht sporadische API-Fehler.
• Protokolleinträge mit TypeError: fetch failed oder Network request for 'getUpdates' failed! werden als behebbare Netzwerkfehler erneut versucht.
• Beim Polling-Start verwendet OpenClaw die erfolgreiche anfängliche getMe-Prüfung für grammY erneut, sodass der Runner vor dem ersten getUpdates keinen zweiten getMe benötigt.
• Wenn deleteWebhook beim Polling-Start aufgrund eines vorübergehenden Netzwerkfehlers fehlschlägt, fährt OpenClaw mit Long Polling fort, statt einen weiteren Kontrollaufruf vor dem Polling auszuführen. Ein noch aktiver Webhook wird dann als getUpdates-Konflikt sichtbar; OpenClaw erstellt den Transport neu und versucht die Webhook-Bereinigung erneut.
• Polling stall detected in den Protokollen bedeutet, dass OpenClaw das Polling neu startet und den Transport neu erstellt, nachdem standardmäßig 120 Sekunden lang keine abgeschlossene Long-Poll-Aktivität festgestellt wurde.
• openclaw channels status --probe und openclaw doctor warnen, wenn ein aktives Polling-Konto nach der Starttoleranzzeit getUpdates noch nicht abgeschlossen hat, ein aktives Webhook-Konto nach der Starttoleranzzeit setWebhook noch nicht abgeschlossen hat oder die letzte erfolgreiche Polling-Transportaktivität veraltet ist.
• Telegram berücksichtigt die Proxy-Umgebungsvariablen des Prozesses für den Bot-API-Transport: HTTP_PROXY, HTTPS_PROXY, ALL_PROXY sowie Varianten in Kleinbuchstaben. NO_PROXY / no_proxy können api.telegram.org weiterhin umgehen.
• Wenn OPENCLAW_PROXY_URL für eine Dienstumgebung festgelegt ist und keine standardmäßige Proxy-Umgebungsvariable vorhanden ist, verwendet Telegram diese URL ebenfalls für den Bot-API-Transport.
• Leiten Sie auf VPS-Hosts mit instabilem direkten ausgehenden Zugriff/TLS Telegram-API-Aufrufe über einen Proxy:

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

• Node 22+ verwendet standardmäßig autoSelectFamily=true (außer unter WSL2). Die Reihenfolge der Telegram-DNS-Ergebnisse berücksichtigt OPENCLAW_TELEGRAM_DNS_RESULT_ORDER, dann channels.telegram.network.dnsResultOrder und anschließend den Prozessstandard (beispielsweise NODE_OPTIONS=--dns-result-order=ipv4first); wenn keine Einstellung greift, wird unter Node 22+ auf ipv4first zurückgegriffen.
• Erzwingen Sie unter WSL2 oder wenn reines IPv4-Verhalten besser funktioniert die Auswahl der Adressfamilie:

channels:telegram:network:  autoSelectFamily: false

• Antworten aus dem RFC-2544-Benchmarkbereich (198.18.0.0/15) sind für Telegram-Mediendownloads bereits standardmäßig zulässig. Wenn ein vertrauenswürdiger Fake-IP- oder transparenter Proxy api.telegram.org bei Mediendownloads in eine andere private/interne/für besondere Zwecke reservierte Adresse umschreibt, aktivieren Sie die ausschließlich für Telegram vorgesehene Umgehung:

channels:telegram:network:  dangerouslyAllowPrivateNetwork: true

• Dieselbe Aktivierung ist pro Konto unter channels.telegram.accounts.<accountId>.network.dangerouslyAllowPrivateNetwork verfügbar.
• Wenn Ihr Proxy Telegram-Medienhosts in 198.18.x.x auflöst, lassen Sie das gefährliche Flag zunächst deaktiviert – dieser Bereich ist bereits standardmäßig zulässig.

• Temporäre Umgebungsüberschreibungen: OPENCLAW_TELEGRAM_DISABLE_AUTO_SELECT_FAMILY=1, OPENCLAW_TELEGRAM_ENABLE_AUTO_SELECT_FAMILY=1, OPENCLAW_TELEGRAM_DNS_RESULT_ORDER=ipv4first.
• DNS-Antworten überprüfen:

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