NanoClaw-Telegram antwortet nicht: Polling, Berechtigungen und Laufzeitprüfungen

Wenn ein NanoClaw-Telegram-Bot nicht mehr antwortet, ist der erste Schritt keine Reparatur — sondern die Feststellung, ob eingehende Nachrichten den Host überhaupt erreichen, denn zwei separat gemeldete NanoClaw-Fehler erzeugen diese Beschwerde mit gegensätzlichen Mustern. Im einen Fall fallen eingehende Nachrichten aus, während ausgehende Zustellung und geplante Aufgaben weiterhin funktionieren, sodass jede vom Betreiber geprüfte Oberfläche gesund aussieht. Im anderen Fall wird ebenfalls nichts gesendet, und das Protokoll markiert Nachrichten als zugestellt, die nie gesendet wurden. Gleiche Beschwerde, unterschiedliche Ursachen; eine Abhilfe für den einen Fall bewirkt beim anderen nichts.

Eine Klarstellung vor allem anderen, da sich die Suchergebnisse zu diesem Begriff überwiegend auf ein anderes Produkt beziehen. OpenClaw ist ein separates und deutlich größeres Projekt – 390.207 Sterne und eine NOASSERTION-Lizenz, als sein Repository-API-Eintrag am 21. September 2026 abgerufen wurde – und die Startseite von NanoClaw grenzt sich davon ab. NanoClaw ist nanocoai/nanoclaw: MIT-lizenziert, nicht archiviert, kein Fork, 30.818 Sterne, 1.068 offene Issues, zuletzt am 19. September 2026 gepusht (GitHub API, am selben Datum). Die ältere qwibitai/nanoclaw-Adresse leitet per 301 dorthin weiter; es handelt sich also um dasselbe umbenannte Projekt und nicht um ein zweites. Die beiden Projekte teilen keinen Telegram-Codepfad – NanoClaw installiert seinen eigenen Adapter, indem es Quellcode aus seinem channels-Branch kopiert (add-telegram-Skill) –, daher lässt sich eine OpenClaw-Lösung nicht übertragen. Den vollständigen Unterschied finden Sie unter NanoClaw vs OpenClaw.

Lesen Sie die Signatur, bevor Sie irgendetwas anfassen

Jede nachfolgende Zeile beschreibt einen eigenständigen, separat gemeldeten Fehler mit einer eigenen bestätigenden Prüfung. Alle acht wurden am 21. September 2026 aus NanoClaws eigenem Issue-Tracker, den ausgelieferten Skills und der Kanaldokumentation entnommen.

NanoClaws offizielle Erstdiagnose umfasst zwei Logdateien sowie ncl sessions list, ncl dropped-messages list und ncl wirings list. Keine veröffentlichte Version enthält einen Befehl zur Kanal-Liveness, daher stützt sich die folgende Triage stattdessen auf die Logzeilen.

# 1. Is inbound polling failing, and for how long?
#    A rising consecutiveFailures count is the #3728 signature.
grep "Telegram polling request failed" logs/nanoclaw.error.log | tail -5

# 2. Did the Telegram adapter ever register this boot?
#    Its ABSENCE is the duplicate-host signature, not an error line.
grep "Channel adapter started" logs/nanoclaw.log | tail -10

# 3. Is a second host holding the polling session?
ps aux | grep 'nanoclaw/dist/index.js' | grep -v grep
systemctl --user list-units 'nanoclaw*' --all   # Linux systemd installs

Warum alles gesund aussieht, obwohl der Eingang tot ist

Das ist strukturell bedingt und kostet am meisten Zeit. NanoClaws README beschreibt den Pfad als Messaging-App zum Host-Router, dann in eine eingehende Datenbank, in den Container, in eine ausgehende Datenbank und zurück über die Zustellung. Die Zustellung fragt die ausgehende Datenbank selbstständig ab, und ein 60-Sekunden-Host-Durchlauf weckt fällige und wiederkehrende Nachrichten unabhängig davon. Nur der Eingang hängt vom Telegram-Poller ab – genau deshalb konnte der Melder von Issue #3728 beobachten, dass der Host aktiv blieb, die ausgehende Zustellung weiter funktionierte und geplante Aufgaben über etwa vier Tage völliger Eingangsstille weiter ausgeführt wurden, während 11.178 aufeinanderfolgende Fehler aufgezeichnet wurden.

