Charon

Lethe — Memória Persistente para Agentes de IA

Lethe é uma plataforma de memória persistente auto-hospedada para agentes de IA. Ela dá aos agentes memória durável e revisável que sobrevive a sessões, reinicializações e mudanças de modelo — sem entregar essa memória a terceiros.

Qualquer agente pode usar Lethe: ChatGPT, Claude, Claude Code, Cursor, agentes do VS Code, OpenClaw, clientes MCP personalizados, assistentes locais de IDE ou serviços de backend. Lethe é uma plataforma de memória de propósito geral; o plugin OpenClaw é uma excelente integração, não um requisito.

Por que existe

Toda sessão de agente começa do zero. A mesma pergunta, o mesmo raciocínio, os mesmos becos sem saída — toda vez. Lethe quebra esse ciclo com dois sistemas de memória complementares:

• Memória de sessão — eventos, resumos, checkpoints e recuperação de interrupção para que um agente retome exatamente de onde parou.
• Memória versionada — conhecimento durável, compartilhado e com revisão controlada, com histórico imutável, proveniência, ramificação e mesclagem (veja Memory Git).

Para quem é

• Indivíduos dando a um único agente (ChatGPT, Claude, Cursor, um assistente de IDE) uma memória de longo prazo.
• Equipes executando vários agentes contra um backend de memória compartilhado e revisado.
• Operadores que precisam que a memória permaneça em sua própria infraestrutura, em um contêiner, com suas chaves.

Três modos de execução

Modo	Finalidade	Escolha quando
Legacy	Memória orientada a sessão: eventos, resumos, checkpoints, recuperação de interrupção, rastreamento de tarefas	Você usa OpenClaw ou quer apenas continuidade de sessão
Git	Memória persistente versionada para qualquer agente: conhecimento durável, decisões, memória compartilhada multiagente, histórico revisável	Você quer memória persistente, compartilhada ou governada — com ou sem OpenClaw
Hybrid	Ambos os sistemas de memória em uma única instância	Migração, desenvolvimento ou quando você quer memória de sessão e versionada juntas

Detalhes e orientação de decisão: docs/runtime-modes.md.

Instalação

# legacy session memory, port 18483
docker run -d --name lethe \
  -p 127.0.0.1:18483:18483 \
  -v ./lethe-data:/data \
  ghcr.io/openlethe/lethe:latest

Memory Git (modo git) é executado a partir de docker-compose.git.yml; o modo híbrido é uma instância com ambas as superfícies. Instruções completas, todas as variações de compose e builds a partir do código-fonte: docs/installation.md · docs/docker-compose.md

Documentação

Leia em ordem:

1. Visão geral — o que Lethe é e não é, princípios, ecossistema
2. Instalação — Docker, modo git, híbrido, build a partir do código-fonte
3. Modos de execução — legacy vs git vs híbrido, como escolher
4. Memory Git — memória versionada, refs, changesets, propostas, merges
5. Modo legacy — memória de sessão e a experiência OpenClaw
6. Arquitetura — componentes, limite, modelo de dados, segurança
7. Configuração — todas as variáveis de ambiente
8. Implantação e operações — checklist de produção, atualizações, backup
9. Variações de compose — stack legacy, git, híbrida, governada
10. Referência da API HTTP — todas as rotas, ambas as superfícies
11. OpenClaw — a integração do plugin
12. Integrações — ChatGPT, Claude Code, Cursor, MCP, multiagente
13. Migração e atualização — migrações de versão, legacy ↔ Memory Git
14. FAQ

Referências de protocolo e aprofundamento: memory-git-v1.md (o contrato memory_git/v1) · memory-context-bridge.md (projeção e manifestos) · observability.md (métricas, SLOs, alertas)

Projetos relacionados

• Charon — o gateway de autorização e governança MCP para Lethe: principals com escopo, revisão independente, merges protegidos à prova de replay e um ledger de auditoria fail-closed. Recomendado para implantações compartilhadas ou multiagente.
• Plugin OpenClaw — mecanismo de contexto opcional para OpenClaw, publicado no ClawHub como lethe. Opcional; tudo funciona sem ele.

Compatibilidade

Componente	Versão
Lethe	v0.4.0
Charon	v0.1.0-beta.1
Esquema do Memory Git	memory_git/v1
Autorização de merge	memory-git-merge/v2
Plugin Lethe OpenClaw	versão correspondente do Lethe

Licença

Veja LICENSE. Problemas e contribuições: CONTRIBUTING.md · Relatórios de segurança: SECURITY.md