OpenClaw-Telegram-Einrichtung

Ein Telegram-Bot ist der Kanal, der sich am schnellsten einrichten lässt, denn die gesamte Einrichtung besteht aus einem Token von BotFather und einem Befehl, der es speichert. Hier finden Sie die Schnelleinrichtung Schritt für Schritt, die Regeln zur Token-Rangfolge, die Einstellungen, die auf der Seite von Telegram statt in der Konfiguration liegen, und die Transportwahl zwischen Long Polling und einem Webhook.

Schnelleinrichtung

• Beide BotFather-Abläufe enden mit einem Token, das Sie in OpenClaw einfügen: der Chat-Ablauf, bei dem Sie mit dem BotFather-Konto schreiben, prüfen, dass der Handle exakt stimmt, den Befehl für einen neuen Bot ausführen und das Token speichern, oder der Web-Ablauf in der Web-App von BotFather, die in jedem Telegram-Client läuft und in der Sie den Bot über eine Oberfläche erstellen und sein Token kopieren können.
• Am schnellsten konfigurieren Sie ihn mit dem Befehl channels add mit dem Telegram-Kanal und dem Token, der das Token für Sie in die Konfiguration schreibt; wer stattdessen von Hand bearbeitet, braucht einen Telegram-Block mit aktiviertem Kanal, dem Bot-Token, der DM-Richtlinie für Kopplung und einem Wildcard-Gruppeneintrag, der eine Erwähnung verlangt, und die Umgebungsvariable für das Bot-Token ist nur ein Fallback für das Standardkonto, da benannte Konten den Token-Schlüssel oder eine Token-Datei verwenden müssen.
• Mit dem standardmäßigen Hot Reload übernimmt das laufende Gateway die neue Kanalkonfiguration, und die Statusprüfung der Kanäle kontrolliert, ob Telegram bereit ist; ist das Gateway offline, starten Sie es als verwalteten Dienst oder im Terminal, und eine geänderte Dienstumgebung braucht einen Neustart, um geladen zu werden.
• Jede Nachricht an den Bot erzeugt die Kopplungsanfrage, die der Befehl zum Auflisten der Kopplungen anzeigt und der Freigabebefehl annimmt, mit Codes, die nach einer Stunde verfallen; um den Bot dann einer Gruppe hinzuzufügen, brauchen Sie Ihre numerische Nutzer-ID für die Zulassungslisten und die Gruppen-Chat-ID als Schlüssel in der groups-Map, abzulesen aus den Logs, über einen Bot für weitergeleitete IDs oder aus den Updates der Bot API, bestätigt mit dem Befehl whoami, sobald die Gruppe erlaubt ist, und negative Supergruppen-IDs gehören unter groups, nie in die Liste der Gruppenabsender.

Telegram verwendet nicht openclaw channels login telegram.

Tokens und die Telegram-Seite

Die Token-Auflösung ist kontobewusst: Eine Token-Datei schlägt den Bot-Token-Schlüssel, der Bot-Token-Schlüssel schlägt die Umgebung, die Konfiguration gewinnt immer gegen die Umgebungsvariable, die nur für das Standardkonto aufgelöst wird, und nach einem erfolgreichen Start speichert OpenClaw die Bot-Identität bis zu 24 Stunden im Cache, damit Neustarts einen zusätzlichen getMe-Aufruf sparen, wobei ein geändertes oder entferntes Token diesen Cache leert. Auf der Seite von Telegram sind Bots standardmäßig im Privacy-Modus, der einschränkt, welche Gruppennachrichten sie empfangen; um alle Gruppennachrichten zu sehen, deaktivieren Sie entweder den Privacy-Modus mit dem Befehl set-privacy oder machen den Bot zum Gruppen-Admin, und nach dem Umschalten des Privacy-Modus entfernen Sie den Bot aus jeder Gruppe und fügen ihn erneut hinzu, damit Telegram die Änderung übernimmt. Der Admin-Status wird in den Gruppeneinstellungen gesteuert, und Admin-Bots empfangen alle Gruppennachrichten, was zu einem dauerhaft aktiven Gruppenverhalten passt. Die nützlichen BotFather-Schalter sind die Einstellung join-groups, die das Hinzufügen zu Gruppen erlaubt oder verbietet, und die Privacy-Einstellung für die Sichtbarkeit in Gruppen, beide auch in der Web-App von BotFather verfügbar.

