openclaw transcripts
transcripts 에이전트 도구가 작성한 트랜스크립트를 위한 읽기 전용 검사기입니다.
캡처, 가져오기 및 요약은 이 CLI가 아니라 해당 도구를 통해 실행됩니다.
아티팩트는 상태 디렉터리 아래에 저장됩니다.
~/.openclaw이며, OPENCLAW_STATE_DIR로 재정의할 수 있습니다.
날짜 디렉터리는 세션 시작 시간에서 가져오며, 세션 디렉터리는 세션 ID에서 파생된
파일 시스템에 안전한 슬러그입니다.
명령어
<session>에는 단독 세션 ID 또는 날짜가 포함된 선택자
(YYYY-MM-DD/<session>)를 사용할 수 있습니다. 동일한 세션 ID가 둘 이상의 날짜에
존재하면 날짜가 포함된 형식을 사용하세요. 예: openclaw transcripts show 2026-05-22/standup. 기본 세션 ID에는 타임스탬프와 무작위 접미사가 포함됩니다.
고정 ID는 해당 날짜 내에서 고유한 경우에만 세션에 지정하세요.
출력
list는 세션마다 선택자, 시작 시간, 제목, 요약 경로를 탭으로 구분한 한 줄을 출력합니다.
show 또는 path에 다시 전달하기에 가장 안전한 값입니다.
list --json은 sessionId, selector, date, title,
startedAt, stoppedAt, source, path, summaryPath, hasSummary가 포함된 객체를 반환합니다.
show --json은 저장된 세션 메타데이터, 선택자, 세션
디렉터리, 요약 경로 및 요약 Markdown 텍스트를 반환합니다.
path --json은 선택한 경로와 해당 파일의 존재 여부를 반환합니다.
하루에 여러 세션
세션은 날짜별로 그룹화된 다음 세션 ID별로 그룹화됩니다. 하루에 회의가 10개 있으면 동일한 상위 디렉터리 아래에 10개의 폴더가 생성됩니다.standup과 같은 고정 ID는
같은 날짜에 반복되지 않을 경우에만 사용하세요.
누락된 요약
라이브 세션은 세션이 중지될 때summary.md를 작성하며, 가져온 트랜스크립트는
가져오기 직후에 이를 작성합니다. 캡처가 아직 활성 상태이거나, 중지 중 공급자에
오류가 발생했거나, 발화가 도착하기 전에 메타데이터가 작성된 경우에는 요약 없이
세션이 list에 표시될 수 있습니다.
추가 전용 원시 트랜스크립트를 검사하려면 path <session> --transcript를 사용하거나,
transcripts 도구의 summarize 작업을 실행하여 Markdown 요약을 다시 생성하세요.
구성
캡처는 선택적으로 활성화할 수 있습니다(라이브 소스가 참여하여 회의 오디오를 녹음할 수 있습니다). 다음과 같이 활성화하세요.enabled(기본값false): 도구를 활성화합니다.maxUtterances(기본값2000, 1~10000으로 제한): 세션별 발화 버퍼 크기입니다.
transcripts.autoStart로 자동 시작 소스를 구성하세요. 각 항목은 존재하면
활성화되며, 해당 소스를 비활성화하려면 항목을 생략하세요. discord-voice는
번들로 제공되는 자동 시작 지원 소스이며 guildId와
channelId가 필요합니다.