Get started
CLI транскриптів
openclaw transcripts
Інспектор лише для читання транскриптів, записаних інструментом агента transcripts.
Захоплення, імпорт і узагальнення виконуються через цей інструмент, а не через цей CLI.
Артефакти зберігаються в каталозі стану:
$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> --json| Команда | Опис |
|---|---|
list |
Вивести список збережених сеансів. |
show <session> |
Вивести збережений файл summary.md. |
path <session> |
Вивести шлях до summary.md. |
path <session> --dir |
Вивести каталог сеансу. |
path <session> --metadata |
Вивести шлях до metadata.json. |
path <session> --transcript |
Вивести шлях до transcript.jsonl. |
--json |
Вивести машиночитаний результат (для будь-якої підкоманди). |
<session> приймає або звичайний ідентифікатор сеансу, або селектор із датою
(YYYY-MM-DD/<session>). Використовуйте форму з датою, якщо той самий ідентифікатор
сеансу трапляється більш ніж в один день, наприклад openclaw transcripts show 2026-05-22/standup. Стандартні ідентифікатори сеансів містять позначку часу та випадковий
суфікс; задавайте сеансу фіксований ідентифікатор лише тоді, коли він унікальний у межах дня.
Вивід
list виводить для кожного сеансу один рядок із полями, розділеними табуляцією: селектор, час початку, назва,
шлях до підсумку.
2026-05-22/standup 2026-05-22T09:00:00.000Z Щотижнева нарада /Users/user/.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 після завершення сеансу; імпортовані транскрипти
записують його одразу після імпорту. Сеанс може з’явитися в list без
підсумку, поки захоплення ще триває, якщо сталася помилка постачальника під час зупинення або якщо
метадані було записано до надходження будь-яких висловлювань.
Використовуйте path <session> --transcript, щоб переглянути необроблений транскрипт, доступний лише для дописування,
або виконайте дію summarize інструмента transcripts, щоб повторно створити підсумок
у форматі Markdown.
Конфігурація
Захоплення вмикається за бажанням (джерела наживо можуть приєднуватися та записувати аудіо зустрічі). Увімкніть його так:
{ "transcripts": { "enabled": true, "maxUtterances": 2000 }}enabled(стандартноfalse): увімкнути інструмент.maxUtterances(стандартно2000, обмежується діапазоном 1–10000): розмір буфера висловлювань для кожного сеансу.
Налаштуйте джерела автоматичного запуску за допомогою transcripts.autoStart. Кожен запис
вмикається своєю наявністю; вилучіть запис, щоб вимкнути відповідне джерело. discord-voice
— вбудоване джерело з підтримкою автоматичного запуску, яке потребує guildId і
channelId:
{ "transcripts": { "enabled": true, "autoStart": [ { "providerId": "discord-voice", "guildId": "1234567890", "channelId": "2345678901" } ] }}