Skip to main content

​
openclaw transcripts

Prüfen Sie Transkripte, die vom zentralen transcripts-Tool von OpenClaw geschrieben wurden. Diese CLI ist schreibgeschützt; Erfassung, Import und Zusammenfassung gehören zum Agent-Tool und zu den konfigurierten Auto-Start-Quellen. Verwenden Sie die CLI, wenn Sie die Notizen von gestern finden, die Markdown-Datei in einem Editor öffnen, ein Transkript an ein anderes Tool übergeben oder debuggen möchten, wo eine Sitzung auf der Festplatte gelandet ist. Sie startet oder stoppt keine Erfassung. Artefakte liegen unter dem OpenClaw-State-Verzeichnis: 
$OPENCLAW_STATE_DIR/transcripts/YYYY-MM-DD/<session>/
  metadata.json
  transcript.jsonl
  summary.json
  summary.md
Das Standard-State-Verzeichnis ist ~/.openclaw; setzen Sie OPENCLAW_STATE_DIR, um ein anderes zu verwenden. Das Datumsverzeichnis stammt aus der Startzeit der Sitzung, und das Sitzungsverzeichnis ist ein sicheres Dateisystemsegment, das aus der Sitzungs-ID abgeleitet wird.

​
Befehle

openclaw transcripts list
openclaw 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> --dir
openclaw transcripts path <session> --metadata
openclaw transcripts path <session> --transcript
openclaw transcripts list --json
openclaw transcripts show <session> --json
openclaw transcripts path <session> --json
  • list: gespeicherte Sitzungen, datumqualifizierten Selektor, Startzeit, Titel und summary.md-Pfad auflisten.
  • show <session>: die gespeicherte summary.md ausgeben.
  • path <session>: den summary.md-Pfad ausgeben.
  • path <session> --dir: das Sitzungsverzeichnis ausgeben.
  • path <session> --metadata: metadata.json ausgeben.
  • path <session> --transcript: transcript.jsonl ausgeben.
  • --json: maschinenlesbare Ausgabe ausgeben.
Wenn sich eine menschenlesbare Sitzungs-ID über mehrere Tage wiederholt, verwenden Sie den datumqualifizierten Selektor aus list, zum Beispiel openclaw transcripts show 2026-05-22/standup. Standard-Sitzungs-IDs enthalten einen Zeitstempel und ein zufälliges Suffix; konfigurieren Sie feste Sitzungs-IDs nur, wenn sie innerhalb des Tages eindeutig sind.

​
Ausgabe

list gibt eine Sitzung pro Zeile aus: 
2026-05-22/standup  2026-05-22T09:00:00.000Z  Weekly standup  /Users/alex/.openclaw/transcripts/2026-05-22/standup/summary.md
Die Ausgabe ist tabulatorgetrennt. Die Spalten sind Selektor, Startzeit, Titel und Zusammenfassungspfad. Der Selektor ist der sicherste Wert, um ihn an show oder path zurückzugeben. list --json gibt Objekte mit folgenden Feldern aus:
  • sessionId
  • selector
  • date
  • title
  • startedAt
  • stoppedAt
  • source
  • path
  • summaryPath
  • hasSummary
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 und zurück, ob diese Datei existiert.

​
Viele Meetings pro Tag

Transcripts gruppiert Sitzungen nach Datum und dann nach Sitzungs-ID. Zehn Meetings an einem Tag werden zu zehn Geschwisterordnern: 
~/.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 meisten Automatisierungen die standardmäßig generierten IDs. Verwenden Sie eine feste ID wie standup nur, wenn dieselbe ID am selben Datum nicht zweimal verwendet wird.

​
Fehlende Zusammenfassungen

Live-Sitzungen schreiben summary.md, wenn die Sitzung stoppt. Importierte Transkripte schreiben summary.md unmittelbar nach dem Import. Eine Sitzung kann dennoch in list ohne Zusammenfassung erscheinen, wenn die Erfassung aktiv ist, ein Provider beim Stoppen fehlgeschlagen ist oder Metadaten geschrieben wurden, bevor Äußerungen eingegangen sind. Verwenden Sie path <session> --transcript, um das nur erweiterte Transkript zu prüfen, und verwenden Sie die summarize-Aktion des transcripts-Tools, um die Markdown-Zusammenfassung neu zu generieren.

​
Konfiguration

Die Transkripterfassung ist opt-in, da Live-Quellen Meeting-Audio beitreten und aufzeichnen können. Aktivieren Sie das Tool mit dem obersten transcripts.enabled: 
{
  "transcripts": {
    "enabled": true,
    "maxUtterances": 2000
  }
}
Konfigurieren Sie Auto-Start-Quellen mit transcripts.autoStart in openclaw.json. Jeder Eintrag wird durch seine Anwesenheit aktiviert; lassen Sie einen Eintrag weg, um diese Quelle zu deaktivieren. 
{
  "transcripts": {
    "enabled": true,
    "autoStart": [
      {
        "providerId": "discord-voice",
        "guildId": "1234567890",
        "channelId": "2345678901"
      },
      {
        "providerId": "slack-huddle",
        "accountId": "workspace",
        "channelId": "C123"
      }
    ]
  }
}