---
read_when:
    - Anda ingin membaca ringkasan transkrip tersimpan dari terminal
    - Anda memerlukan jalur ke ringkasan transkrip berformat Markdown
    - Anda sedang men-debug tata letak penyimpanan transkrip inti
summary: Referensi CLI untuk `openclaw transcripts` (mencantumkan, menampilkan, dan menemukan transkrip tersimpan)
title: CLI Transkrip
x-i18n:
    generated_at: "2026-07-12T14:07:05Z"
    model: gpt-5.6
    postprocess_version: locale-links-v1
    provider: openai
    source_hash: dde02e924339c64cf6acd5c4b6162785dcfccf4a1df2aac0d9d52d5306511579
    source_path: cli/transcripts.md
    workflow: 16
---

# `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 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
```

| 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"
      }
    ]
  }
}
```