Votre session OpenClaw est bloquée ? Voici ce que l’on sait vraiment

Quand un bot OpenClaw ne répond plus, le réflexe est de crier « la session est figée ». Mais en l’état, sans avoir posé les yeux sur les logs et les statuts de la machine, on ne peut pas trancher. Les preuves disponibles pointent vers deux grandes familles de causes, avec des sous-variantes documentées.

1. Les suspects solides : gateway/processus ou session obèse

D’après la documentation officielle et les rapports de bugs, les deux hypothèses les plus probables sont :

• Un processus stale ou une gateway qui patine : c’est le cas visé en priorité par l’échelle de diagnostic officielle . Une gateway peut se bloquer, un processus client OpenClaw rester accroché, ou l’application qui embarque OpenClaw (wrapper, dashboard) refuser de tourner rond. La parade documentée : arrêter ou redémarrer le processus OpenClaw fautif, relancer les applis qui l’encapsulent, puis vérifier que le PID indésirable a bien disparu avec

  openclaw gateway status --deep

  ou

  openclaw doctor --deep

  .
• Une session devenue trop lourde : un bug bien identifié montre des sessions Telegram qui gonflent jusqu’à 2–3 Mo, dépassent les 200 000 tokens (seuil au-dessus de la limite de 200k du modèle), et cassent la compaction automatique. Résultat : le bot devient muet, chaque nouveau message échoue silencieusement . Si c’est vraiment la session courante qui est en cause, ce scénario de « contexte qui déborde » est le suspect n°1.

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

openclaw status --all

openclaw doctor --fix

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