> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# CLI транскриптів

# `openclaw transcripts`

Переглядайте транскрипти, записані основним інструментом OpenClaw `transcripts`. Цей CLI доступний
тільки для читання; запис, імпорт і підсумовування належать інструменту агента та
налаштованим джерелам автозапуску.

Використовуйте CLI, коли потрібно знайти вчорашні нотатки, відкрити Markdown-файл у
редакторі, передати транскрипт іншому інструменту або з’ясувати, куди сесія потрапила на
диску. Він не запускає й не зупиняє запис.

Артефакти зберігаються в каталозі стану OpenClaw:

```text theme={"theme":{"light":"min-light","dark":"min-dark"}}
$OPENCLAW_STATE_DIR/transcripts/YYYY-MM-DD/<session>/
  metadata.json
  transcript.jsonl
  summary.json
  summary.md
```

Типовий каталог стану — `~/.openclaw`; задайте `OPENCLAW_STATE_DIR`, щоб використовувати
інший. Каталог дати визначається часом початку сесії, а каталог
сесії є безпечним сегментом файлової системи, отриманим з ідентифікатора сесії.

## Команди

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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`: перелічує збережені сесії, селектор із датою, час початку, назву та шлях до `summary.md`.
* `show <session>`: виводить збережений `summary.md`.
* `path <session>`: виводить шлях до `summary.md`.
* `path <session> --dir`: виводить каталог сесії.
* `path <session> --metadata`: виводить `metadata.json`.
* `path <session> --transcript`: виводить `transcript.jsonl`.
* `--json`: виводить машинозчитуваний результат.

Коли людський ідентифікатор сесії повторюється в різні дні, використовуйте селектор
із датою з `list`, наприклад `openclaw transcripts show 2026-05-22/standup`.
Типові ідентифікатори сесій містять часову позначку та випадковий суфікс; налаштовуйте фіксовані
ідентифікатори сесій лише тоді, коли вони унікальні в межах дня.

## Вивід

`list` виводить по одній сесії на рядок:

```text theme={"theme":{"light":"min-light","dark":"min-dark"}}
2026-05-22/standup  2026-05-22T09:00:00.000Z  Weekly standup  /Users/alex/.openclaw/transcripts/2026-05-22/standup/summary.md
```

Вивід розділений табуляцією. Стовпці: селектор, час початку, назва та
шлях до підсумку. Селектор — найбезпечніше значення для передавання назад у `show` або `path`.

`list --json` виводить об’єкти з:

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

`show --json` повертає збережені метадані сесії, селектор, каталог сесії,
шлях до підсумку та текст підсумку Markdown. `path --json` повертає вибраний шлях
і те, чи існує цей файл.

## Багато зустрічей на день

Транскрипти групують сесії за датою, а потім за ідентифікатором сесії. Десять зустрічей за один
день стають десятьма сусідніми папками:

```text theme={"theme":{"light":"min-light","dark":"min-dark"}}
~/.openclaw/transcripts/2026-05-22/
  transcript-2026-05-22T09-00-00-000Z-a1b2c3d4/
  transcript-2026-05-22T10-30-00-000Z-b2c3d4e5/
  standup/
```

Для більшості автоматизації використовуйте типово згенеровані ідентифікатори. Використовуйте фіксований ідентифікатор, як-от `standup`,
лише тоді, коли той самий ідентифікатор не буде використано двічі в ту саму дату.

## Відсутні підсумки

Живі сесії записують `summary.md`, коли сесія зупиняється. Імпортовані транскрипти
записують `summary.md` одразу після імпорту. Сесія все ще може з’являтися в
`list` без підсумку, коли запис активний, провайдер зазнав помилки під час зупинки
або метадані були записані до надходження будь-яких висловлювань.

Використовуйте `path <session> --transcript`, щоб переглянути транскрипт, який лише дописується, і використовуйте
дію інструмента `transcripts` `summarize`, щоб повторно згенерувати Markdown-підсумок.

## Конфігурація

Запис транскриптів вмикається явно, оскільки живі джерела можуть приєднуватися та записувати
аудіо зустрічей. Увімкніть інструмент за допомогою верхньорівневого `transcripts.enabled`:

```json theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  "transcripts": {
    "enabled": true,
    "maxUtterances": 2000
  }
}
```

Налаштуйте джерела автозапуску за допомогою `transcripts.autoStart` в `openclaw.json`.
Кожен запис вмикається самою наявністю; пропустіть запис, щоб вимкнути це джерело.

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