Telegram

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

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

• 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

{
  "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-Sicherung" },
        { command: "generate", description: "Ein Bild erstellen" },
      ],
    },
  },
}

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

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

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

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

​

Audionachrichten

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

​

Videonachrichten

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

​

Standorte und Orte

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

​

Sticker

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

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

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

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

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

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

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"

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

• 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

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