session-logs

• Der Benutzer fragt „worüber haben wir letzte Woche gesprochen?" oder bezieht sich auf ein früheres Gespräch, das sich nicht im aktuellen Speicher befindet.
• Du musst Sitzungskosten berechnen, Nachrichten zählen oder die Tool-Nutzung über vergangene Chats hinweg zusammenfassen.
• Du möchtest schnell nach einem bestimmten Schlüsselwort oder einer Phrase in allen vergangenen Sitzungen suchen.
• Du musst Sitzungen anhand von Datum, Größe oder Anbieter (Discord, WhatsApp usw.) mithilfe des sessions.json-Index identifizieren.

• Der Kontext, den du benötigst, ist bereits im aktuellen Konversationsfenster oder in Memory-Dateien verfügbar — kein Zugriff auf das Dateisystem erforderlich.
• Du arbeitest in einer Umgebung, in der der ~/.openclaw/agents/-Sitzungsspeicher nicht existiert oder nicht zugänglich ist.

Verwende rg (ripgrep), um mit einem einzigen Befehl alle Sitzungs-JSONL-Dateien nach einem Begriff oder Schlüsselwort zu durchsuchen. Finde schnell heraus, welche Sitzungen relevante Inhalte enthalten, ohne jede Datei manuell lesen zu müssen.

Extrahiere Benutzernachrichten, Assistentenantworten, Werkzeugaufrufe oder Denkblöcke unabhängig voneinander mithilfe von jq-Selektoren auf den Feldern .message.role und .message.content[].type. Filtert automatisch Rauschen wie Werkzeugergebnisse heraus.

Aggregiere message.usage.cost.total über eine Sitzung oder über alle Sitzungen nach Tag, um Kostenzusammenfassungen zu erstellen. Unterstützt außerdem das Zählen von Nachrichten, die Berechnung der Sitzungsdauer und die Aufschlüsselung der Werkzeugnutzung nach Häufigkeit.

Alle Sitzungen nach Datum und Dateigröße sortiert auflisten, Sitzungen von einem bestimmten Tag finden oder sessions.json konsultieren, um Chat-Anbieter (Discord, WhatsApp usw.) Sitzungs-IDs zuzuordnen.

Sessions sind ausschließlich erweiterbare JSONL-Dateien, die auf mehrere MB anwachsen können. Die Abfragemuster des Skills umfassen head/tail-Sampling-Tipps sowie die Verwendung von Streaming-jq, um das unnötige Laden ganzer Dateien in den Speicher zu vermeiden.

Wenn ein Benutzer sagt „Erinnerst du dich, als wir letzten Monat über X gesprochen haben?", verwendet der Agent diese Fähigkeit, um mit session-logs Sitzungsdateien nach Datum oder Schlüsselwort zu durchsuchen und den relevanten Austausch anzuzeigen – selbst wenn er sich nicht mehr im aktiven Kontextfenster befindet.

Ein Entwickler möchte verstehen, wie viel jede Konversation kostet. Diese Skill aggregiert cost.total pro Sitzung und gruppiert die Ergebnisse nach Tag, wodurch eine lesbare Kostenaufschlüsselung über die gesamte Agenthistorie erstellt wird.

Ein Betreiber möchte wissen, welche Werkzeuge der Agent am häufigsten aufruft. Diese Fähigkeit extrahiert toolCall-Einträge aus session-logs, zählt sie und ordnet sie nach Häufigkeit – nützlich zum Debuggen oder Optimieren des Agentenverhaltens.

Ein Benutzer fragt, ob ein bestimmtes Thema (z. B. ein Projektname oder eine Entscheidung) jemals besprochen wurde. Der Agent führt eine Ripgrep-Suche über alle JSONL-Dateien durch und gibt übereinstimmende Sitzungspfade für eine weiterführende Untersuchung zurück.