Plugin OpenClaw Context Meter affiche le pourcentage d'utilisation du jeton Telegram

Ce qu'il fait

Le plugin openclaw-context-meter affiche automatiquement le pourcentage d'utilisation des tokens après chaque réponse du bot Telegram. Après chaque réponse, il envoie un petit pied de page comme : 📊 45k / 200k (22%). Lorsqu'une compaction se produit (les tokens diminuent significativement), il affiche : 📊 30k / 200k (15%) — compacté depuis 150k.

Le problème qu'il résout

Auparavant, il n'y avait pas de moyen simple de voir à quel point la fenêtre de contexte est pleine sans taper constamment /status. Le plugin offre une visibilité automatique sur la consommation de tokens.

Parcours de développement

v1 — Le désastre de mémoire insuffisante : Initialement, il utilisait execSync("openclaw models list --json") pour découvrir dynamiquement les fenêtres de contexte des modèles. Cela lançait un processus complet d'OpenClaw (~2 Go de RAM) chaque fois que le plugin se chargeait. Avec le plugin se chargeant 4 à 5 fois au démarrage (une fois par agent/exécution), cela causait : 2 Go de passerelle + 5 × 2 Go de sous-processus = 12 Go → mémoire insuffisante instantanée. Le tueur de mémoire insuffisante a éliminé sshd et NetworkManager, rendant les serveurs complètement inaccessibles et créant une boucle de redémarrage infinie.

v2 — La correction légère : Fenêtres de contexte codées en dur pour plus de 40 modèles. Zéro sous-processus, zéro surcharge mémoire. Réalisation clé : ne jamais utiliser execSync dans les plugins OpenClaw, car même une simple requête CLI lance l'exécution complète avec tous les plugins et la compilation TypeScript.

Pourquoi aucun fork n'est nécessaire

Le plugin a initialement forké OpenClaw pour patcher les crochets before_compaction/after_compaction, mais les changements en amont ont rendu cela inutile :

• v2026.3.13+ — l'amont transmet maintenant sessionId + agentId + sessionKey dans le contexte du crochet de compaction
• v2026.3.22+ — les notifications intégrées 🧹 Compactage du contexte... (problème #38805) ont rendu leur code de compaction inutile
• v2026.3.22+ — la commande intégrée /usage tokens|full|cost pour l'affichage basique des tokens

Le plugin se concentre maintenant sur ce qui manque encore : l'affichage du pourcentage de la fenêtre de contexte.

Fonctionnalités

• Zéro coût — utilise uniquement les crochets agent_end + message_sent, pas d'appels API supplémentaires
• Aucun sous-processus — les fenêtres de contexte des modèles sont codées en dur (pas de risque de mémoire insuffisante avec execSync)
• Filtrage intelligent — ignore les tours tool_use, envoie le pied de page uniquement après la réponse texte finale
• Avec temporisation — attend 1,5 s après le dernier message pour éviter le pied de page en milieu de flux
• Multi-agent — fonctionne avec plusieurs agents et comptes Telegram
• Détection de compaction — détecte les baisses de tokens et affiche les statistiques avant/après

Limitations connues

• Certains fournisseurs (comme Qwen) renvoient totalTokens: 0 — le pied de page ne s'affichera pas pour ces modèles
• Les fenêtres de contexte codées en dur pourraient être incorrectes pour les nouveaux modèles — extraites de la source v2026.3.22
• Uniquement Telegram pour l'instant (envoie le pied de page via l'API Bot)

Installation

cd ~/.openclaw/extensions
npm pack openclaw-context-meter
tar xzf openclaw-context-meter-*.tgz
mv package context-meter
rm openclaw-context-meter-*.tgz

Ajouter à openclaw.json :

{
  "plugins": {
    "allow": ["context-meter"],
    "entries": {
      "context-meter": {
        "enabled": true
      }
    }
  }
}

Nécessite OpenClaw >= 2026.3.22.