---
read_when:
    - Quieres leer resúmenes de transcripciones almacenados desde la terminal
    - Necesitas la ruta a un resumen Markdown de transcripciones
    - Estás depurando el diseño del almacenamiento de transcripciones del núcleo
summary: Referencia de la CLI para `openclaw transcripts` (listar, mostrar y localizar transcripciones almacenadas)
title: CLI de transcripciones
x-i18n:
    generated_at: "2026-06-27T11:06:21Z"
    model: gpt-5.5
    postprocess_version: locale-links-v1
    provider: openai
    source_hash: ae6010cfb4e051182f1c48d0d728b30d054542e1e7983ff15a2432840193f9c0
    source_path: cli/transcripts.md
    workflow: 16
---

# `openclaw transcripts`

Inspecciona las transcripciones escritas por la herramienta principal `transcripts` de OpenClaw. Esta CLI es de solo lectura; la captura, la importación y el resumen pertenecen a la herramienta del agente y a las fuentes de inicio automático configuradas.

Usa la CLI cuando quieras encontrar las notas de ayer, abrir el archivo Markdown en un editor, enviar una transcripción a otra herramienta o depurar dónde quedó guardada una sesión en el disco. No inicia ni detiene la captura.

Los artefactos se encuentran en el directorio de estado de OpenClaw:

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

El directorio de estado predeterminado es `~/.openclaw`; configura `OPENCLAW_STATE_DIR` para usar uno diferente. El directorio de fecha proviene de la hora de inicio de la sesión, y el directorio de sesión es un segmento seguro del sistema de archivos derivado del id de la sesión.

## Comandos

```bash
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`: enumera las sesiones almacenadas, el selector con fecha, la hora de inicio, el título y la ruta de `summary.md`.
- `show <session>`: imprime el `summary.md` almacenado.
- `path <session>`: imprime la ruta de `summary.md`.
- `path <session> --dir`: imprime el directorio de la sesión.
- `path <session> --metadata`: imprime `metadata.json`.
- `path <session> --transcript`: imprime `transcript.jsonl`.
- `--json`: imprime salida legible por máquina.

Cuando un id de sesión legible por humanos se repite en varios días, usa el selector con fecha de `list`, por ejemplo `openclaw transcripts show 2026-05-22/standup`. Los ids de sesión predeterminados incluyen una marca de tiempo y un sufijo aleatorio; configura ids de sesión fijos solo cuando sean únicos dentro del día.

## Salida

`list` imprime una sesión por línea:

```text
2026-05-22/standup  2026-05-22T09:00:00.000Z  Weekly standup  /Users/alex/.openclaw/transcripts/2026-05-22/standup/summary.md
```

La salida está separada por tabulaciones. Las columnas son selector, hora de inicio, título y ruta del resumen. El selector es el valor más seguro para volver a pasarlo a `show` o `path`.

`list --json` imprime objetos con:

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

`show --json` devuelve los metadatos de sesión almacenados, el selector, el directorio de la sesión, la ruta del resumen y el texto Markdown del resumen. `path --json` devuelve la ruta seleccionada y si ese archivo existe.

## Muchas reuniones por día

Transcripts agrupa las sesiones por fecha y luego por id de sesión. Diez reuniones en un día se convierten en diez carpetas hermanas:

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

Usa ids generados de forma predeterminada para la mayoría de las automatizaciones. Usa un id fijo como `standup` solo cuando el mismo id no se vaya a usar dos veces en la misma fecha.

## Resúmenes faltantes

Las sesiones en vivo escriben `summary.md` cuando la sesión se detiene. Las transcripciones importadas escriben `summary.md` inmediatamente después de la importación. Una sesión aún puede aparecer en `list` sin resumen cuando la captura está activa, un proveedor falló durante la detención o los metadatos se escribieron antes de que llegara cualquier intervención.

Usa `path <session> --transcript` para inspeccionar la transcripción de solo anexado y usa la acción `summarize` de la herramienta `transcripts` para regenerar el resumen Markdown.

## Configuración

La captura de transcripciones es opcional porque las fuentes en vivo pueden unirse al audio de reuniones y grabarlo. Habilita la herramienta con `transcripts.enabled` de nivel superior:

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

Configura las fuentes de inicio automático con `transcripts.autoStart` en `openclaw.json`. Cada entrada se habilita al estar presente; omite una entrada para deshabilitar esa fuente.

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