openclaw transcripts

Strumento di ispezione in sola lettura per le trascrizioni scritte dallo strumento agente transcripts. L'acquisizione, l'importazione e la riepilogazione vengono eseguite tramite tale strumento, non tramite questa CLI.

Gli artefatti si trovano nella directory di stato:

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

La directory di stato predefinita è ~/.openclaw; è possibile sovrascriverla con OPENCLAW_STATE_DIR. La directory della data deriva dall'ora di inizio della sessione; la directory della sessione è uno slug sicuro per il file system derivato dall'id della sessione.

Comandi

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> accetta un id di sessione semplice oppure un selettore qualificato con la data (YYYY-MM-DD/<session>). Utilizzare la forma qualificata quando lo stesso id di sessione ricorre in più giorni, ad esempio openclaw transcripts show 2026-05-22/standup. Gli id di sessione predefiniti includono un timestamp e un suffisso casuale; assegnare a una sessione un id fisso solo quando tale id è univoco nella giornata.

Output

list stampa una riga separata da tabulazioni per ogni sessione: selettore, ora di inizio, titolo, percorso del riepilogo.

2026-05-22/standup  2026-05-22T09:00:00.000Z  Riunione settimanale  /Users/user/.openclaw/transcripts/2026-05-22/standup/summary.md

Il selettore è il valore più sicuro da passare nuovamente a show o path.

list --json restituisce oggetti con sessionId, selector, date, title, startedAt, stoppedAt, source, path, summaryPath, hasSummary.

show --json restituisce i metadati della sessione archiviata, il selettore, la directory della sessione, il percorso del riepilogo e il testo Markdown del riepilogo.

path --json restituisce il percorso selezionato e indica se il file esiste.

Più sessioni al giorno

Le sessioni vengono raggruppate prima per data e poi per id di sessione. Dieci riunioni in un giorno diventano dieci cartelle allo stesso livello:

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

Utilizzare gli id generati per impostazione predefinita per l'automazione. Utilizzare un id fisso come standup solo quando non verrà ripetuto nella stessa data.

Riepiloghi mancanti

Le sessioni live scrivono summary.md quando la sessione termina; le trascrizioni importate lo scrivono subito dopo l'importazione. Una sessione può comparire in list senza un riepilogo mentre l'acquisizione è ancora attiva, se un provider ha generato un errore durante l'arresto oppure se i metadati sono stati scritti prima dell'arrivo di qualsiasi intervento.

Utilizzare path <session> --transcript per esaminare la trascrizione grezza in sola aggiunta, oppure eseguire l'azione summarize dello strumento transcripts per rigenerare il riepilogo Markdown.

Configurazione

L'acquisizione richiede l'adesione esplicita (le sorgenti live possono partecipare e registrare l'audio della riunione). Abilitarla con:

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

• enabled (valore predefinito false): attiva lo strumento.
• maxUtterances (valore predefinito 2000, limitato all'intervallo 1-10000): dimensione del buffer degli interventi per sessione.

Configurare le sorgenti con avvio automatico tramite transcripts.autoStart. Ogni voce viene abilitata quando è presente; omettere una voce per disabilitare la sorgente corrispondente. discord-voice è la sorgente inclusa che supporta l'avvio automatico e richiede guildId e channelId:

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