openclaw transcripts

Inspecione transcrições gravadas pela ferramenta principal transcripts do OpenClaw. Esta CLI é somente leitura; captura, importação e resumo pertencem à ferramenta do agente e às fontes de início automático configuradas.

Use a CLI quando quiser encontrar as notas de ontem, abrir o arquivo Markdown em um editor, enviar uma transcrição para outra ferramenta ou depurar onde uma sessão foi gravada no disco. Ela não inicia nem interrompe a captura.

Os artefatos ficam no diretório de estado do OpenClaw:

$OPENCLAW_STATE_DIR/transcripts/YYYY-MM-DD/<session>/  metadata.json  transcript.jsonl  summary.json  summary.md

O diretório de estado padrão é ~/.openclaw; defina OPENCLAW_STATE_DIR para usar um diretório diferente. O diretório de data vem do horário de início da sessão, e o diretório da sessão é um segmento seguro de sistema de arquivos derivado do id da sessão.

Comandos

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: lista sessões armazenadas, seletor qualificado por data, horário de início, título e caminho de summary.md.
• show <session>: imprime o summary.md armazenado.
• path <session>: imprime o caminho de summary.md.
• path <session> --dir: imprime o diretório da sessão.
• path <session> --metadata: imprime metadata.json.
• path <session> --transcript: imprime transcript.jsonl.
• --json: imprime saída legível por máquina.

Quando um id de sessão humano se repete em vários dias, use o seletor qualificado por data de list, por exemplo openclaw transcripts show 2026-05-22/standup. Ids de sessão padrão incluem um timestamp e um sufixo aleatório; configure ids de sessão fixos somente quando eles forem únicos dentro do dia.

Saída

list imprime uma sessão por linha:

2026-05-22/standup  2026-05-22T09:00:00.000Z  Weekly standup  /Users/alex/.openclaw/transcripts/2026-05-22/standup/summary.md

A saída é separada por tabulações. As colunas são seletor, horário de início, título e caminho do resumo. O seletor é o valor mais seguro para passar de volta para show ou path.

list --json imprime objetos com:

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

show --json retorna os metadados armazenados da sessão, seletor, diretório da sessão, caminho do resumo e texto Markdown do resumo. path --json retorna o caminho selecionado e se esse arquivo existe.

Muitas reuniões por dia

Transcrições agrupa sessões por data e depois por id de sessão. Dez reuniões em um dia viram dez pastas irmãs:

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

Use ids gerados padrão para a maioria das automações. Use um id fixo como standup somente quando o mesmo id não for usado duas vezes na mesma data.

Resumos ausentes

Sessões ao vivo gravam summary.md quando a sessão para. Transcrições importadas gravam summary.md imediatamente após a importação. Uma sessão ainda pode aparecer em list sem resumo quando a captura está ativa, um provedor falhou durante a parada, ou metadados foram gravados antes de qualquer fala chegar.

Use path <session> --transcript para inspecionar a transcrição somente acréscimo, e use a ação summarize da ferramenta transcripts para regenerar o resumo Markdown.

Configuração

A captura de transcrições é opcional porque fontes ao vivo podem entrar e gravar áudio de reuniões. Ative a ferramenta com transcripts.enabled no nível superior:

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

Configure fontes de início automático com transcripts.autoStart em openclaw.json. Cada entrada é ativada por estar presente; omita uma entrada para desativar essa fonte.

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