Sitzungssuche

sessions_search durchsucht die Texte von Benutzern und Assistenten in Ihren eigenen vergangenen Sitzungen. Jedes Ergebnis enthält eine sessionKey, einen Zeitstempel, eine Rolle und einen kurzen übereinstimmenden Auszug. Übergeben Sie die zurückgegebene sessionKey an sessions_history, wenn Sie die umgebende Konversation benötigen.

Sichtbarkeit und Ausgabe

Die Suche verwendet dieselben Regeln für die Sitzungssichtbarkeit wie sessions_history. Ergebnisse außerhalb des für den Aufrufer sichtbaren Sitzungsbaums werden entfernt, bevor Ergebnislimits angewendet werden. Sandbox-Agenten bleiben auf von ihnen gestartete Sitzungen beschränkt, wenn die Sichtbarkeit gestarteter Sitzungen aktiviert ist.

Auszüge werden geschwärzt, bevor sie an das Modell zurückgegeben werden. Die Ergebnisse sind außerdem hinsichtlich Anzahl, Auszugslänge und Gesamtgröße der Antwort begrenzt.

Lebenszyklus des Index

OpenClaw speichert in der SQLite-Datenbank jedes Agenten neben den Transkriptzeilen einen Volltextindex. Neue Benutzer- und Assistentennachrichten werden in derselben Transaktion indexiert, in der sie gespeichert werden, sodass der Index nie hinter laufenden Konversationen zurückbleibt; Tool-Ergebnisse, Reasoning-Blöcke und Bilder werden ausgeschlossen. Nur der aktive Zweig des Transkripts kann durchsucht werden.

Transkripte, die älter als der Index sind (beispielsweise durch openclaw doctor importierte Sitzungen), und Sitzungen, deren aktiver Zweig zurückgesetzt wurde, werden durch einen Hintergrundabgleich neu indexiert, der mit der nächsten Suche beginnt. Eine Antwort mit indexing: true kann daher unvollständig sein; versuchen Sie es erneut, nachdem die Indexierung abgeschlossen ist. Beim Löschen einer Sitzung werden deren Indexeinträge in derselben Transaktion entfernt.

Die Suche verwendet derzeit den Unicode-Wort-Tokenizer von SQLite mit Entfernung diakritischer Zeichen. Die Trigramm-Tokenisierung für die CJK-Teilzeichenfolgensuche ist eine zukünftige Verbesserung.

Sitzungssuche im Vergleich zur Speichersuche

Verwenden Sie sessions_search für exakte Wörter oder Ausdrücke aus unbearbeiteten Sitzungstranskripten. Verwenden Sie memory_search für dauerhafte Speicherdateien und semantischen Abruf. Der experimentelle Sitzungsspeicher-Korpus ist die semantische Ergänzung zu dieser exakten Transkriptsuche.