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

# `openclaw transcripts`

Periksa transkrip yang ditulis oleh alat inti `transcripts` OpenClaw. CLI ini
bersifat hanya-baca; penangkapan, impor, dan peringkasan dimiliki oleh alat agen
dan sumber mulai-otomatis yang dikonfigurasi.

Gunakan CLI saat Anda ingin menemukan catatan kemarin, membuka file Markdown di
editor, memasukkan transkrip ke alat lain, atau men-debug lokasi sesi tersimpan
di disk. Ini tidak memulai atau menghentikan penangkapan.

Artefak berada di bawah direktori status OpenClaw:

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

Direktori status default adalah `~/.openclaw`; atur `OPENCLAW_STATE_DIR` untuk
menggunakan direktori lain. Direktori tanggal berasal dari waktu mulai sesi, dan
direktori sesi adalah segmen sistem file aman yang diturunkan 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
```

- `list`: mencantumkan sesi yang tersimpan, pemilih berkualifikasi tanggal, waktu mulai, judul, dan path `summary.md`.
- `show <session>`: mencetak `summary.md` yang tersimpan.
- `path <session>`: mencetak path `summary.md`.
- `path <session> --dir`: mencetak direktori sesi.
- `path <session> --metadata`: mencetak `metadata.json`.
- `path <session> --transcript`: mencetak `transcript.jsonl`.
- `--json`: mencetak output yang dapat dibaca mesin.

Saat id sesi manusia berulang di beberapa hari, gunakan pemilih berkualifikasi
tanggal dari `list`, misalnya `openclaw transcripts show 2026-05-22/standup`.
Id sesi default menyertakan timestamp dan sufiks acak; konfigurasikan id sesi
tetap hanya saat id tersebut unik dalam satu hari.

## Output

`list` mencetak satu sesi per baris:

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

Output dipisahkan dengan tab. Kolomnya adalah pemilih, waktu mulai, judul, dan
path ringkasan. Pemilih adalah nilai paling aman untuk diteruskan kembali ke
`show` atau `path`.

`list --json` mencetak objek dengan:

- `sessionId`
- `selector`
- `date`
- `title`
- `startedAt`
- `stoppedAt`
- `source`
- `path`
- `summaryPath`
- `hasSummary`

`show --json` mengembalikan metadata sesi yang tersimpan, pemilih, direktori sesi,
path ringkasan, dan teks Markdown ringkasan. `path --json` mengembalikan path
yang dipilih dan apakah file tersebut ada.

## Banyak rapat per hari

Transkrip mengelompokkan sesi 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 default yang dihasilkan untuk sebagian besar otomatisasi. Gunakan id tetap seperti `standup`
hanya saat id yang sama tidak akan digunakan dua kali pada tanggal yang sama.

## Ringkasan hilang

Sesi langsung menulis `summary.md` saat sesi berhenti. Transkrip yang diimpor
menulis `summary.md` segera setelah impor. Sesi tetap dapat muncul di
`list` tanpa ringkasan saat penangkapan aktif, provider gagal saat berhenti,
atau metadata ditulis sebelum ada ujaran yang masuk.

Gunakan `path <session> --transcript` untuk memeriksa transkrip append-only, dan gunakan
aksi alat `transcripts` `summarize` untuk membuat ulang ringkasan Markdown.

## Konfigurasi

Penangkapan transkrip bersifat opt-in karena sumber langsung dapat bergabung dan merekam audio
rapat. Aktifkan alat dengan `transcripts.enabled` tingkat atas:

```json
{
  "transcripts": {
    "enabled": true,
    "maxUtterances": 2000
  }
}
```

Konfigurasikan sumber mulai-otomatis dengan `transcripts.autoStart` di `openclaw.json`.
Setiap entri diaktifkan dengan keberadaannya; hilangkan entri untuk menonaktifkan sumber tersebut.

```json
{
  "transcripts": {
    "enabled": true,
    "autoStart": [
      {
        "providerId": "discord-voice",
        "guildId": "1234567890",
        "channelId": "2345678901"
      },
      {
        "providerId": "slack-huddle",
        "accountId": "workspace",
        "channelId": "C123"
      }
    ]
  }
}
```