Get started

CLI Transkrip

openclaw transcripts

Pemeriksa hanya-baca untuk transkrip yang ditulis oleh alat agen transcripts. Pengambilan, impor, dan peringkasan dijalankan melalui alat tersebut, bukan CLI ini.

Artefak berada di bawah direktori status:

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

Direktori status bawaan adalah ~/.openclaw; timpa dengan OPENCLAW_STATE_DIR. Direktori tanggal berasal dari waktu mulai sesi; direktori sesi adalah slug yang aman untuk sistem berkas dan berasal dari id sesi.

Perintah

bash
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
Perintah Deskripsi
list Cantumkan sesi yang tersimpan.
show <session> Cetak summary.md yang tersimpan.
path <session> Cetak jalur summary.md.
path <session> --dir Cetak direktori sesi.
path <session> --metadata Cetak metadata.json.
path <session> --transcript Cetak transcript.jsonl.
--json Cetak keluaran yang dapat dibaca mesin (semua subperintah).

<session> menerima id sesi tanpa kualifikasi atau pemilih yang disertai tanggal (YYYY-MM-DD/<session>). Gunakan bentuk berkualifikasi saat id sesi yang sama muncul pada lebih dari satu hari, misalnya openclaw transcripts show 2026-05-22/standup. Id sesi bawaan mencakup stempel waktu dan akhiran acak; berikan id tetap kepada sesi hanya jika id tersebut unik dalam hari itu.

Keluaran

list mencetak satu baris yang dipisahkan tab untuk setiap sesi: pemilih, waktu mulai, judul, jalur ringkasan.

text
2026-05-22/standup  2026-05-22T09:00:00.000Z  Weekly standup  /Users/user/.openclaw/transcripts/2026-05-22/standup/summary.md

Pemilih adalah nilai teraman untuk diteruskan kembali ke show atau path.

list --json mengembalikan objek dengan sessionId, selector, date, title, startedAt, stoppedAt, source, path, summaryPath, hasSummary.

show --json mengembalikan metadata sesi yang tersimpan, pemilih, direktori sesi, jalur ringkasan, dan teks Markdown ringkasan.

path --json mengembalikan jalur yang dipilih dan apakah berkas tersebut ada.

Banyak sesi per hari

Sesi dikelompokkan berdasarkan tanggal, lalu berdasarkan id sesi. Sepuluh rapat dalam satu hari menjadi sepuluh folder sejajar:

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

Gunakan id bawaan yang dihasilkan untuk otomatisasi. Gunakan id tetap seperti standup hanya jika id tersebut tidak akan berulang pada tanggal yang sama.

Ringkasan yang tidak ada

Sesi langsung menulis summary.md saat sesi berhenti; transkrip yang diimpor menulisnya segera setelah impor. Sesi dapat muncul di list tanpa ringkasan saat pengambilan masih aktif, jika penyedia gagal selama penghentian, atau jika metadata ditulis sebelum ada ujaran yang diterima.

Gunakan path <session> --transcript untuk memeriksa transkrip mentah yang hanya dapat ditambahi, atau jalankan tindakan summarize milik alat transcripts untuk membuat ulang ringkasan Markdown.

Konfigurasi

Pengambilan bersifat ikut-serta (sumber langsung dapat bergabung dan merekam audio rapat). Aktifkan dengan:

json
{  "transcripts": {    "enabled": true,    "maxUtterances": 2000  }}
  • enabled (bawaan false): aktifkan alat.
  • maxUtterances (bawaan 2000, dibatasi 1-10000): ukuran penyangga ujaran per sesi.

Konfigurasikan sumber mulai-otomatis dengan transcripts.autoStart. Setiap entri diaktifkan dengan keberadaannya; hilangkan entri untuk menonaktifkan sumber tersebut. discord-voice adalah sumber bawaan yang mendukung mulai-otomatis dan memerlukan guildId serta channelId:

json
{  "transcripts": {    "enabled": true,    "autoStart": [      {        "providerId": "discord-voice",        "guildId": "1234567890",        "channelId": "2345678901"      }    ]  }}
Was this useful?
On this page

On this page