2. Ce que la doc officielle exige avant de conclure

Avant d’incriminer quoi que ce soit, la checklist de santé est claire :

1. openclaw status — doit afficher Runtime: running
2. openclaw gateway status — doit confirmer Connectivity probe: ok
3. openclaw logs --follow — pour traquer les erreurs en temps réel
4. openclaw doctor — pour détecter et réparer les corruptions de dépendances (plugin load failed: dependency tree corrupted)
5. openclaw channels status --probe — pour chaque canal, le transport doit être connecté et l’état doit être works ou audit ok quand le protocole le permet

Si un canal est configuré mais que le message plugin load failed: dependency tree corrupted apparaît dans openclaw status --all, c’est que la mise à jour d’un plugin a laissé une arborescence corrompue. openclaw doctor --fix nettoie ces résidus et permet au canal de se réenregistrer .

3. Les autres bugs documentés qui peuvent donner l’impression d’un « freeze »

Plusieurs rapports de bugs sont à connaître car leurs symptômes ressemblent à une session figée :

• Validation du chemin de session : si le heartbeat ou le gestionnaire Telegram échoue à accéder aux fichiers de session (chemin mal résolu), le bot ne peut plus répondre .
• Crashs en cascade de la gateway : pas seulement sur des erreurs réseau. Toute exception non gérée — y compris une opération locale sur un fichier (fichier inexistant, permissions) — peut faire crasher la gateway. Node.js tue le processus sur les rejets non capturés .
• CPU spin de la gateway : un bug distinct montre que la gateway peut saturer le CPU et bloquer les réponses Telegram . Mais rien n’indique que ce soit le cas ici sans avoir vu les métriques CPU de la machine.
• Erreur « pairing required » : après un openclaw gateway install --force, il arrive que sessions_spawn échoue avec gateway closed (1008): pairing required. Cela empêche toute nouvelle session de démarrer et peut donner l’impression d’un plantage général, même si les sessions existantes ne sont pas directement corrompues .

4. Comment interpréter « session courante figée »

Le vocabulaire utilisé change la piste à privilégier :

• Si vous dites « la session courante est figée », les indices penchent vers :
  • une session qui a gonflé / un contexte qui a débordé ,
  • ou une erreur de manipulation du chemin de session .
• Si vous dites « le bot Telegram ne répond plus du tout », les indices penchent vers :
  • un blocage de la gateway ou d’un canal ,
  • une erreur de chargement de plugin ,
  • ou un processus stale / une appli wrapper qui s’est figée .

En résumé

On ne peut pas désigner UNE cause certaine. Tout ce que l’on peut affirmer aujourd’hui, c’est :

• Soit la gateway, un processus ou un canal OpenClaw est stall ou stale ;
• Soit le fichier de session courante a tellement grossi que le bot s’étouffe .

Pour trancher, il faut passer par la ladder de diagnostic officielle en regardant status, gateway status, logs et doctor. Sans ces sorties, toute affirmation serait de la pure spéculation.

2. Ce que la doc officielle exige avant de conclure

Avant d’incriminer quoi que ce soit, la checklist de santé est claire :

1. openclaw status — doit afficher Runtime: running
2. openclaw gateway status — doit confirmer Connectivity probe: ok
3. openclaw logs --follow — pour traquer les erreurs en temps réel
4. openclaw doctor — pour détecter et réparer les corruptions de dépendances (plugin load failed: dependency tree corrupted)
5. openclaw channels status --probe — pour chaque canal, le transport doit être connecté et l’état doit être works ou audit ok quand le protocole le permet

Si un canal est configuré mais que le message plugin load failed: dependency tree corrupted apparaît dans openclaw status --all, c’est que la mise à jour d’un plugin a laissé une arborescence corrompue. openclaw doctor --fix nettoie ces résidus et permet au canal de se réenregistrer .

3. Les autres bugs documentés qui peuvent donner l’impression d’un « freeze »

Plusieurs rapports de bugs sont à connaître car leurs symptômes ressemblent à une session figée :

• Validation du chemin de session : si le heartbeat ou le gestionnaire Telegram échoue à accéder aux fichiers de session (chemin mal résolu), le bot ne peut plus répondre .
• Crashs en cascade de la gateway : pas seulement sur des erreurs réseau. Toute exception non gérée — y compris une opération locale sur un fichier (fichier inexistant, permissions) — peut faire crasher la gateway. Node.js tue le processus sur les rejets non capturés .
• CPU spin de la gateway : un bug distinct montre que la gateway peut saturer le CPU et bloquer les réponses Telegram . Mais rien n’indique que ce soit le cas ici sans avoir vu les métriques CPU de la machine.
• Erreur « pairing required » : après un openclaw gateway install --force, il arrive que sessions_spawn échoue avec gateway closed (1008): pairing required. Cela empêche toute nouvelle session de démarrer et peut donner l’impression d’un plantage général, même si les sessions existantes ne sont pas directement corrompues .

4. Comment interpréter « session courante figée »

Le vocabulaire utilisé change la piste à privilégier :

• Si vous dites « la session courante est figée », les indices penchent vers :
  • une session qui a gonflé / un contexte qui a débordé ,
  • ou une erreur de manipulation du chemin de session .
• Si vous dites « le bot Telegram ne répond plus du tout », les indices penchent vers :
  • un blocage de la gateway ou d’un canal ,
  • une erreur de chargement de plugin ,
  • ou un processus stale / une appli wrapper qui s’est figée .

En résumé

On ne peut pas désigner UNE cause certaine. Tout ce que l’on peut affirmer aujourd’hui, c’est :

• Soit la gateway, un processus ou un canal OpenClaw est stall ou stale ;
• Soit le fichier de session courante a tellement grossi que le bot s’étouffe .

Pour trancher, il faut passer par la ladder de diagnostic officielle en regardant status, gateway status, logs et doctor. Sans ces sorties, toute affirmation serait de la pure spéculation.