Dans les supergroupes Telegram avec sujets de forum, la présence de MessageThreadId oriente les transcripts OpenClaw ; Heartbeat et sorties d’outils glissent vite vers la discussion racine. Ce guide (v2026.4.14, contexte 4.x) couvre les douleurs, une matrice, un tableau symptômes/logs/correctifs, les différences webhook / long polling, huit étapes reproductibles, des repères chiffrés et une liste d’acceptation VNC.
1) Points de friction
- Identifiants de fil manquants : transferts ou clients spécifiques retirent
message_thread_id; la même personne se retrouve sur deux chemins. Mélanger General et sujets nommés décale la perception et les journaux. - Dérive du Heartbeat : sans cible explicite ou
last, les messages automatiques partent dans la racine. Texte long ou outil intégré = broadcast dans un forum actif—documentez fréquence, @all et politique racine. - Outbound d’outils incohérent : cartes d’approbation (recherche, fichiers) peuvent emprunter une autre file ; les réponses finales atterrissent ailleurs. Les helpers doivent toujours reporter le dernier thread entrant.
Symptôme → preuve → premier correctif
Tableau prêt à coller dans un ticket, en comparant UI Telegram, console Gateway et logs locaux sur la session VNC.
| Ce que vous voyez | Preuve à collecter | Premier geste (sans changer le modèle) | Si ça persiste |
|---|---|---|---|
| Perte de contexte soudaine | Deux entrées avec chemins différents ; l’une sans thread | Compte test confiné à un sous-sujet, pas de chaîne de transferts | Bot par sujet ou désactivation du forum |
| Heartbeat bruyant | JSON sortant sans thread ou ID obsolète | Lier à un sujet explicite / last, redémarrer Gateway | Ralentir, jitter, statut court |
| Réponse d’outil « dans la mauvaise pièce » | Entrée avec thread, sortie sans | Assertion : pas d’envoi auto sans thread | Suivre reply_to_message_id |
Comme l’article multicanal : fermer la boucle sur un canal avant d’empiler.
2) Matrice
| Style de collaboration | Topologie | Coût | Risque |
|---|---|---|---|
| Projets parallèles | Forum + un bot + routage strict | Élevé | Transcripts scindés |
| Petite équipe | Supergroupe classique | Faible | Forum inutile |
| Isolation forte | Plusieurs bots / groupes | Ops élevées | Surface de secrets |
| Broadcast seul | Canal + chat admin | Moyen | Peu adapté aux agents multi-tours |
| Déjà multicanal | Fenêtre d’essai Telegram isolée | Moyen | Bruit d’attribution |
7) Symptômes / logs / correctifs & transport
Ordre figé : prouver que Telegram atteint Gateway, puis champs de fil, puis modèle/outils. Les webhooks sont rapides mais sensibles au proxy inverse et aux certificats ; le long polling avec veille agressive sur un Mac distant imite une « perte de fil ».
| Transport | Avantage forum | Piège fréquent | Aide VNC |
|---|---|---|---|
| Webhook | Corrélation HTTP immédiate | Ingress public, timeouts | Ouvrir l’URL de santé dans le navigateur du Mac distant, capturer en-têtes/TLS |
| Long polling | Simple en labo | Worker bloqué | top + horodatage Telegram |
{
"update_id": 100000000,
"message": {
"message_id": 2048,
"chat": { "id": -1001234567890, "title": "Demo", "is_forum": true },
"message_thread_id": 99,
"from": { "id": 12345, "is_bot": false },
"text": "Poursuivre la chaîne d’outils dans ce sujet"
}
}
Si null, retester en texte natif sans transfert.
3) Huit étapes
Valider le mode forum dans le client
Captures, chat_id.
Vérifier si le compositeur cible General ; aligner last testeur/Gateway.
Droits bot minimaux (VNC)
Politique messages de service.
Un sujet, tours d’outils denses
Stress parallèle avant le second sujet.
JSON masqué
Paires entrée/sortie même seconde.
Heartbeat ciblé
Redémarrer Gateway après changement.
Approbations plugin + fil sortant
Cartes et texte brut.
openclaw doctor
Version dans le ticket.
Rollback supergroupe
Forum off, webhook révoqué, backup.
Conserver pointeur transcripts pré-forum pour audit.
4) Repères
5) VNC
Passer cette liste dix minutes avant release ; refaire smoke après chaque mineur.
- Listener = mode Telegram, pas de double instance
message_thread_idattendu sur l’entrée- Deux sujets parallèles sans collision de fichiers
- Heartbeat dans le bon sujet
- Captures rollback
- Carte d’approbation et réponse finale même fil
- Pas de veille agressive NIC
6) FAQ
Q : version exacte ? La build installée prime.
Conclusion : un Mac distant VNCMac avec VNC aligne preuves UI et console.