Sobre o projeto

Lossless Claw é um plugin para OpenClaw que implementa Gerenciamento de Contexto Sem Perdas (LCM), baseado no artigo LCM da Voltropy. Ele substitui a compactação integrada por janela deslizante do OpenClaw por um sistema de sumarização baseado em DAG que preserva cada mensagem enquanto mantém o contexto ativo dentro dos limites de tokens do modelo. Como funciona: quando uma conversa excede a janela de contexto do modelo, o LCM persiste cada mensagem em um banco de dados SQLite organizado por conversa, resume blocos de mensagens mais antigas usando o LLM configurado, condensa resumos em nós de nível superior formando um grafo acíclico direcionado, monta o contexto a cada turno a partir de resumos mais mensagens brutas recentes, e expõe ferramentas (lcm_grep, lcm_describe, lcm_expand) para que agentes possam pesquisar e recordar detalhes do histórico compactado. Mensagens brutas permanecem no banco de dados e resumos vinculam de volta às suas mensagens de origem. A instalação usa o instalador de plugins do OpenClaw, por exemplo `openclaw plugins install @martian-engineering/lossless-claw@latest`. Pré-requisitos incluem OpenClaw com suporte ao mecanismo de contexto de plugins, Node.js 22+ e um provedor de LLM configurado no OpenClaw para sumarização. O README observa compatibilidade com OpenClaw 2026.9.2 ou mais recente para painéis de sessão nativos de plugins, e o explorador de contexto requer Configurações → Labs → UI de plugin personalizada. A configuração está disponível através da configuração do plugin e variáveis de ambiente, com variáveis de ambiente tendo precedência. Configurações notáveis incluem freshTailCount (mensagens recentes protegidas da compactação), leafChunkTokens (tokens de origem por bloco de compactação folha), contextThreshold (fração da janela de contexto que aciona a compactação), incrementalMaxDepth, substituições de summaryModel e expansionModel, e padrões de exclusão de sessão. Uma configuração inicial recomendada é fornecida. O pacote inclui um CLI de shell `lcm` orientado a agente para inspeção somente leitura de lcm.db mais um comando validado de escrita de configuração, e comandos nativos do OpenClaw como `/lossless` e `/lcm` para status, backup, diagnóstico médico e operações de manutenção. Um CLI de migração de sessão única (`lossless-claw-migrate-sessions`) preenche arquivos de sessão JSONL existentes do OpenClaw em lcm.db, com modos de simulação e aplicação. O README também documenta semânticas de redefinição de sessão distinguindo `/new` (mantém a linha da conversa e resumos, remove itens de contexto) de `/reset` (arquiva a linha da conversa ativa e cria uma nova), requisitos de substituição do modelo de expansão envolvendo política de confiança de subagentes, e um contrato de controle programático opcional limitado por capacidade para hosts que suportam despacho de controle do mecanismo de contexto.