Skip to main content
La captura de trayectorias es el registrador de vuelo por sesión de OpenClaw. Registra una cronología estructurada de cada ejecución del agente y, a continuación, /export-trajectory empaqueta la sesión actual en un paquete de soporte redactado que incluye:
  • El prompt, el prompt del sistema y las herramientas enviados al modelo
  • Qué mensajes de la transcripción y llamadas a herramientas condujeron a una respuesta
  • Si la ejecución agotó el tiempo de espera, se canceló, se compactó o encontró un error del proveedor
  • Qué modelo, plugins, Skills y ajustes del entorno de ejecución estaban activos
  • Los metadatos de uso y de la caché de prompts devueltos por el proveedor
Para obtener un informe general de soporte del Gateway, comience con /diagnostics; recopila el paquete saneado del Gateway y, para las sesiones del entorno de OpenAI Codex, puede enviar comentarios de Codex a OpenAI tras su aprobación. Utilice /export-trajectory cuando necesite la cronología detallada por sesión de prompts, herramientas y transcripciones.

​
Inicio rápido

Envíe lo siguiente en la sesión activa (alias /trajectory):
OpenClaw escribe el paquete en el espacio de trabajo:
Indique un nombre de directorio de salida relativo para reemplazarlo:
El nombre se resuelve dentro de .openclaw/trajectory-exports/. Se rechazan las rutas absolutas y las rutas ~. Los paquetes de trayectoria pueden contener prompts, mensajes del modelo, esquemas de herramientas, resultados de herramientas, eventos del entorno de ejecución y rutas locales, por lo que el comando de chat siempre pasa por la aprobación de ejecución. Apruebe la exportación una vez cuando tenga intención de crear el paquete; no utilice la opción de permitir todo. En los chats grupales, OpenClaw envía el prompt de aprobación y el resultado de la exportación al propietario de forma privada, en lugar de publicar los detalles de la trayectoria en la sala compartida. Para la inspección local o los flujos de trabajo de soporte, ejecute directamente el comando subyacente de la CLI:
Otras opciones: --output <path> (nombre del directorio dentro de .openclaw/trajectory-exports), --store <path> (reemplazo del almacén de sesiones), --agent <id> (id. del agente para resolver el almacén), --json (salida estructurada).

​
Acceso

La exportación de trayectorias es un comando del propietario. El remitente debe superar las comprobaciones normales de autorización de comandos, además de la comprobación del propietario del canal.

​
Qué se registra

La captura de trayectorias está activada de forma predeterminada para las ejecuciones de agentes de OpenClaw. Los eventos del entorno de ejecución incluyen:
  • session.started
  • trace.metadata
  • context.compiled
  • prompt.submitted
  • model.fallback_step, incluido el modelo de origen, el modelo siguiente, el motivo y los detalles del fallo, la posición en la cadena y si la cadena avanzó, tuvo éxito o se agotó
  • model.completed
  • trace.artifacts
  • session.ended
Los eventos de la transcripción se reconstruyen a partir de la rama de sesión activa: mensajes del usuario, mensajes del asistente, llamadas a herramientas, resultados de herramientas, compactaciones, cambios de modelo, etiquetas y entradas de sesión personalizadas. Los eventos se escriben como líneas JSON con este marcador de esquema:

​
Archivos del paquete

manifest.json enumera los archivos presentes en un paquete determinado; algunos archivos se omiten cuando la sesión no capturó los datos correspondientes del entorno de ejecución.

​
Almacenamiento de capturas

Los eventos de trayectoria del entorno de ejecución se almacenan con la sesión en la base de datos SQLite por agente. Al exportar una trayectoria, se materializa un paquete de soporte JSONL redactado; la captura activa del entorno de ejecución no es un archivo auxiliar JSONL adyacente a la sesión. Los archivos heredados .trajectory.jsonl y .trajectory-path.json aún pueden aparecer procedentes de versiones anteriores o de exportaciones explícitas de archivos heredados. El mantenimiento de sesiones considera esos archivos objetivos de limpieza; la captura activa escribe filas en la base de datos.

​
Desactivar la captura

Esto desactiva la captura de trayectorias del entorno de ejecución antes de iniciar OpenClaw. /export-trajectory aún puede exportar la rama de la transcripción, pero podrían faltar datos exclusivos del entorno de ejecución, como el contexto compilado, los artefactos del proveedor y los metadatos de prompts.

​
Ajustar el tiempo de espera del vaciado

OpenClaw vacía las filas de trayectorias del entorno de ejecución durante la limpieza del agente. El tiempo de espera predeterminado para la limpieza es de 10,000 ms. En discos lentos o almacenes grandes, configure OPENCLAW_TRAJECTORY_FLUSH_TIMEOUT_MS antes de iniciar OpenClaw:
Esto controla cuándo OpenClaw registra un tiempo de espera openclaw-trajectory-flush y continúa; no cambia los límites de tamaño de la trayectoria. Para ajustar todos los pasos de limpieza del agente que no especifican un tiempo de espera explícito, configure OPENCLAW_AGENT_CLEANUP_TIMEOUT_MS.

​
Privacidad y límites

Los paquetes de trayectorias están destinados al soporte y la depuración, no a su publicación. OpenClaw redacta los valores confidenciales antes de escribir los archivos de exportación:
  • credenciales y campos conocidos de cargas útiles similares a secretos
  • datos de imágenes
  • rutas de estado locales
  • rutas del espacio de trabajo, reemplazadas por $WORKSPACE_DIR
  • rutas del directorio personal, cuando se detectan
El exportador también limita el tamaño de la entrada:
  • captura del entorno de ejecución: la captura activa es una ventana móvil limitada a 10 MiB que descarta los eventos más antiguos para dejar espacio a los nuevos; la exportación acepta archivos auxiliares heredados existentes del entorno de ejecución de hasta 50 MiB
  • archivos de sesión: 50 MiB
  • eventos del entorno de ejecución por exportación: 200,000
  • total de eventos exportados: 250,000
  • las líneas individuales de eventos del entorno de ejecución se truncan por encima de 256 KiB
Revise los paquetes antes de compartirlos fuera del equipo. La redacción se realiza con el máximo esfuerzo posible y no puede conocer todos los secretos específicos de cada aplicación.

​
Solución de problemas

Si la exportación no contiene eventos del entorno de ejecución:
  • confirme que OpenClaw se inició sin OPENCLAW_TRAJECTORY=0
  • ejecute otro mensaje en la sesión y vuelva a exportar
  • inspeccione manifest.json en busca de runtimeEventCount
Si el comando rechaza la ruta de salida:
  • utilice un nombre relativo como bug-1234
  • no indique /tmp/... ni ~/...
  • mantenga la exportación dentro de .openclaw/trajectory-exports/
Si la exportación falla con un error de tamaño, la sesión o el archivo auxiliar superó los límites de seguridad de exportación indicados anteriormente. Inicie una sesión nueva o exporte una reproducción más pequeña.

​
Temas relacionados