Skip to main content

​
openclaw transcripts

Ispeziona le trascrizioni scritte dallo strumento core transcripts di OpenClaw. Questa CLI è di sola lettura; acquisizione, importazione e riepilogo sono gestiti dallo strumento dell’agente e dalle sorgenti di avvio automatico configurate. Usa la CLI quando vuoi trovare le note di ieri, aprire il file Markdown in un editor, passare una trascrizione a un altro strumento o eseguire il debug di dove una sessione è finita su disco. Non avvia né interrompe l’acquisizione. Gli artefatti si trovano nella directory di stato di OpenClaw: 
$OPENCLAW_STATE_DIR/transcripts/YYYY-MM-DD/<session>/
  metadata.json
  transcript.jsonl
  summary.json
  summary.md
La directory di stato predefinita è ~/.openclaw; imposta OPENCLAW_STATE_DIR per usarne una diversa. La directory della data deriva dall’ora di avvio della sessione, e la directory della sessione è un segmento filesystem sicuro derivato dall’ID della sessione.

​
Comandi

openclaw transcripts list
openclaw 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> --dir
openclaw transcripts path <session> --metadata
openclaw transcripts path <session> --transcript
openclaw transcripts list --json
openclaw transcripts show <session> --json
openclaw transcripts path <session> --json
  • list: elenca le sessioni memorizzate, il selettore qualificato per data, l’ora di avvio, il titolo e il percorso di summary.md.
  • show <session>: stampa il summary.md memorizzato.
  • path <session>: stampa il percorso di summary.md.
  • path <session> --dir: stampa la directory della sessione.
  • path <session> --metadata: stampa metadata.json.
  • path <session> --transcript: stampa transcript.jsonl.
  • --json: stampa output leggibile dalla macchina.
Quando un ID sessione leggibile dall’utente si ripete su più giorni, usa il selettore qualificato per data da list, ad esempio openclaw transcripts show 2026-05-22/standup. Gli ID sessione predefiniti includono un timestamp e un suffisso casuale; configura ID sessione fissi solo quando sono univoci all’interno della giornata.

​
Output

list stampa una sessione per riga: 
2026-05-22/standup  2026-05-22T09:00:00.000Z  Weekly standup  /Users/alex/.openclaw/transcripts/2026-05-22/standup/summary.md
L’output è separato da tabulazioni. Le colonne sono selettore, ora di avvio, titolo e percorso del riepilogo. Il selettore è il valore più sicuro da passare di nuovo a show o path. list --json stampa oggetti con:
  • sessionId
  • selector
  • date
  • title
  • startedAt
  • stoppedAt
  • source
  • path
  • summaryPath
  • hasSummary
show --json restituisce i metadati della sessione memorizzati, 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 quel file esiste.

​
Molte riunioni al giorno

Transcripts raggruppa le sessioni per data, poi per ID sessione. Dieci riunioni in un giorno diventano dieci cartelle sorelle: 
~/.openclaw/transcripts/2026-05-22/
  transcript-2026-05-22T09-00-00-000Z-a1b2c3d4/
  transcript-2026-05-22T10-30-00-000Z-b2c3d4e5/
  standup/
Usa gli ID generati predefiniti per la maggior parte delle automazioni. Usa un ID fisso come standup solo quando lo stesso ID non verrà usato due volte nella stessa data.

​
Riepiloghi mancanti

Le sessioni live scrivono summary.md quando la sessione si interrompe. Le trascrizioni importate scrivono summary.md immediatamente dopo l’importazione. Una sessione può comunque comparire in list senza riepilogo quando l’acquisizione è attiva, un provider ha avuto un errore durante l’interruzione, o i metadati sono stati scritti prima che arrivasse qualsiasi enunciato. Usa path <session> --transcript per ispezionare la trascrizione append-only, e usa l’azione summarize dello strumento transcripts per rigenerare il riepilogo Markdown.

​
Configurazione

L’acquisizione delle trascrizioni è facoltativa perché le sorgenti live possono unirsi e registrare l’audio delle riunioni. Abilita lo strumento con transcripts.enabled al livello superiore: 
{
  "transcripts": {
    "enabled": true,
    "maxUtterances": 2000
  }
}
Configura le sorgenti di avvio automatico con transcripts.autoStart in openclaw.json. Ogni voce viene abilitata quando è presente; ometti una voce per disabilitare quella sorgente. 
{
  "transcripts": {
    "enabled": true,
    "autoStart": [
      {
        "providerId": "discord-voice",
        "guildId": "1234567890",
        "channelId": "2345678901"
      },
      {
        "providerId": "slack-huddle",
        "accountId": "workspace",
        "channelId": "C123"
      }
    ]
  }
}