openclaw transcripts

OpenClaw의 핵심 transcripts 도구가 작성한 트랜스크립트를 검사합니다. 이 CLI는 읽기 전용이며, 캡처, 가져오기, 요약은 에이전트 도구와 구성된 자동 시작 소스가 담당합니다.

어제의 노트를 찾거나, 편집기에서 Markdown 파일을 열거나, 트랜스크립트를 다른 도구에 전달하거나, 세션이 디스크의 어디에 저장되었는지 디버그하려는 경우 CLI를 사용하세요. 이 CLI는 캡처를 시작하거나 중지하지 않습니다.

아티팩트는 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> --json

• list: 저장된 세션, 날짜가 포함된 선택자, 시작 시간, 제목, 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은 다음 항목이 있는 객체를 출력합니다.

• sessionId
• selector
• date
• title
• startedAt
• stoppedAt
• source
• path
• summaryPath
• hasSummary

show --json은 저장된 세션 메타데이터, 선택자, 세션 디렉터리, 요약 경로, 요약 Markdown 텍스트를 반환합니다. path --json은 선택된 경로와 해당 파일의 존재 여부를 반환합니다.

하루에 많은 회의

트랜스크립트는 세션을 날짜별로 그룹화한 다음 세션 ID별로 그룹화합니다. 하루에 열 개의 회의가 있으면 같은 계층의 폴더 열 개가 됩니다.

~/.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는 같은 날짜에 같은 ID가 두 번 사용되지 않을 때만 사용하세요.

누락된 요약

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

추가 전용 트랜스크립트를 검사하려면 path <session> --transcript를 사용하고, Markdown 요약을 다시 생성하려면 transcripts 도구 작업 summarize를 사용하세요.

구성

라이브 소스가 회의 오디오에 참여하고 녹음할 수 있으므로 트랜스크립트 캡처는 옵트인입니다. 최상위 transcripts.enabled로 도구를 활성화하세요.

{  "transcripts": {    "enabled": true,    "maxUtterances": 2000  }}

openclaw.json의 transcripts.autoStart로 자동 시작 소스를 구성하세요. 각 항목은 존재하는 것만으로 활성화됩니다. 해당 소스를 비활성화하려면 항목을 생략하세요.

{  "transcripts": {    "enabled": true,    "autoStart": [      {        "providerId": "discord-voice",        "guildId": "1234567890",        "channelId": "2345678901"      },      {        "providerId": "slack-huddle",        "accountId": "workspace",        "channelId": "C123"      }    ]  }}