session-logs

• L'utilisateur demande « de quoi avons-nous parlé la semaine dernière ? » ou fait référence à une conversation antérieure absente de la mémoire actuelle.
• Vous devez calculer les coûts de session, compter les messages ou résumer l'utilisation des outils dans les chats historiques.
• Vous souhaitez rechercher rapidement un mot-clé ou une expression spécifique dans toutes les sessions passées.
• Vous devez identifier les sessions par date, taille ou fournisseur (Discord, WhatsApp, etc.) à l'aide de l'index sessions.json.

• Le contexte dont vous avez besoin est déjà disponible dans la fenêtre de conversation actuelle ou dans les fichiers mémoire — inutile d'accéder au système de fichiers.
• Vous travaillez dans un environnement où le stockage de session ~/.openclaw/agents/ n'existe pas ou n'est pas accessible.

Utilisez rg (ripgrep) pour rechercher une expression ou un mot-clé dans tous les fichiers JSONL de session en une seule commande. Localisez rapidement les sessions contenant du contenu pertinent sans lire chaque fichier manuellement.

Extrayez indépendamment les messages utilisateur, les réponses de l'assistant, les appels d'outils ou les blocs de réflexion en utilisant des sélecteurs jq sur les champs .message.role et .message.content[].type. Filtre automatiquement le bruit comme les résultats d'outils.

Agrégez message.usage.cost.total sur une session ou sur toutes les sessions par jour pour produire des résumés de coûts. Prend également en charge le comptage des messages, le calcul de la durée des sessions et la ventilation de l'utilisation des outils par fréquence.

Listez toutes les sessions triées par date et taille de fichier, trouvez les sessions d'un jour spécifique, ou consultez sessions.json pour associer les fournisseurs de chat (Discord, WhatsApp, etc.) aux identifiants de session.

Les sessions sont des fichiers JSONL en ajout uniquement qui peuvent atteindre plusieurs Mo. Les modèles de requêtes de la compétence session-logs incluent des conseils d'échantillonnage head/tail et l'utilisation de jq en streaming pour éviter de charger des fichiers entiers en mémoire inutilement.

Lorsqu'un utilisateur dit « tu te souviens quand on a parlé de X le mois dernier ? », l'agent utilise cette compétence pour rechercher des fichiers de session par date ou par mot-clé grâce à session-logs, et faire remonter l'échange pertinent, même s'il ne se trouve plus dans la fenêtre de contexte active.

Un développeur souhaite comprendre combien coûte chaque conversation. Cette compétence agrège cost.total par session et regroupe les résultats par jour, produisant une ventilation lisible des coûts sur l'ensemble de l'historique de l'agent.

Un opérateur souhaite savoir quels outils l'agent appelle le plus fréquemment. Cette compétence extrait les entrées toolCall des journaux de session, les comptabilise et les classe — utile pour déboguer ou optimiser le comportement de l'agent.

Un utilisateur demande si un sujet particulier (par exemple, un nom de projet, une décision) a déjà été abordé. L'agent effectue une recherche ripgrep sur tous les fichiers JSONL et renvoie les chemins de session correspondants pour une exploration approfondie.