session-logs

• L'utente chiede "di cosa abbiamo parlato la settimana scorsa?" o fa riferimento a una conversazione precedente non presente nella memoria attuale.
• Devi calcolare i costi della sessione, contare i messaggi o riassumere l'utilizzo degli strumenti nelle chat storiche.
• Vuoi cercare rapidamente una parola chiave o una frase specifica in tutte le sessioni passate.
• Devi identificare le sessioni per data, dimensione o provider (Discord, WhatsApp, ecc.) utilizzando l'indice sessions.json.

• Il contesto di cui hai bisogno è già disponibile nella finestra della conversazione corrente o nei file di memoria — non è necessario accedere al filesystem.
• Stai lavorando in un ambiente in cui lo storage di sessione ~/.openclaw/agents/ non esiste o non è accessibile.

Usa rg (ripgrep) per cercare una frase o una parola chiave in tutti i file JSONL delle sessioni con un unico comando. Individua rapidamente quali sessioni contengono contenuti rilevanti senza dover leggere manualmente ogni file.

Estrai messaggi utente, risposte dell'assistente, chiamate a strumenti o blocchi di pensiero in modo indipendente utilizzando i selettori jq sui campi .message.role e .message.content[].type. Filtra automaticamente il rumore come i risultati degli strumenti.

Aggrega message.usage.cost.total in una sessione o in tutte le sessioni per giorno per produrre riepiloghi dei costi. Supporta inoltre il conteggio dei messaggi, il calcolo della durata della sessione e la suddivisione dell'utilizzo degli strumenti per frequenza.

Elenca tutte le sessioni ordinate per data e dimensione del file, trova le sessioni di un giorno specifico, o consulta sessions.json per mappare i provider di chat (Discord, WhatsApp, ecc.) agli ID di sessione.

Le sessioni sono file JSONL ad aggiunta progressiva che possono raggiungere diversi MB. I pattern di query della skill includono suggerimenti per il campionamento con head/tail e l'uso in streaming di jq per evitare di caricare interi file in memoria inutilmente.

Quando un utente dice "ricordi quando abbiamo discusso di X il mese scorso?", l'agente utilizza questa skill per cercare i file di sessione per data o parola chiave e recuperare lo scambio pertinente, anche se non è più nella finestra di contesto attiva.

Uno sviluppatore vuole capire quanto costa ogni conversazione. Questa skill aggrega cost.total per sessione e raggruppa i risultati per giorno, producendo un riepilogo leggibile dei costi sull'intera cronologia dell'agente.

Un operatore vuole sapere quali strumenti l'agente chiama più frequentemente. Questa skill estrae le voci toolCall dai log di sessione, le conta e le classifica — utile per il debug o per ottimizzare il comportamento dell'agente.

Un utente chiede se un determinato argomento (ad esempio il nome di un progetto, una decisione) sia mai stato discusso. L'agente esegue una ricerca con ripgrep su tutti i file JSONL e restituisce i percorsi delle sessioni corrispondenti per un'ulteriore esplorazione.