CLICLI de transcription

openclaw transcripts

Inspectez les transcriptions écrites par l’outil principal OpenClawtranscriptsCLI d’OpenClaw. Cette CLI est en lecture seule ; la capture, l’importation et le résumé sont gérés par l’outil agent et les sources de démarrage automatique configurées.

Utilisez la CLI lorsque vous souhaitez trouver les notes d’hier, ouvrir le fichier Markdown dans un éditeur, transmettre une transcription à un autre outil, ou déboguer l’emplacement sur le disque d’une session. Elle ne démarre ni n’arrête pas la capture.

Les artefacts résident dans le répertoire d’état d’OpenClaw :

$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’identifiant de session.

Commandes

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, sélecteur qualifié par date, heure de début, titre et chemin summary.md.
• show <session> : afficher le summary.md stocké.
• path <session> : afficher le chemin 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 identifiant de session humain se répète sur plusieurs jours, utilisez le sélecteur qualifié par date issu de list, par exemple openclaw transcripts show 2026-05-22/standup. Les identifiants de session par défaut incluent un horodatage et un suffixe aléatoire ; configurez des identifiants de session fixes uniquement lorsqu’ils sont uniques dans la journée.

Sortie

list affiche une session par ligne :

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 imprime les 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 si ce fichier existe.

Plusieurs réunions par jour

Transcripts regroupe les sessions par date, puis par identifiant de session. Dix réunions un même jour deviennent dix dossiers frères :

~/.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 la plupart des automatisations. Utilisez un identifiant fixe tel que standup uniquement lorsque le même identifiant ne sera pas utilisé deux fois le même jour.

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 toujours apparaître dans list sans résumé lorsque la capture est active, qu’un fournisseur a échoué lors de l’arrêt, ou que les métadonnées ont été écrites avant l’arrivée de toute énonciation.

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

Configuration

La capture de transcription est opt-in car les sources en direct peuvent rejoindre et enregistrer l’audio de la réunion. Activez le tool avec transcripts.enabled de premier niveau :

{
  "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.

{
  "transcripts": {
    "enabled": true,
    "autoStart": [
      {
        "providerId": "discord-voice",
        "guildId": "1234567890",
        "channelId": "2345678901"
      },
      {
        "providerId": "slack-huddle",
        "accountId": "workspace",
        "channelId": "C123"
      }
    ]
  }
}