> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# CLI des transcriptions

# `openclaw transcripts`

Inspecter les transcriptions écrites par l’outil principal `transcripts` d’OpenClaw. Cette CLI est
en lecture seule ; la capture, l’importation et la synthèse appartiennent à l’outil d’agent et
aux sources de démarrage automatique configurées.

Utilisez la CLI lorsque vous voulez retrouver les notes d’hier, ouvrir le fichier Markdown dans
un éditeur, fournir une transcription à un autre outil ou déboguer l’emplacement où une session a été enregistrée sur
le disque. Elle ne démarre ni n’arrête la capture.

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

```text theme={"theme":{"light":"min-light","dark":"min-dark"}}
$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` ; définissez `OPENCLAW_STATE_DIR` pour en utiliser un
autre. Le répertoire de date provient de l’heure de début de la session, et le
répertoire de session est un segment de système de fichiers sûr dérivé de l’id de session.

## Commandes

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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` : lister les sessions stockées, le sélecteur qualifié par date, l’heure de début, le titre et le chemin de `summary.md`.
* `show <session>` : afficher le fichier `summary.md` stocké.
* `path <session>` : afficher le chemin de `summary.md`.
* `path <session> --dir` : afficher le répertoire de session.
* `path <session> --metadata` : afficher `metadata.json`.
* `path <session> --transcript` : afficher `transcript.jsonl`.
* `--json` : afficher une sortie lisible par machine.

Lorsqu’un id de session lisible par un humain se répète sur plusieurs jours, utilisez le sélecteur qualifié par date
fourni par `list`, par exemple `openclaw transcripts show 2026-05-22/standup`.
Les ids de session par défaut incluent un horodatage et un suffixe aléatoire ; configurez des
ids de session fixes uniquement lorsqu’ils sont uniques au sein de la journée.

## Sortie

`list` affiche une session par ligne :

```text theme={"theme":{"light":"min-light","dark":"min-dark"}}
2026-05-22/standup  2026-05-22T09:00:00.000Z  Weekly standup  /Users/alex/.openclaw/transcripts/2026-05-22/standup/summary.md
```

La sortie est séparée par des tabulations. Les colonnes sont le sélecteur, l’heure de début, le titre et le
chemin du résumé. Le sélecteur est la valeur la plus sûre à repasser à `show` ou `path`.

`list --json` affiche des objets avec :

* `sessionId`
* `selector`
* `date`
* `title`
* `startedAt`
* `stoppedAt`
* `source`
* `path`
* `summaryPath`
* `hasSummary`

`show --json` renvoie les métadonnées de session stockées, 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.

## Nombreuses réunions par jour

Transcripts regroupe les sessions par date, puis par id de session. Dix réunions en une
journée deviennent dix dossiers frères :

```text theme={"theme":{"light":"min-light","dark":"min-dark"}}
~/.openclaw/transcripts/2026-05-22/
  transcript-2026-05-22T09-00-00-000Z-a1b2c3d4/
  transcript-2026-05-22T10-30-00-000Z-b2c3d4e5/
  standup/
```

Utilisez les ids générés par défaut pour la plupart des automatisations. Utilisez un id fixe tel que `standup`
uniquement lorsque le même id ne sera pas utilisé deux fois à 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
écrivent `summary.md` immédiatement après l’importation. Une session peut encore apparaître dans
`list` sans résumé lorsque la capture est active, qu’un fournisseur a échoué pendant l’arrêt,
ou que les métadonnées ont été écrites avant l’arrivée de toute prise de parole.

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

## Configuration

La capture de transcription est facultative, car les sources en direct peuvent rejoindre et enregistrer l’audio
d’une réunion. Activez l’outil avec `transcripts.enabled` au niveau supérieur :

```json theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  "transcripts": {
    "enabled": true,
    "maxUtterances": 2000
  }
}
```

Configurez les sources de démarrage automatique avec `transcripts.autoStart` dans `openclaw.json`.
Chaque entrée est activée par sa présence ; omettez une entrée pour désactiver cette source.

```json theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  "transcripts": {
    "enabled": true,
    "autoStart": [
      {
        "providerId": "discord-voice",
        "guildId": "1234567890",
        "channelId": "2345678901"
      },
      {
        "providerId": "slack-huddle",
        "accountId": "workspace",
        "channelId": "C123"
      }
    ]
  }
}
```