session-logs

• O usuário pergunta "sobre o que conversamos semana passada?" ou faz referência a uma conversa anterior que não está na memória atual.
• Você precisa calcular custos de sessão, contar mensagens ou resumir o uso de ferramentas em chats históricos.
• Você quer pesquisar uma palavra-chave ou frase específica em todas as sessões passadas rapidamente.
• Você precisa identificar sessões por data, tamanho ou provedor (Discord, WhatsApp, etc.) usando o índice sessions.json.

• O contexto que você precisa já está disponível na janela de conversa atual ou nos arquivos de memória — não é necessário acessar o sistema de arquivos.
• Você está trabalhando em um ambiente onde o armazenamento de sessões ~/.openclaw/agents/ não existe ou não está acessível.

Use rg (ripgrep) para pesquisar em todos os arquivos JSONL de sessão por uma frase ou palavra-chave em um único comando. Localize rapidamente quais sessões contêm conteúdo relevante sem precisar ler cada arquivo manualmente.

Extraia mensagens do usuário, respostas do assistente, chamadas de ferramentas ou blocos de raciocínio de forma independente usando seletores jq nos campos .message.role e .message.content[].type. Filtra automaticamente ruídos como resultados de ferramentas.

Agregue message.usage.cost.total em uma sessão ou em todas as sessões por dia para produzir resumos de custos. Também suporta contagem de mensagens, cálculo de duração de sessão e detalhamento do uso de ferramentas por frequência.

Liste todas as sessões ordenadas por data e tamanho de arquivo, encontre sessões de um dia específico ou consulte sessions.json para mapear provedores de chat (Discord, WhatsApp, etc.) a IDs de sessão.

As sessões são arquivos JSONL de adição exclusiva que podem crescer até vários MB. Os padrões de consulta da skill session-logs incluem dicas de amostragem com head/tail e uso de jq em streaming para evitar carregar arquivos inteiros na memória desnecessariamente.

Quando um usuário diz "lembra quando falamos sobre X mês passado?", o agente usa essa skill para pesquisar arquivos de sessão por data ou palavra-chave e trazer à tona a troca relevante, mesmo que ela não esteja mais na janela de contexto ativa.

Um desenvolvedor quer entender quanto cada conversa está custando. Essa skill agrega cost.total por sessão e agrupa os resultados por dia, produzindo um detalhamento de custos legível em todo o histórico do agente.

Um operador quer saber quais ferramentas o agente chama com maior frequência. Esta skill extrai entradas toolCall dos session-logs, as contabiliza e as classifica — útil para depuração ou otimização do comportamento do agente.

Um usuário pergunta se determinado tópico (por exemplo, o nome de um projeto ou uma decisão) já foi discutido alguma vez. O agente executa uma busca com ripgrep em todos os arquivos JSONL e retorna os caminhos das sessões correspondentes para exploração posterior.