На этой странице
На этой странице
CLI commands
CLI транскриптов
openclaw transcripts
Инспектор с доступом только для чтения к расшифровкам, созданным инструментом агента transcripts.
Запись, импорт и суммаризация выполняются этим инструментом, а не данным CLI.
Артефакты хранятся в каталоге состояния:
Каталог состояния по умолчанию — ~/.openclaw; его можно переопределить с помощью OPENCLAW_STATE_DIR.
Каталог даты определяется временем начала сеанса; каталог сеанса представляет собой
безопасный для файловой системы идентификатор, сформированный из идентификатора сеанса.
Команды
| Команда | Описание |
|---|---|
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 выводит для каждого сеанса одну строку с полями, разделёнными табуляцией: селектор, время начала, заголовок,
путь к сводке.
Селектор — наиболее безопасное значение для последующей передачи в show или path.
list --json возвращает объекты с sessionId, selector, date, title,
startedAt, stoppedAt, source, path, summaryPath, hasSummary.
show --json возвращает сохранённые метаданные сеанса, селектор, каталог сеанса,
путь к сводке и текст сводки в формате Markdown.
path --json возвращает выбранный путь и признак существования этого файла.
Несколько сеансов в день
Сеансы группируются сначала по дате, затем по идентификатору сеанса. Десять встреч за один день образуют десять соседних каталогов:
Для автоматизации используйте автоматически создаваемые идентификаторы. Используйте фиксированный идентификатор, например standup, только
если он не будет повторяться в ту же дату.
Отсутствующие сводки
Для активных сеансов summary.md записывается при остановке сеанса; для импортированных расшифровок
он записывается сразу после импорта. Сеанс может отображаться в list без
сводки, пока запись ещё активна, если при остановке произошёл сбой провайдера или если
метаданные были записаны до поступления реплик.
Используйте path <session> --transcript для просмотра необработанной расшифровки, доступной только для добавления,
или выполните действие summarize инструмента transcripts, чтобы заново создать сводку
в формате Markdown.
Конфигурация
Запись включается явно (активные источники могут подключаться и записывать звук встречи). Включите её следующим образом:
enabled(по умолчаниюfalse): включить инструмент.maxUtterances(по умолчанию2000, ограничивается диапазоном 1-10000): размер буфера реплик для каждого сеанса.
Настройте источники автоматического запуска с помощью transcripts.autoStart. Каждая запись
включается самим фактом её наличия; чтобы отключить источник, удалите соответствующую запись. discord-voice
— встроенный источник с поддержкой автоматического запуска, которому требуются guildId и
channelId: