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, чтобы использовать
другой. Каталог даты берется из времени начала сессии, а каталог
сессии — это безопасный сегмент файловой системы, полученный из id сессии.
Команды
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: вывести машиночитаемый вывод.
Когда человеческий id сессии повторяется в разные дни, используйте селектор с датой
из list, например openclaw transcripts show 2026-05-22/standup.
Стандартные id сессий включают временную метку и случайный суффикс; настраивайте фиксированные
id сессий только тогда, когда они уникальны в пределах дня.
Вывод
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 возвращает выбранный путь
и сведения о том, существует ли этот файл.
Много встреч в день
Transcripts группирует сессии по дате, затем по id сессии. Десять встреч за один день становятся десятью соседними папками:
~/.openclaw/transcripts/2026-05-22/ transcript-2026-05-22T09-00-00-000Z-a1b2c3d4/ transcript-2026-05-22T10-30-00-000Z-b2c3d4e5/ standup/Используйте стандартные сгенерированные id для большей части автоматизации. Используйте фиксированный id, например standup,
только когда тот же id не будет использован дважды в ту же дату.
Отсутствующие сводки
Живые сессии записывают 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" } ] }}