Context Persistence para Openclaw

Um framework especializado para resolver problemas de perda de contexto e sincronização de estado entre sessões isoladas de agentes de AI.

lgy2020
v1.0.0
Mar 19, 2026
1
1.1k
0

Instalar e Baixar

1. ClawHub CLI

A maneira mais rápida de instalar uma habilidade diretamente do registro.

npx clawhub@latest install context-persistence

2. Instalação Manual

Copie a pasta da habilidade para um desses locais

Global
~/.openclaw/skills/
Espaço de trabalho
<project>/skills/

Prioridade: Espaço de Trabalho > Local > Integrado

3. Instalação do Prompt

Copie este prompt para o OpenClaw para instalá-lo automaticamente.

Ajude-me a instalar o context-persistence usando o Clawhub. Se o Clawhub não estiver instalado, instale-o primeiro (npm i -g clawhub).

Prefere baixar?

Obtenha os arquivos originais da habilidade em um arquivo ZIP.

O que é Context Persistence?

Context Persistence é um framework técnico crítico projetado para preencher a lacuna entre sessões de AI isoladas. Em muitos ambientes de AI, o estado criado em uma sessão — como um cron job, tarefa de subagente ou heartbeat — é invisível para as outras. Esta skill fornece o projeto arquitetônico para garantir que tarefas de longa duração e fluxos de trabalho complexos mantenham a continuidade, tratando o sistema de arquivos como a principal fonte de verdade.

Ao aproveitar esta implementação específica dentro do Openclaw Skills, os desenvolvedores podem evitar o problema comum em que um agente esquece o progresso ou carece de informações de histórico necessárias. Ele estabelece uma hierarquia robusta para a memória, indo além do estado transitório na memória para um modelo de persistência estruturado baseado em arquivos que sobrevive aos limites da sessão.

Casos de uso do Context Persistence

  • Sincronização de estado entre cron jobs, subagentes e a sessão principal.
  • Acompanhamento do progresso de tarefas de longa duração, como análise de dados em larga escala ou auditorias de código.
  • Gerenciamento de estado compartilhado entre várias sessões simultâneas de agentes de AI.
  • Resolução de relatos de usuários onde o agente parece perder o histórico ou o contexto.
  • Implementação de sistemas de memória de longo prazo que evoluem ao longo de dias ou semanas.

Como o Context Persistence funciona

  1. O sistema identifica os tipos de sessão (Main DM, Cron, Subagent) e suas limitações específicas de contexto.
  2. Ele implementa um Sistema de Memória de Três Camadas, que varia de fatos curados de longo prazo a logs diários em tempo real.
  3. O estado é explicitamente persistido em arquivos Markdown, que servem como o único canal de comunicação confiável entre as sessões.
  4. Durante a inicialização da sessão, o agente segue uma sequência de inicialização rigorosa para carregar os arquivos de memória relevantes (SOUL.md, USER.md e logs diários).
  5. Arquivos de progresso específicos da tarefa são atualizados em checkpoints para garantir que qualquer sessão subsequente possa retomar do ponto exato da interrupção.

Configuração do Context Persistence

Para implementar a persistência de contexto em seu ambiente, certifique-se de que seu espaço de trabalho siga a estrutura de diretórios recomendada. Você pode inicializar o diretório de memória usando os seguintes comandos:

# Create the standard memory directory
mkdir -p memory\/

# Initialize the core memory files
touch MEMORY.md
touch memory\/$(date +%Y-%m-%d).md

Configure seu AGENTS.md para garantir que a sequência de inicialização leia explicitamente esses arquivos durante a inicialização para fornecer ao agente Openclaw Skills um contexto histórico imediato.

Esquema de Dados e Taxonomia de Context Persistence

A skill organiza os dados em uma taxonomia hierárquica para equilibrar os limites da janela de contexto com a densidade de informações:

File Type Purpose Reader/Writer Access
MEMORY.md Fatos e decisões curados de longo prazo (< 200 linhas) Apenas sessão principal
memory\/YYYY-MM-DD.md Logs cronológicos e eventos em tempo real Todas as sessões (escrita), Principal (leitura)
memory\/<task>-progress.md Progresso estruturado para tarefas ativas (< 300 linhas) Qualquer sessão que lide com a tarefa
SOUL.md / USER.md Persona e preferências específicas do usuário Todas as sessões (somente leitura)

Recursos avançados do Context Persistence

  • Coordenação multi-agente via arquivos de estado compartilhado para transferências de tarefas complexas.
  • Rotação automatizada de logs diários e revisão periódica durante sessões de heartbeat.
  • Injeção de contexto para payloads de cron isolados para manter a eficiência de estado abaixo de 1KB.
  • Modelos de rastreamento de progresso que incluem lógica de desduplicação e próximo passo para fluxos de trabalho de alta confiabilidade.

SKILL.md


Carregamento

Habilidades relacionadas do Openclaw

METADATA

Github Stars: 0
forks: 0

Apresentou*