/export-trajectory empaqueta la
sesión actual en un paquete de soporte redactado que cubre:
- El prompt, el prompt del sistema y las herramientas enviadas al modelo
- Qué mensajes de transcripción y llamadas a herramientas condujeron a una respuesta
- Si la ejecución agotó el tiempo de espera, se abortó, hizo Compaction o encontró un error del proveedor
- Qué modelo, plugins, Skills y ajustes de runtime estaban activos
- Metadatos de uso y de caché de prompts devueltos por el proveedor
/diagnostics; recopila el
paquete saneado del Gateway y, para sesiones del arnés de OpenAI Codex, puede enviar comentarios de Codex
a OpenAI tras la aprobación. Usa /export-trajectory cuando necesites la
cronología detallada por sesión de prompts, herramientas y transcripción.
Inicio rápido
Envía en la sesión activa (alias/trajectory):
.openclaw/trajectory-exports/. Las rutas absolutas y
las rutas ~ se rechazan.
Los paquetes de trayectoria pueden contener prompts, mensajes del modelo, esquemas de herramientas, resultados de herramientas,
eventos de runtime y rutas locales, por lo que el comando de chat siempre se ejecuta
mediante aprobación de exec. Aprueba la exportación una vez cuando quieras crear el
paquete; no uses allow-all. En chats grupales, OpenClaw envía el
prompt de aprobación y el resultado de exportación al propietario en privado en lugar de publicar detalles de trayectoria
en la sala compartida.
Para inspección local o flujos de trabajo de soporte, ejecuta directamente el comando CLI
subyacente:
--output <path> (nombre de directorio dentro de
.openclaw/trajectory-exports), --store <path> (sobrescritura del almacén de sesiones),
--agent <id> (id de agente para la resolución del almacén), --json (salida estructurada).
Acceso
La exportación de trayectoria es un comando de propietario. El remitente debe superar las comprobaciones normales de autorización de comandos más la comprobación de propietario para el canal.Qué se registra
La captura de trayectoria está activada de forma predeterminada para las ejecuciones de agentes de OpenClaw. Los eventos de runtime incluyen:session.startedtrace.metadatacontext.compiledprompt.submittedmodel.fallback_step, incluido el modelo de origen, el siguiente modelo, el motivo/detalle del fallo, la posición en la cadena y si la cadena avanzó, tuvo éxito o se agotómodel.completedtrace.artifactssession.ended
Archivos del paquete
| Archivo | Contenido |
|---|---|
manifest.json | Esquema del paquete, archivos de origen, recuentos de eventos y lista de archivos generados |
events.jsonl | Cronología ordenada de runtime y transcripción |
session-branch.json | Rama de transcripción activa redactada y encabezado de sesión |
metadata.json | Versión de OpenClaw, SO/runtime, modelo, instantánea de configuración, plugins, Skills y metadatos de prompts |
artifacts.json | Estado final, errores, uso, caché de prompts, recuento de Compaction, texto del asistente y metadatos de herramientas |
prompts.json | Prompts enviados y detalles seleccionados de construcción de prompts |
system-prompt.txt | Último prompt del sistema compilado, cuando se captura |
tools.json | Definiciones de herramientas enviadas al modelo, cuando se capturan |
manifest.json enumera los archivos presentes en un paquete determinado; algunos archivos se
omiten cuando la sesión no capturó los datos de runtime correspondientes.
Ubicación de captura
De forma predeterminada, los eventos de trayectoria de runtime se escriben junto al archivo de sesión:OPENCLAW_TRAJECTORY_DIR para almacenar los sidecars de trayectoria de runtime en un
directorio dedicado, un archivo JSONL por id de sesión:
Desactivar captura
/export-trajectory todavía puede exportar la rama de transcripción, pero pueden faltar archivos
solo de runtime, como contexto compilado, artefactos del proveedor y metadatos de prompts.
Ajustar tiempo de espera de vaciado
OpenClaw vacía los sidecars de trayectoria de runtime durante la limpieza del agente. El tiempo de espera de limpieza predeterminado es de 10,000 ms. En discos lentos o almacenes grandes, estableceOPENCLAW_TRAJECTORY_FLUSH_TIMEOUT_MS antes de iniciar OpenClaw:
openclaw-trajectory-flush y
continúa; no cambia los límites de tamaño de trayectoria. Para ajustar todos los pasos de
limpieza del agente que no pasan un tiempo de espera explícito, establece
OPENCLAW_AGENT_CLEANUP_TIMEOUT_MS.
Privacidad y límites
Los paquetes de trayectoria son para soporte y depuración, no para publicación pública. OpenClaw redacta valores sensibles antes de escribir archivos de exportación:- credenciales y campos de carga útil conocidos que parecen secretos
- datos de imagen
- rutas de estado local
- rutas del espacio de trabajo, reemplazadas por
$WORKSPACE_DIR - rutas del directorio de inicio, cuando se detectan
- archivos sidecar de runtime: el archivo de captura en vivo es una ventana móvil limitada a 10 MiB, que descarta los eventos más antiguos para hacer espacio para los nuevos; la exportación acepta archivos sidecar de runtime existentes de hasta 50 MiB
- archivos de sesión: 50 MiB
- eventos de runtime por exportación: 200,000
- eventos exportados totales: 250,000
- las líneas individuales de eventos de runtime se truncan por encima de 256 KiB
Solución de problemas
Si la exportación no tiene eventos de runtime:- confirma que OpenClaw se inició sin
OPENCLAW_TRAJECTORY=0 - comprueba si
OPENCLAW_TRAJECTORY_DIRapunta a un directorio con permisos de escritura - ejecuta otro mensaje en la sesión y luego exporta de nuevo
- inspecciona
manifest.jsonpara verruntimeEventCount
- usa un nombre relativo como
bug-1234 - no pases
/tmp/...ni~/... - mantén la exportación dentro de
.openclaw/trajectory-exports/