openclaw transcripts

transcripts 에이전트 도구가 작성한 트랜스크립트를 위한 읽기 전용 검사기입니다. 캡처, 가져오기 및 요약은 이 CLI가 아니라 해당 도구를 통해 실행됩니다.

아티팩트는 상태 디렉터리 아래에 저장됩니다.

$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> --json

<session>에는 단독 세션 ID 또는 날짜가 포함된 선택자 (YYYY-MM-DD/<session>)를 사용할 수 있습니다. 동일한 세션 ID가 둘 이상의 날짜에 존재하면 날짜가 포함된 형식을 사용하세요. 예: openclaw transcripts show 2026-05-22/standup. 기본 세션 ID에는 타임스탬프와 무작위 접미사가 포함됩니다. 고정 ID는 해당 날짜 내에서 고유한 경우에만 세션에 지정하세요.

출력

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은 선택한 경로와 해당 파일의 존재 여부를 반환합니다.

하루에 여러 세션

세션은 날짜별로 그룹화된 다음 세션 ID별로 그룹화됩니다. 하루에 회의가 10개 있으면 동일한 상위 디렉터리 아래에 10개의 폴더가 생성됩니다.

~/.openclaw/transcripts/2026-05-22/  transcript-2026-05-22T09-00-00-000Z-a1b2c3d4/  transcript-2026-05-22T10-30-00-000Z-b2c3d4e5/  standup/

자동화에는 기본으로 생성되는 ID를 사용하세요. standup과 같은 고정 ID는 같은 날짜에 반복되지 않을 경우에만 사용하세요.

누락된 요약

라이브 세션은 세션이 중지될 때 summary.md를 작성하며, 가져온 트랜스크립트는 가져오기 직후에 이를 작성합니다. 캡처가 아직 활성 상태이거나, 중지 중 공급자에 오류가 발생했거나, 발화가 도착하기 전에 메타데이터가 작성된 경우에는 요약 없이 세션이 list에 표시될 수 있습니다.

추가 전용 원시 트랜스크립트를 검사하려면 path <session> --transcript를 사용하거나, transcripts 도구의 summarize 작업을 실행하여 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"      }    ]  }}