openclaw transcripts

Inspecteur en lecture seule des transcriptions écrites par l’outil d’agent transcripts. La capture, l’importation et la synthèse s’effectuent au moyen de cet outil, et non de cette CLI.

Les artefacts se trouvent dans le répertoire d’état :

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

Le répertoire d’état par défaut est ~/.openclaw ; remplacez-le avec OPENCLAW_STATE_DIR. Le répertoire de date est déterminé par l’heure de début de la session ; le répertoire de session est un identifiant abrégé compatible avec les systèmes de fichiers, dérivé de l’identifiant de session.

Commandes

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> accepte soit un identifiant de session seul, soit un sélecteur qualifié par une date (YYYY-MM-DD/<session>). Utilisez la forme qualifiée lorsque le même identifiant de session apparaît plusieurs jours, par exemple openclaw transcripts show 2026-05-22/standup. Les identifiants de session par défaut comprennent un horodatage et un suffixe aléatoire ; n’attribuez un identifiant fixe à une session que s’il est unique pour la journée.

Sortie

list affiche une ligne séparée par des tabulations pour chaque session : sélecteur, heure de début, titre, chemin du résumé.

2026-05-22/standup  2026-05-22T09:00:00.000Z  Réunion hebdomadaire  /Users/user/.openclaw/transcripts/2026-05-22/standup/summary.md

Le sélecteur est la valeur la plus sûre à transmettre de nouveau à show ou path.

list --json renvoie des objets contenant sessionId, selector, date, title, startedAt, stoppedAt, source, path, summaryPath, hasSummary.

show --json renvoie les métadonnées stockées de la session, le sélecteur, le répertoire de session, le chemin du résumé et le texte Markdown du résumé.

path --json renvoie le chemin sélectionné et indique si ce fichier existe.

Plusieurs sessions par jour

Les sessions sont regroupées par date, puis par identifiant de session. Dix réunions au cours d’une même journée deviennent dix dossiers voisins :

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

Utilisez les identifiants générés par défaut pour l’automatisation. Utilisez un identifiant fixe tel que standup uniquement s’il ne se répète pas à la même date.

Résumés manquants

Les sessions en direct écrivent summary.md lorsque la session s’arrête ; les transcriptions importées l’écrivent immédiatement après l’importation. Une session peut apparaître dans list sans résumé tant que la capture est encore active, si un fournisseur a échoué lors de l’arrêt, ou si les métadonnées ont été écrites avant l’arrivée du moindre énoncé.

Utilisez path <session> --transcript pour inspecter la transcription brute en ajout uniquement, ou exécutez l’action summarize de l’outil transcripts pour régénérer le résumé Markdown.

Configuration

La capture est facultative (les sources en direct peuvent rejoindre une réunion et enregistrer son audio). Activez-la avec :

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

• enabled (valeur par défaut : false) : active l’outil.
• maxUtterances (valeur par défaut : 2000, limitée à 1-10000) : taille de la mémoire tampon des énoncés pour chaque session.

Configurez les sources à démarrage automatique avec transcripts.autoStart. Chaque entrée est activée par sa présence ; omettez une entrée pour désactiver cette source. discord-voice est la source intégrée compatible avec le démarrage automatique et nécessite guildId et channelId :

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