openclaw transcripts

Inspetor somente leitura das transcrições gravadas pela ferramenta de agente transcripts. A captura, a importação e a sumarização são executadas por essa ferramenta, não por esta CLI.

Os artefatos ficam no diretório de estado:

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

O diretório de estado padrão é ~/.openclaw; substitua-o com OPENCLAW_STATE_DIR. O diretório de data é determinado pelo horário de início da sessão; o diretório da sessão é um slug seguro para o 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

<session> aceita um ID de sessão simples ou um seletor qualificado por data (YYYY-MM-DD/<session>). Use a forma qualificada quando o mesmo ID de sessão ocorrer em mais de um dia, por exemplo, openclaw transcripts show 2026-05-22/standup. Os IDs de sessão padrão incluem um carimbo de data e hora e um sufixo aleatório; atribua um ID fixo a uma sessão somente quando esse ID for exclusivo no dia.

Saída

list exibe uma linha separada por tabulações para cada sessão: seletor, horário de início, título e caminho do resumo.

2026-05-22/standup  2026-05-22T09:00:00.000Z  Reunião semanal  /Users/user/.openclaw/transcripts/2026-05-22/standup/summary.md

O seletor é o valor mais seguro para passar novamente a show ou path.

list --json retorna objetos com sessionId, selector, date, title, startedAt, stoppedAt, source, path, summaryPath, hasSummary.

show --json retorna os metadados armazenados da sessão, o seletor, o diretório da sessão, o caminho do resumo e o texto do resumo em Markdown.

path --json retorna o caminho selecionado e informa se esse arquivo existe.

Várias sessões por dia

As sessões são agrupadas por data e, depois, por ID da sessão. Dez reuniões em um dia tornam-se 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 os IDs gerados por padrão para automação. Use um ID fixo, como standup, somente quando ele não se repetir na mesma data.

Resumos ausentes

As sessões ao vivo gravam summary.md quando a sessão é encerrada; as transcrições importadas o gravam imediatamente após a importação. Uma sessão pode aparecer em list sem um resumo enquanto a captura ainda estiver ativa, se um provedor falhar durante o encerramento ou se os metadados forem gravados antes da chegada de qualquer fala.

Use path <session> --transcript para inspecionar a transcrição bruta somente para acréscimo ou execute a ação summarize da ferramenta transcripts para gerar novamente o resumo em Markdown.

Configuração

A captura é opcional (fontes ao vivo podem entrar e gravar o áudio da reunião). Ative-a com:

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

• enabled (padrão false): ativa a ferramenta.
• maxUtterances (padrão 2000, limitado a 1-10000): tamanho do buffer de falas por sessão.

Configure as fontes de início automático com transcripts.autoStart. Cada entrada é ativada quando está presente; omita uma entrada para desativar essa fonte. discord-voice é a fonte integrada compatível com início automático e exige guildId e channelId:

{  "transcripts": {    "enabled": true,    "autoStart": [      {        "providerId": "discord-voice",        "guildId": "1234567890",        "channelId": "2345678901"      }    ]  }}