Poda de sessão
A poda de sessão remove resultados antigos de ferramentas do contexto antes de cada
chamada ao LLM. Ela reduz o inchaço do contexto causado pelo acúmulo de saídas de ferramentas (resultados de exec, leituras de arquivos, resultados de busca) sem reescrever o texto normal da conversa.
A poda ocorre apenas em memória — ela não modifica a transcrição da sessão em disco.
Seu histórico completo é sempre preservado.
Por que isso importa
Sessões longas acumulam saída de ferramentas, o que infla a janela de contexto. Isso
aumenta o custo e pode forçar a compactação antes do
necessário.
A poda é especialmente valiosa para o cache de prompt da Anthropic. Depois que o TTL do cache
expira, a próxima solicitação recria o cache do prompt completo. A poda reduz o
tamanho da gravação no cache, diminuindo diretamente o custo.
Como funciona
- Espera o TTL do cache expirar (padrão de 5 minutos).
- Encontra resultados antigos de ferramentas para a poda normal (o texto da conversa é deixado intacto).
- Soft-trim de resultados grandes demais — mantém o início e o fim, inserindo
....
- Hard-clear do restante — substitui por um placeholder.
- Redefine o TTL para que solicitações de acompanhamento reutilizem o cache recém-atualizado.
Limpeza de imagens legadas
O OpenClaw também executa uma limpeza idempotente separada para sessões legadas mais antigas que
persistiram blocos brutos de imagem no histórico.
- Ele preserva os 3 turnos concluídos mais recentes byte por byte para que os
prefixos do cache de prompt de acompanhamentos recentes permaneçam estáveis.
- Blocos de imagem antigos já processados no histórico
user ou toolResult podem ser
substituídos por [image data removed - already processed by model].
- Isso é separado da poda normal por TTL de cache. Existe para impedir que cargas repetidas
de imagem invalidem caches de prompt em turnos posteriores.
Padrões inteligentes
O OpenClaw ativa automaticamente a poda para perfis Anthropic:
| Tipo de perfil | Poda ativada | Heartbeat |
|---|
| Autenticação OAuth/token da Anthropic (incluindo reutilização da Claude CLI) | Sim | 1 hora |
| Chave de API | Sim | 30 min |
Ativar ou desativar
A poda fica desativada por padrão para provedores não Anthropic. Para ativar:
{
agents: {
defaults: {
contextPruning: { mode: "cache-ttl", ttl: "5m" },
},
},
}
mode: "off".
Poda vs compactação
| Poda | Compactação |
|---|
| O que | Remove resultados de ferramentas | Resume a conversa |
| É salva? | Não (por solicitação) | Sim (na transcrição) |
| Escopo | Apenas resultados de ferramentas | Conversa inteira |
Leitura adicional
