--- read_when: - Sie möchten gespeicherte Transkriptzusammenfassungen im Terminal lesen - Sie benötigen den Pfad zu einer Markdown-Zusammenfassung der Transkripte. - Sie debuggen das Speicherlayout der Kerntranskripte summary: CLI-Referenz für `openclaw transcripts` (gespeicherte Transkripte auflisten, anzeigen und exportieren) title: Transkript-CLI x-i18n: generated_at: "2026-07-26T17:46:21Z" model: gpt-5.6 postprocess_version: locale-links-v1 prompt_version: 32 provider: openai source_hash: c04ba637fb46ec271383b2f0d17655e18018e07f489c34dc3fd14ad926f27aa4 source_path: cli/transcripts.md workflow: 16 --- # `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: ```text $OPENCLAW_STATE_DIR/transcripts/YYYY-MM-DD// 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 ```bash openclaw transcripts list openclaw transcripts show openclaw transcripts show YYYY-MM-DD/ openclaw transcripts path openclaw transcripts path YYYY-MM-DD/ openclaw transcripts path --dir openclaw transcripts path --metadata openclaw transcripts path --transcript openclaw transcripts list --json openclaw transcripts show --json openclaw transcripts path --json ``` | Befehl | Beschreibung | | ----------------------------- | ------------------------------------------------------------- | | `list` | Gespeicherte Sitzungen auflisten. | | `show ` | `summary.md` ausgeben und materialisieren. | | `path ` | Den Pfad `summary.md` materialisieren und ausgeben. | | `path --dir` | Alle Artefakte materialisieren und ihr Verzeichnis ausgeben. | | `path --metadata` | `metadata.json` materialisieren und ausgeben. | | `path --transcript` | `transcript.jsonl` materialisieren und ausgeben. | | `--json` | Maschinenlesbare Ausgabe erzeugen (jeder Unterbefehl). | `` akzeptiert entweder eine einfache Sitzungs-ID oder einen datumsqualifizierten Selektor (`YYYY-MM-DD/`). 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. ```text 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: ```text ~/.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 --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: ```bash 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: ```json { "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`: ```json { "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`.