Der Gesundheits-Hook, der dies hätte erkennen sollen, tut es nicht. NanoClaws veröffentlichte Referenz zur Adapter-Schnittstelle sagt über isConnected(), dass es "not currently called by the host outside tests" ist und dass "the bridge always returns true". Der Trunk hat sich inzwischen weiterentwickelt: Ein ncl status-Befehl, der ein verbunden-Flag pro Adapter meldet, wurde am 15. September 2026 in main aufgenommen, nach der Veröffentlichung von v2.3.0. Damit ist die Dokumentation für jede veröffentlichte Version korrekt, für den Trunk jedoch veraltet. Behandeln Sie diesen Befehl als unveröffentlichte interne Funktion und nicht als Anleitung – er ist verborgen und nur für den Host registriert und erscheint in keiner Dokumentation. Bei Telegram treffen die beiden Wege ohnehin zusammen: Weder die Version 4.29.0 noch 4.41.0 des Adapters implementiert isConnected überhaupt (beide dist-Builds wurden für diese Seite durchsucht), daher fällt die Prüfung in beiden Fällen auf true zurück.

Auch die Dokumentation weist eine entsprechende Lücke auf. Die Fehlerbehebungsseite enthält einen Abschnitt mit der Überschrift "Webhook channel is silent", aber kein Pendant für Polling. Der Ablauf unter "Agent never replies" beginnt mit "Did the router accept it?" und ncl dropped-messages list – ein Schritt, der bereits voraussetzt, dass die Nachricht den Host erreicht hat. Wenn der Poller tot ist, gibt es keine Zeilen für verworfene Nachrichten zu finden, weil der Router die Nachricht nie gesehen hat. Issue #2989 dokumentiert für seine eigene Ursache dieselbe Sackgasse: keine Logzeilen, keine Zeilen für verworfene Nachrichten, nichts, von dem aus sich debuggen ließe.

Es gibt keine Fix-Version, planen Sie daher entsprechend

Issue #3728 ist offen, mit null Kommentaren, null Labels und keinem Meilenstein; sein Aktualisierungszeitstempel entspricht weiterhin dem Erstellungszeitstempel vom 6. September 2026. Die neueste Version ist v2.3.0 vom 24. August 2026, und der einzige Commit im channels-Branch seit dem 1. September ist eine Mattermost-Korrektur. Dasselbe gilt für den veralteten Filterfall: Der Pull Request, der eine explizite Update-Liste festschreiben würde, ist seit dem 22. August 2026 gegen channels offen, und der Quellcode des aktuellen Branches enthält überhaupt kein Vorkommen von allowedUpdates. Die Einzelinstanz-Sperre für den Host, die den Fall mit dem doppelten Host verhindert hätte, wurde ohne Merge geschlossen. Die ehrliche Einordnung lautet daher: Abhilfe, nicht Versionsnummer.

Drei Dinge sollten Sie wissen, bevor Sie einen eigenen Patch schreiben. Erstens: Eine lokale Änderung an src/channels/telegram.ts bleibt nicht erhalten: Der add-telegram-Skill kopiert diese Datei aus dem Channels-Branch ein, mit der Anweisung, sie zu überschreiben, weil der Branch maßgeblich ist; der Update-Skill aktualisiert jeden installierten Kanal – genau so verlor der Melder von #3728 seine Korrektur bei jedem Update. Zweitens ist der Watchdog des Melders ebenso sehr eine Warnung wie ein Rezept: Die erste, nur auf einem Zähler basierende Version verursachte einen schlimmeren dreitägigen Ausfall, weil der Poller schließlich gestoppt war statt fehlzuschlagen; dadurch wurden keine weiteren Fehler protokolliert und der Zähler erreichte nie seinen Schwellenwert. Die zweite Version verwendete zwei unabhängige Signale und ließ den Poller nie gestoppt. Nichts davon ist ausgeliefert, empfohlen oder unabhängig verifiziert. Drittens: Was auch immer Sie bauen, testen Sie die Wiederherstellung in beide Richtungen: Ausgehender Erfolg beweist nichts über den Eingang; entscheidend ist daher eine neue Nachricht aus dem gepaarten Chat, die eine neue eingehende Zeile erzeugt.

Ein Fehler im Telegram-Kanal ist kein Modell- oder API-Problem

Das sollte klar ausgesprochen werden, weil die naheliegende nächste Suche in die falsche Richtung führt. NanoClaws Dokumentation zu Zugangsdaten sagt, dass Kanal-Token wie TELEGRAM_BOT_TOKEN in .env verbleiben und vom Host-Prozess, nicht von den Containern, verwendet werden, während Modellzugangsdaten im Vault liegen und während der Anfrage in ausgehende Anfragen injiziert werden. Eingehende Nachrichten erreichen den Router und die eingehende Datenbank der Sitzung, bevor ein Provider ausgewählt wird, da der Provider beim Starten des Containers aufgelöst wird (Dokumentation zu Agent-Providern). Keine Basis-URL, kein Schlüssel, Gateway oder Providerwechsel behebt eine tote Polling-Schleife, einen veralteten Update-Filter, eine Poller-Kollision, den Gruppendatenschutz oder eine defekte IPv6-Route.