Long Polling oder Webhook

• Long Polling ist der Standard; der Webhook-Modus braucht eine Webhook-URL und ein Webhook-Secret, mit einem optionalen Pfad, der standardmäßig die Route telegram-webhook ist, einem Host, der standardmäßig Loopback ist, einem Port, der standardmäßig 8787 ist, und einem Zertifikatspfad für ein selbst signiertes PEM bei Setups mit direkter IP oder ohne Domain; der Listener reserviert die Health-Route für Health-Checks, daher muss der Webhook-Pfad eine andere Route verwenden, und ein bestehendes Setup auf dieser Route muss umziehen, die URL und die Zuordnung im Reverse Proxy aktualisieren und die Listener-Änderung mit der Statusprüfung verifizieren.
• Im Long-Polling-Modus speichert OpenClaw seine Neustartposition, nachdem ein Update in die dauerhafte Ingress-Warteschlange übernommen wurde, sodass ein fehlgeschlagener Handler aus dieser Warteschlange erneut versucht werden kann; der lokale Listener bindet standardmäßig an Loopback auf Port 8787, und öffentlicher Ingress bedeutet einen vorgeschalteten Reverse Proxy oder einen bewusst gesetzten Wildcard-Host.
• Der Webhook-Modus validiert die Request-Guards, das Telegram-Secret-Token und den JSON-Body, übernimmt das Update in die dauerhafte Warteschlange, bevor er ein leeres 200 zurückgibt, und kennzeichnet eine erfolgreiche dauerhafte Übernahme mit einem Header für angenommene Zustellung, den Antworten zu Health, Routing, Authentifizierung, Validierung und Speicherfehlern weglassen, sodass ein Reverse Proxy ihn verlangen kann, statt die Annahme aus dem Timing abzuleiten; nach dem dauerhaften Schreiben werden Updates über den zentralen Ingress-Drain mit Lanes pro Chat und pro Thema beansprucht und verarbeitet, und langsame Agenten-Turns halten die Zustellbestätigung von Telegram nie auf.

OpenClaw auf Telegram ist der Kanal-Beitrag, zu dem diese Einrichtung gehört, und die Telegram-Zugriffskontrolle in OpenClaw behandelt, was Sie als Nächstes darüber entscheiden, wer den Bot erreichen darf.

Wo Einrichtungen scheitern

Fast jede gescheiterte Telegram-Einrichtung geht auf eines von drei Dingen zurück: ein Token für ein benanntes Konto, das über die Umgebungsvariable eingefügt wurde, die nur das Standardkonto bedient, eine Gruppen-ID in der Absenderliste statt in der groups-Map oder ein eingeschalteter Privacy-Modus bei abgeschalteter Erwähnungspflicht. Die Telegram-Fehlerbehebung für OpenClaw geht diese Symptome der Reihe nach durch, und die Fünf-Minuten-Anleitung zum Verbinden Ihres ersten Kanals führt Sie durch einen ersten Kanal.

Bei Diali

Bei Diali wird der Telegram-Kanal über das Dashboard verbunden, und die Laufzeitkonfiguration wird daraus erzeugt und bei jedem Release ersetzt, sodass die BotFather-Schritte am Anfang dieses Beitrags der Teil sind, der auf Ihrer Seite bleibt. Telegram bei Diali beschreibt den Kanal bei Diali und die Diali-Sicherheitsseite die Grenze, die sich alle verbundenen Kanäle teilen.

• Ein Token von BotFather; die CLI schreibt es für Sie.
• Kopplungscodes verfallen nach einer Stunde; Gruppen-IDs gehören unter groups.
• Standardmäßig Long Polling; Webhooks brauchen ein Secret und eine freie Route.