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 arquivo, resultados de busca) sem reescrever o texto normal da conversa.

# Por que isso importa

Sessões longas acumulam saída de ferramentas que infla a janela de contexto. Isso aumenta o custo e pode forçar Compaction mais cedo do que o necessário.

A poda é especialmente valiosa para o cache de prompt da Anthropic. Após o TTL do cache expirar, a próxima solicitação armazena novamente em cache o prompt completo. A poda reduz o tamanho da gravação do cache, diminuindo diretamente o custo.

# Como funciona

1. Aguarde o TTL do cache expirar (padrão de 5 minutos).
2. Encontre resultados antigos de ferramentas para a poda normal (o texto da conversa é deixado intacto).
3. Corte suave em resultados grandes demais -- mantenha o início e o fim, insira ....
4. Limpeza rígida no restante -- substitua por um placeholder.
5. Redefina o TTL para que solicitações seguintes reutilizem o cache novo.

# Limpeza legada de imagens

O OpenClaw também constrói uma visualização de replay idempotente separada para sessões que persistem blocos brutos de imagem ou marcadores de mídia de hidratação de prompt no histórico.

• Ela preserva os 3 turnos concluídos mais recentes byte por byte para que os prefixos de cache de prompt para acompanhamentos recentes permaneçam estáveis.
• Na visualização de replay, blocos de imagem mais antigos já processados do histórico de user ou toolResult podem ser substituídos por [image data removed - already processed by model].
• Referências textuais de mídia mais antigas, como [media attached: ...], [Image: source: ...] e media://inbound/..., podem ser substituídas por [media reference removed - already processed by model]. Marcadores de anexo do turno atual permanecem intactos para que modelos de visão ainda possam hidratar imagens novas.
• A transcrição bruta da sessão não é reescrita, então visualizadores de histórico ainda podem renderizar as entradas originais de mensagem e suas imagens.
• Isso é separado da poda normal por TTL de cache. Existe para impedir que cargas repetidas de imagem ou refs de mídia obsoletas 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 do Claude CLI)	Sim	1 hora
Chave de API	Sim	30 min

Se você definir valores explícitos, o OpenClaw não os substituirá.

# 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" },
    },
  },
}

Para desativar: defina mode: "off".

# Poda vs Compaction

	Poda	Compaction
O quê	Remove resultados de ferramentas	Resume a conversa
Salvo?	Não (por solicitação)	Sim (na transcrição)
Escopo	Apenas resultados de ferramentas	Conversa inteira

Elas se complementam -- a poda mantém a saída de ferramentas enxuta entre ciclos de Compaction.

# Leitura adicional

• Compaction -- redução de contexto baseada em sumarização
• Configuração do Gateway -- todos os ajustes de configuração de poda (contextPruning.*)

# Relacionados

• Gerenciamento de sessão
• Ferramentas de sessão
• Mecanismo de contexto