Der echte Zusammenhang läuft in die andere Richtung. NanoClaws README führt Claude Code ausdrücklich als Voraussetzung für /customize, /debug und jeden /add-channel-Skill auf. Für die Reparatur eines Kanals muss es also auf dem Host vorhanden sein, selbst wenn Ihre Agentengruppen auf etwas anderem laufen. Die Host-Voraussetzungen sind macOS oder Linux, Windows über WSL2, Node.js 22 oder neuer, pnpm 10 oder neuer und Docker – und beachten Sie, dass nanoclaw.dev weiterhin Node.js 20 oder neuer bewirbt, während README und der Changelog zu v2.3.0 die Version 22 als harte Untergrenze festlegen. Orientieren Sie sich am Changelog, der die Anhebung als Breaking Change bezeichnet.

Was NanoClaw und sein Telegram-Kanal tatsächlich kosten

Es gibt keinen kostenpflichtigen Tarif, mit dem Sie sich aus einem nicht reagierenden Bot herauskaufen können – das ist die nützliche Aussage dieser Tabelle. Kosten entstehen erst, wenn der Kanal wieder funktioniert und der Agent antwortet. Die folgenden Zahlen sind beispielhafte Tokenrechnung, keine gemessenen Aufgabenkosten und keine Abrechnungsobergrenze: angenommen wird ein gepaarter Chat mit 25 Durchläufen pro Tag, 20.000 nicht aus dem Cache stammenden Eingabe- und 900 Ausgabetoken pro Durchlauf über 30 Tage. Die Preise stammen live aus dem Kunavo-Katalog und gelten pro Million Token.

Skalieren Sie dies anhand Ihres eigenen Datenverkehrs, bevor Sie es als Budget betrachten, und beachten Sie die Annahme mit dem größten Einfluss: Nichts wird aus dem Cache bereitgestellt. Eine langlebige Agentensitzung sendet den Kontext erneut, daher verändert das Cache-Verhalten diese Zahl stärker als der Tokenpreisunterschied zwischen zwei benachbarten Modellen. Der Katalogbetrag von Kunavo ist eine Abrechnungsuntergrenze und keine Obergrenze – wenn der Upstream seine Kosten meldet, entspricht die Rechnung dem höheren Wert aus Katalogkosten und Upstream-Kosten multipliziert mit dem anwendbaren Aufschlag. Die minimale Aufladung beträgt $10 als Prepaid-Guthaben, eine Mindestfinanzierung und keine Aufgaben- oder Abonnementgebühr; siehe Abrechnungsdetails.

Keine dieser vier Optionen berührt den Telegram-Pfad. Die vollständige Provider-Seite – die zwei Setup-gelesenen Umgebungsvariablen, was der Container tatsächlich sieht und wo OpenCode und Codex einzuordnen sind – finden Sie unter NanoClaw API-Kosten und Provider. Wenn Sie die standardmäßige Claude-Laufzeit mit einem benutzerdefinierten Endpunkt verbinden, behandeln der Integrationsleitfaden für Claude Code und die Referenz zur Basis-URL die Konfiguration; ein Kunavo-Konto können Sie erstellen, sobald Sie einen Schlüssel aufladen möchten. Kunavo hat NanoClaw nicht zur Laufzeit getestet, und ein veröffentlichter Setup-Leitfaden ist eine Konfigurationsreferenz, kein Kompatibilitätstest.

Häufig gestellte Fragen

Geprüft am 21. September 2026: der Repository-Eintrag und die Release-Liste von nanocoai/nanoclaw, die offenen/geschlossenen Zustände der Issues #2377, #2989, #3162, #3569 und #3728 sowie der Pull Requests #2225, #2697, #3449, #3460 und #3570, der Telegram-Adapter-Quellcode des Channels-Branches, sowohl der festgeschriebene Adapter-Build 4.29.0 als auch der aktuelle Build 4.41.0 aus npm, NanoClaws Kanal-, Zugangsdaten-, Fehlerbehebungs- und Adapter-Schnittstellendokumentation, seine add-telegram- und debug-Skills sowie die Bot-API-Seite von Telegram. Nichts auf dieser Seite wurde gegen eine laufende NanoClaw-Installation ausgeführt. Die Kunavo-Tokenpreise stammen aus dem Live-Katalog, und die Dollarbeträge sind beispielhafte Tokenrechnung.