À propos du projet

Lossless Claw est un plugin pour OpenClaw qui implémente la gestion de contexte sans perte (LCM), basée sur l'article LCM de Voltropy. Il remplace la compression intégrée par fenêtre glissante d'OpenClaw par un système de synthèse basé sur un graphe acyclique dirigé (DAG) qui préserve chaque message tout en gardant le contexte actif dans les limites de jetons du modèle. Fonctionnement : lorsqu'une conversation dépasse la fenêtre de contexte du modèle, LCM persiste chaque message dans une base de données SQLite organisée par conversation, synthétise des blocs de messages plus anciens à l'aide du LLM configuré, condense les synthèses en nœuds de niveau supérieur formant un graphe acyclique dirigé, assemble le contexte à chaque tour à partir des synthèses plus les messages bruts récents, et expose des outils (lcm_grep, lcm_describe, lcm_expand) pour que les agents puissent rechercher et rappeler des détails de l'historique compressé. Les messages bruts restent dans la base de données et les synthèses renvoient à leurs messages sources. L'installation utilise l'installateur de plugins d'OpenClaw, par exemple `openclaw plugins install @martian-engineering/lossless-claw@latest`. Les prérequis incluent OpenClaw avec prise en charge du moteur de contexte de plugin, Node.js 22+ et un fournisseur LLM configuré dans OpenClaw pour la synthèse. Le README note la compatibilité avec OpenClaw 2026.9.2 ou plus récent pour les panneaux de session de plugin natifs, et l'explorateur de contexte nécessite Paramètres → Laboratoires → Interface utilisateur de plugin personnalisée. La configuration est disponible via la configuration du plugin et les variables d'environnement, ces dernières ayant priorité. Les paramètres notables incluent freshTailCount (messages récents protégés de la compression), leafChunkTokens (jetons sources par bloc de compression feuille), contextThreshold (fraction de la fenêtre de contexte déclenchant la compression), incrementalMaxDepth, les remplacements summaryModel et expansionModel, et les modèles d'exclusion de session. Une configuration de départ recommandée est fournie. Le package inclut un CLI shell `lcm` orienté agent pour l'inspection en lecture seule de lcm.db plus une commande validée d'écriture de configuration, et des commandes OpenClaw natives telles que `/lossless` et `/lcm` pour le statut, la sauvegarde, les diagnostics doctor et les opérations de maintenance. Un CLI de migration de session unique (`lossless-claw-migrate-sessions`) remplit les fichiers de session JSONL existants d'OpenClaw dans lcm.db, avec des modes dry-run et apply. Le README documente également la sémantique de réinitialisation de session distinguant `/new` (conserve la ligne de conversation et les synthèses, purge les éléments de contexte) de `/reset` (archive la ligne de conversation active et en crée une nouvelle), les exigences de remplacement du modèle d'expansion impliquant la politique de confiance des sous-agents, et un contrat de contrôle programmatique optionnel limité par capacités pour les hôtes prenant en charge la distribution de contrôle du moteur de contexte.