Skip to main content
A captura de trajetória é o gravador de voo por sessão do OpenClaw. Ela registra uma linha do tempo estruturada para cada execução do agente; em seguida, /export-trajectory empacota a sessão atual em um pacote de suporte com dados sensíveis ocultados, abrangendo:
  • O prompt, o prompt do sistema e as ferramentas enviados ao modelo
  • Quais mensagens da transcrição e chamadas de ferramentas levaram a uma resposta
  • Se a execução atingiu o tempo limite, foi interrompida, sofreu Compaction ou encontrou um erro do provedor
  • Quais modelo, plugins, Skills e configurações de runtime estavam ativos
  • Metadados de uso e de cache de prompts retornados pelo provedor
Para obter um relatório de suporte abrangente do Gateway, comece com /diagnostics; ele coleta o pacote sanitizado do Gateway e, para sessões do ambiente OpenAI Codex, pode enviar feedback do Codex à OpenAI após aprovação. Use /export-trajectory quando precisar da linha do tempo detalhada de prompts, ferramentas e transcrição por sessão.

​
Início rápido

Envie na sessão ativa (alias /trajectory):
O OpenClaw grava o pacote no workspace:
Passe um nome de diretório de saída relativo para substituí-lo:
O nome é resolvido dentro de .openclaw/trajectory-exports/. Caminhos absolutos e caminhos com ~ são rejeitados. Os pacotes de trajetória podem conter prompts, mensagens do modelo, esquemas de ferramentas, resultados de ferramentas, eventos de runtime e caminhos locais; portanto, o comando de chat sempre passa pela aprovação de execução. Aprove a exportação uma vez quando pretender criar o pacote; não use a opção de permitir tudo. Em chats em grupo, o OpenClaw envia a solicitação de aprovação e o resultado da exportação em particular ao proprietário, em vez de publicar detalhes da trajetória na sala compartilhada. Para inspeção local ou fluxos de trabalho de suporte, execute diretamente o comando da CLI subjacente:
Outras flags: --output <path> (nome do diretório dentro de .openclaw/trajectory-exports), --store <path> (substituição do armazenamento de sessões), --agent <id> (ID do agente para resolução do armazenamento), --json (saída estruturada).

​
Acesso

A exportação de trajetória é um comando do proprietário. O remetente deve passar pelas verificações normais de autorização de comandos, além da verificação de proprietário do canal.

​
O que é registrado

A captura de trajetória fica ativada por padrão para execuções de agentes do OpenClaw. Os eventos de runtime incluem:
  • session.started
  • trace.metadata
  • context.compiled
  • prompt.submitted
  • model.fallback_step, incluindo o modelo de origem, o próximo modelo, o motivo/detalhe da falha, a posição na cadeia e se a cadeia avançou, foi bem-sucedida ou se esgotou
  • model.completed
  • trace.artifacts
  • session.ended
Os eventos da transcrição são reconstruídos a partir da ramificação ativa da sessão: mensagens do usuário, mensagens do assistente, chamadas de ferramentas, resultados de ferramentas, compactions, alterações de modelo, rótulos e entradas personalizadas da sessão. Os eventos são gravados como JSON Lines com este marcador de esquema:

​
Arquivos do pacote

manifest.json lista os arquivos presentes em um determinado pacote; alguns arquivos são omitidos quando a sessão não capturou os dados de runtime correspondentes.

​
Armazenamento da captura

Os eventos de trajetória do runtime são armazenados com a sessão no banco de dados SQLite por agente. A exportação de uma trajetória materializa um pacote de suporte JSONL com dados sensíveis ocultados; a captura ativa do runtime não é um arquivo auxiliar JSONL adjacente à sessão. Arquivos legados .trajectory.jsonl e .trajectory-path.json ainda podem aparecer de versões mais antigas ou de exportações explícitas em formato de arquivo legado. A manutenção da sessão trata esses arquivos como alvos de limpeza; a captura ativa grava linhas no banco de dados.

​
Desativar a captura

Isso desativa a captura de trajetória do runtime antes de iniciar o OpenClaw. /export-trajectory ainda pode exportar a ramificação da transcrição, mas dados exclusivos do runtime, como contexto compilado, artefatos do provedor e metadados de prompts, podem estar ausentes.

​
Ajustar o tempo limite de liberação

O OpenClaw libera as linhas de trajetória do runtime durante a limpeza do agente. O tempo limite padrão de limpeza é 10,000 ms. Em discos lentos ou armazenamentos grandes, defina OPENCLAW_TRAJECTORY_FLUSH_TIMEOUT_MS antes de iniciar o OpenClaw:
Isso controla quando o OpenClaw registra um tempo limite openclaw-trajectory-flush e continua; não altera os limites de tamanho da trajetória. Para ajustar todas as etapas de limpeza do agente que não fornecem um tempo limite explícito, defina OPENCLAW_AGENT_CLEANUP_TIMEOUT_MS.

​
Privacidade e limites

Os pacotes de trajetória destinam-se a suporte e depuração, não à publicação pública. O OpenClaw oculta valores sensíveis antes de gravar os arquivos de exportação:
  • credenciais e campos conhecidos de payload semelhantes a segredos
  • dados de imagens
  • caminhos de estado local
  • caminhos do workspace, substituídos por $WORKSPACE_DIR
  • caminhos do diretório pessoal, quando detectados
O exportador também limita o tamanho da entrada:
  • captura de runtime: a captura ativa é uma janela contínua limitada a 10 MiB, descartando os eventos mais antigos para liberar espaço para os novos; a exportação aceita arquivos auxiliares legados existentes de runtime com até 50 MiB
  • arquivos de sessão: 50 MiB
  • eventos de runtime por exportação: 200,000
  • total de eventos exportados: 250,000
  • linhas individuais de eventos de runtime são truncadas acima de 256 KiB
Revise os pacotes antes de compartilhá-los fora da sua equipe. A ocultação é feita com o melhor esforço e não consegue identificar todos os segredos específicos de cada aplicação.

​
Solução de problemas

Se a exportação não tiver eventos de runtime:
  • confirme que o OpenClaw foi iniciado sem OPENCLAW_TRAJECTORY=0
  • execute outra mensagem na sessão e exporte novamente
  • inspecione manifest.json para verificar runtimeEventCount
Se o comando rejeitar o caminho de saída:
  • use um nome relativo como bug-1234
  • não forneça /tmp/... nem ~/...
  • mantenha a exportação dentro de .openclaw/trajectory-exports/
Se a exportação falhar com um erro de tamanho, a sessão ou o arquivo auxiliar excedeu os limites de segurança de exportação acima. Inicie uma nova sessão ou exporte uma reprodução menor.

​
Relacionados