2026 OpenClaw Telegram: Long Polling vs. Webhook auf physischem Fern-Mac—HTTPS-Reverse-Proxy, Registrierung & 409/TLS-Timeout-Runbook (openclaw.json + FAQ)

2. Schmerzpunkte

1. Öffentliches HTTPS für Webhooks unterschätzen. Telegram erwartet eine verifizierbare Kette und einen erreichbaren HTTPS-Endpunkt (üblich Port 443). Selbstsignierte Zertifikate, fehlende Zwischenzertifikate oder DNS nur im LAN führen zu TLS-Fehlern oder stillem Nicht-Zustellen.
2. HTTP 409 ist kein Zufallsrauschen. Staging und Produktion teilen ein Bot-Token, oder ein alter Knoten ruft nie deleteWebhook auf—setWebhook-Konflikte entstehen aus Registrierungszustand, nicht aus OpenClaw-Fachlogik.
3. Long Polling ist nicht kostenlos. Grenzüberschreitende RTT und lange Verbindungen verstärken Jitter; Provider drosseln ggf. Für PoC brauchbar; Produktion kehrt meist zu Webhook plus gesunder Edge zurück.

3. Entscheidungsmatrix: Long Polling vs. Webhook

Leichte „Architektur-Freigabe“ für ZoneMac-Fernknoten.

4. openclaw.json-Fragmente (illustrativ)

Nur Strukturbeispiel—Schlüsselnamen und Verschachtelung müssen zur OpenClaw-Version passen. Produktionsdateien sichern und mit bestehenden gateway- und Credential-Abschnitten manuell mergen.

4.1 Telegram-Kanal: Webhook + lokaler Listener

{
  "channels": {
    "telegram": {
      "enabled": true,
      "botTokenRef": "env:TELEGRAM_BOT_TOKEN",
      "transport": "webhook",
      "webhook": {
        "publicUrl": "https://bot.example.com/openclaw/telegram/webhook",
        "path": "/openclaw/telegram/webhook",
        "secretTokenRef": "env:TELEGRAM_WEBHOOK_SECRET",
        "maxConnections": 40,
        "dropPendingUpdates": false
      },
      "localServer": {
        "bind": "127.0.0.1",
        "port": 18789,
        "readTimeoutSeconds": 30,
        "writeTimeoutSeconds": 30
      }
    }
  },
  "gateway": {
    "reverseProxy": {
      "trustedProxies": ["10.0.0.0/8"],
      "forwardedHeaders": ["X-Forwarded-For", "X-Forwarded-Proto"]
    }
  }
}

Für Long Polling transport auf "longPolling" (oder Release-Äquivalent) setzen und getUpdates-Optionen wie timeout / allowed_updates angeben; sicherstellen, dass Telegram keinen Webhook mehr auf eine alte URL zeigt.

4.2 Reverse Proxy (Caddy-Skizze)

# TLS an der Kante; Proxy auf 127.0.0.1:18789 auf dem Mac.
# Host/Pfad-Konsistenz mit OpenClaw; Body-Limits nach Gateway-Vorgabe.

bot.example.com {
  reverse_proxy 127.0.0.1:18789 {
    header_up X-Forwarded-Proto {scheme}
    header_up X-Forwarded-For {remote_host}
  }
}

5. Sieben-Schritte-Runbook (physischer Fern-Mac)

1. Transportmodus einfrieren. Nur ein aktiver Pfad. Beim Wechsel von Long Polling zu Webhook zuerst Polling stoppen, um Doppelzustellung zu vermeiden.
2. TLS Ende-zu-Ende prüfen. Vom Internet Port 443 testen: volle Kette, korrektes SNI, Firewall für Telegram-Quellbereiche (aktuell laut Telegram-Doku).
3. openclaw.json mergen. cp openclaw.json openclaw.json.bak.$(date +%Y%m%d%H%M); publicUrl, Secret-Referenzen und lokales Bind setzen.
4. Alten Webhook bereinigen. getWebhookInfo → bei falscher URL deleteWebhook → setWebhook von einer Stelle, um 409 zu reduzieren.
5. Neu laden und Prozess prüfen. Reload nach Ihrer Verteilung; Listen-Port und launchd-Logs auf Crash-Schleifen prüfen.
6. Positive und negative Tests. Testnachricht senden; falsches secret_token soll schnell scheitern; pending_update_count beobachten.
7. Archivieren. Domain, Zert-Inhaber, setWebhook-Parameter und Rollback auf Long Polling festhalten.

6. 409- & TLS-Timeout-Triage

7. Zitierfähige Kennzahlen & Checkliste

• getUpdates Long Poll: timeout typischerweise 0–50 Sekunden laut Bot-API; bei hoher RTT konservativ starten.
• Lokales HTTP: Beispiel 127.0.0.1:18789 bleibt auf Loopback; der Proxy besitzt TLS und die öffentliche Fläche—passt zu SSH-first ZoneMac-Knoten.
• Webhook-Parallelität: maxConnections mit Gateway-Workern und Upstream-Modell-QPS verzahnen, damit der Ingress nicht schneller annimmt als der Kern verarbeitet.

8. FAQ

9. Fazit & warum Mac mini zu diesem Stack passt

Long Polling vs. Webhook ist keine Frage nach „moderner“—sondern ob Sie produktionsreifes HTTPS und eine einzige Registrierungs-Quelle der Wahrheit akzeptieren. Webhooks verlagern Observability nach getWebhookInfo; Long Polling hält Komplexität in ausgehenden Pfaden und Prozess-Betreuung.

Auf einem physischen ZoneMac-Fern-Mac verbindet ein Mac mini M4-Knoten geringe Leerlaufleistung (Größenordnung wenige Watt), Unix-native Dienste und launchd-taugliche Daemons—dieselbe Maschine kann Reverse Proxy und OpenClaw hosten, ideal für unbeaufsichtigte Gateways. macOS-Härtung (Gatekeeper, SIP, FileVault) reduziert Langzeit-Risiko gegenüber typischen Windows-Hilfs-Hosts.

Wenn Sie Telegram-Ingress, TLS und OpenClaw auf leiser, planbarer Hardware betreiben wollen, ist der Mac mini M4 ein starkes Preis-Stabilitäts-Einstiegsangebot—holen Sie sich einen physischen Fern-Mac über ZoneMac und probieren Sie dieses Runbook auf echter Hardware.