Get started
CLI транскриптів
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 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> --jsonlist: перелічує збережені сесії, селектор із датою, час початку, назву та шлях до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 виводить об’єкти з:
sessionIdselectordatetitlestartedAtstoppedAtsourcepathsummaryPathhasSummary
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" } ] }}