openclaw transcripts

Inspektions- und Exportbefehl für dauerhaft gespeicherte Besprechungstranskripte. Browser-Teilnehmer von Google Meet, Microsoft Teams und Zoom erfassen automatisch Notizen; das Agent-Tool transcripts unterstützt außerdem die Erfassung über Provider und den manuellen Import.

Der kanonische Transkriptstatus befindet sich in der gemeinsam genutzten SQLite-Datenbank unter $OPENCLAW_STATE_DIR/state/openclaw.sqlite. show und path materialisieren ausdrücklich benutzersichtbare Artefakte im Statusverzeichnis:

$OPENCLAW_STATE_DIR/transcripts/YYYY-MM-DD/<session>/  metadata.json  transcript.jsonl  summary.json  summary.md

Diese Dateien sind Exporte und kein zweiter Laufzeitspeicher. OpenClaw liest sie während der Erfassung, Zusammenfassung oder Auflistung nicht wieder ein. Das standardmäßige Statusverzeichnis ist ~/.openclaw; überschreiben Sie es mit OPENCLAW_STATE_DIR. Das Datumsverzeichnis ergibt sich aus der Startzeit der Sitzung; das Sitzungsverzeichnis ist ein dateisystemsicherer Slug, der aus der Sitzungs-ID abgeleitet wird.

Befehle

openclaw transcripts listopenclaw transcripts show <session>openclaw transcripts show YYYY-MM-DD/<session>openclaw transcripts path <session>openclaw transcripts path YYYY-MM-DD/<session>openclaw transcripts path <session> --diropenclaw transcripts path <session> --metadataopenclaw transcripts path <session> --transcriptopenclaw transcripts list --jsonopenclaw transcripts show <session> --jsonopenclaw transcripts path <session> --json

<session> akzeptiert entweder eine einfache Sitzungs-ID oder einen datumsqualifizierten Selektor (YYYY-MM-DD/<session>). Verwenden Sie die qualifizierte Form, wenn dieselbe Sitzungs-ID an mehr als einem Tag vorkommt, beispielsweise openclaw transcripts show 2026-05-22/standup. Standardmäßige Sitzungs-IDs enthalten einen Zeitstempel und ein zufälliges Suffix; weisen Sie einer Sitzung nur dann eine feste ID zu, wenn diese ID innerhalb des Tages eindeutig ist.

Ausgabe

list gibt pro Sitzung eine tabulatorgetrennte Zeile aus: Selektor, Startzeit, Titel, Zusammenfassungspfad.

2026-05-22/standup  2026-05-22T09:00:00.000Z  Wöchentliches Stand-up  /Users/user/.openclaw/transcripts/2026-05-22/standup/summary.md

Der Selektor ist der sicherste Wert, den Sie wieder an show oder path übergeben können.

list --json gibt Objekte mit sessionId, selector, date, title, startedAt, stoppedAt, source, path, summaryPath, hasSummary zurück. Gespeicherte Quell-URLs von Besprechungen enthalten nur Ursprung und Pfad; Abfragezeichenfolgen, Fragmente und eingebettete Anmeldedaten werden vor der dauerhaften Speicherung entfernt.

show --json gibt die gespeicherten Sitzungsmetadaten, den Selektor, das Sitzungsverzeichnis, den Zusammenfassungspfad und den Markdown-Text der Zusammenfassung zurück.

path --json gibt den ausgewählten Pfad zurück und zeigt an, ob dieses Artefakt materialisiert werden konnte. Metadaten- und Transkriptexporte sind für eine gespeicherte Sitzung immer vorhanden; ein Zusammenfassungspfad meldet exists: false, bis für die Sitzung eine Zusammenfassung vorliegt.

Mehrere Sitzungen pro Tag

Sitzungen werden zunächst nach Datum und anschließend nach Sitzungs-ID gruppiert. Zehn Besprechungen an einem Tag ergeben zehn gleichgeordnete Ordner:

~/.openclaw/transcripts/2026-05-22/  transcript-2026-05-22T09-00-00-000Z-a1b2c3d4/  transcript-2026-05-22T10-30-00-000Z-b2c3d4e5/  standup/

Verwenden Sie für die Automatisierung standardmäßig generierte IDs. Verwenden Sie eine feste ID wie standup nur, wenn sie am selben Datum nicht erneut vorkommt.

Fehlende Zusammenfassungen

Live-Sitzungen speichern und materialisieren summary.md, wenn die Sitzung beendet wird; importierte Transkripte tun dies unmittelbar nach dem Import. Eine Sitzung kann ohne Zusammenfassung in list erscheinen, solange die Erfassung noch aktiv ist, wenn ein Provider beim Beenden fehlgeschlagen ist oder wenn Metadaten gespeichert wurden, bevor Äußerungen eingegangen sind.

Verwenden Sie path <session> --transcript, um das unverarbeitete, ausschließlich angehängte Transkript zu prüfen, oder führen Sie die Aktion summarize des Tools transcripts aus, um die Markdown- Zusammenfassung neu zu erzeugen.

Upgrade des veralteten Dateispeichers

OpenClaw-Versionen vor Einführung des SQLite-Speichers schrieben den kanonischen Laufzeitstatus direkt unter $OPENCLAW_STATE_DIR/transcripts/. Führen Sie Folgendes aus:

openclaw doctor --fix

Doctor importiert den vollständigen veralteten Verzeichnisbaum in SQLite, überprüft Zeilenanzahl und Reihenfolge, zeichnet Migrationsbelege auf und verschiebt den überprüften Quellverzeichnisbaum in ein mit einem Zeitstempel versehenes Archiv unter transcripts.migrated-*. Laufzeitbefehle greifen nicht ersatzweise auf die veralteten Dateien zurück. Bewahren Sie das Archiv auf, bis Sie die importierten Sitzungen und alle Exporte, auf die Sie angewiesen sind, überprüft haben.

Konfiguration

Die Erfassung von Besprechungstranskripten ist standardmäßig aktiviert. So deaktivieren Sie sie global:

{  "transcripts": {    "enabled": false  }}

• enabled (Standardwert true): Aktiviert automatische Besprechungsnotizen, das Transkript- Tool und konfigurierte Quellen für den automatischen Start. Setzen Sie den Wert auf false, wenn Besprechungsnotizen nicht dauerhaft auf dem Host gespeichert werden sollen. Ein ausdrücklich angeforderter Besprechungsmodus transcribe behält seinen bestehenden begrenzten Live-Untertitelverlauf bei, schreibt jedoch keine dauerhaft gespeicherten Zeilen, solange diese Einstellung deaktiviert ist. Konfigurieren Sie Quellen für den automatischen Start mit transcripts.autoStart. Jeder Eintrag wird durch seine Anwesenheit aktiviert; lassen Sie einen Eintrag weg, um diese Quelle zu deaktivieren. discord-voice ist die mitgelieferte Quelle mit Unterstützung für den automatischen Start und erfordert guildId und channelId:

{  "transcripts": {    "enabled": true,    "autoStart": [      {        "providerId": "discord-voice",        "guildId": "1234567890",        "channelId": "2345678901"      }    ]  }}

Die IDs der Besprechungs-Provider lauten google-meet, teams und zoom. Ihre Aliasse sind googlemeet/meet, teams-meetings/microsoft-teams/msteams beziehungsweise zoom-meetings. Besprechungs-Provider werden einer bereits aktiven Besprechungsbot-Sitzung zugeordnet; normale Beitritte zu Besprechungen benötigen keinen Eintrag autoStart.