Skip to main content

​
openclaw transcripts

Переглядайте транскрипти, записані основним інструментом OpenClaw transcripts. Цей CLI доступний тільки для читання; запис, імпорт і підсумовування належать інструменту агента та налаштованим джерелам автозапуску. Використовуйте CLI, коли потрібно знайти вчорашні нотатки, відкрити Markdown-файл у редакторі, передати транскрипт іншому інструменту або з’ясувати, куди сесія потрапила на диску. Він не запускає й не зупиняє запис. Артефакти зберігаються в каталозі стану OpenClaw: 
$OPENCLAW_STATE_DIR/transcripts/YYYY-MM-DD/<session>/
  metadata.json
  transcript.jsonl
  summary.json
  summary.md
Типовий каталог стану — ~/.openclaw; задайте OPENCLAW_STATE_DIR, щоб використовувати інший. Каталог дати визначається часом початку сесії, а каталог сесії є безпечним сегментом файлової системи, отриманим з ідентифікатора сесії.

​
Команди

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 виводить по одній сесії на рядок: 
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 повертає вибраний шлях і те, чи існує цей файл.

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

Транскрипти групують сесії за датою, а потім за ідентифікатором сесії. Десять зустрічей за один день стають десятьма сусідніми папками: 
~/.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: 
{
  "transcripts": {
    "enabled": true,
    "maxUtterances": 2000
  }
}
Налаштуйте джерела автозапуску за допомогою transcripts.autoStart в openclaw.json. Кожен запис вмикається самою наявністю; пропустіть запис, щоб вимкнути це джерело. 
{
  "transcripts": {
    "enabled": true,
    "autoStart": [
      {
        "providerId": "discord-voice",
        "guildId": "1234567890",
        "channelId": "2345678901"
      },
      {
        "providerId": "slack-huddle",
        "accountId": "workspace",
        "channelId": "C123"
      }
    ]
  }
}