Pular para o conteúdo principal

​
Bundles de Trajetória

A captura de trajetória é o registrador de voo por sessão do OpenClaw. Ela registra uma linha do tempo estruturada para cada execução do agente, e então /export-trajectory empacota a sessão atual em um bundle de suporte com redação. Use quando precisar responder a perguntas como:
  • Qual prompt, prompt de sistema e ferramentas foram enviados ao modelo?
  • Quais mensagens da transcrição e chamadas de ferramenta levaram a esta resposta?
  • A execução expirou, foi abortada, passou por Compaction ou encontrou um erro de provider?
  • Quais modelo, plugins, Skills e configurações de runtime estavam ativos?
  • Quais metadados de uso e cache de prompt o provider retornou?

​
Início rápido

Envie isto na sessão ativa: 
/export-trajectory
Alias: 
/trajectory
O OpenClaw grava o bundle no workspace: 
.openclaw/trajectory-exports/openclaw-trajectory-<session>-<timestamp>/
Você pode escolher um nome relativo de diretório de saída: 
/export-trajectory bug-1234
O caminho personalizado é resolvido dentro de .openclaw/trajectory-exports/. Caminhos absolutos e caminhos ~ são rejeitados.

​
Acesso

A exportação de trajetória é um comando de owner. O remetente deve passar pelas verificações normais de autorização de comando e pelas verificações de owner do canal.

​
O que é registrado

A captura de trajetória fica ativada por padrão para execuções de agente do OpenClaw. Eventos de runtime incluem:
  • session.started
  • trace.metadata
  • context.compiled
  • prompt.submitted
  • model.completed
  • trace.artifacts
  • session.ended
Eventos da transcrição também são reconstruídos a partir do branch ativo da sessão:
  • mensagens do usuário
  • mensagens do assistente
  • chamadas de ferramenta
  • resultados de ferramenta
  • compactions
  • mudanças de modelo
  • rótulos e entradas personalizadas de sessão
Os eventos são gravados como JSON Lines com este marcador de esquema: 
{
  "traceSchema": "openclaw-trajectory",
  "schemaVersion": 1
}

​
Arquivos do bundle

Um bundle exportado pode conter:
ArquivoConteúdo
manifest.jsonEsquema do bundle, arquivos de origem, contagens de eventos e lista de arquivos gerados
events.jsonlLinha do tempo ordenada de runtime e transcrição
session-branch.jsonBranch ativo da transcrição com redação e cabeçalho da sessão
metadata.jsonVersão do OpenClaw, SO/runtime, modelo, snapshot de configuração, plugins, Skills e metadados de prompt
artifacts.jsonStatus final, erros, uso, cache de prompt, contagem de Compaction, texto do assistente e metadados de ferramentas
prompts.jsonPrompts enviados e detalhes selecionados de construção de prompt
system-prompt.txtPrompt de sistema compilado mais recente, quando capturado
tools.jsonDefinições de ferramentas enviadas ao modelo, quando capturado
manifest.json lista os arquivos presentes nesse bundle. Alguns arquivos são omitidos quando a sessão não capturou os dados de runtime correspondentes.

​
Local da captura

Por padrão, eventos de trajetória de runtime são gravados ao lado do arquivo de sessão: 
<session>.trajectory.jsonl
O OpenClaw também grava um arquivo ponteiro, no melhor esforço, ao lado da sessão: 
<session>.trajectory-path.json
Defina OPENCLAW_TRAJECTORY_DIR para armazenar sidecars de trajetória de runtime em um diretório dedicado: 
export OPENCLAW_TRAJECTORY_DIR=/var/lib/openclaw/trajectories
Quando essa variável está definida, o OpenClaw grava um arquivo JSONL por ID de sessão nesse diretório.

​
Desativar captura

Defina OPENCLAW_TRAJECTORY=0 antes de iniciar o OpenClaw: 
export OPENCLAW_TRAJECTORY=0
Isso desativa a captura de trajetória de runtime. /export-trajectory ainda pode exportar o branch da transcrição, mas arquivos apenas de runtime, como contexto compilado, artefatos do provider e metadados de prompt, podem estar ausentes.

​
Privacidade e limites

Bundles de trajetória são projetados para suporte e depuração, não para publicação pública. O OpenClaw aplica redação a valores sensíveis antes de gravar arquivos de exportação:
  • credenciais e campos de payload conhecidos com aparência de segredo
  • dados de imagem
  • caminhos de estado local
  • caminhos de workspace, substituídos por $WORKSPACE_DIR
  • caminhos do diretório home, quando detectados
O exportador também limita o tamanho da entrada:
  • arquivos sidecar de runtime: 50 MiB
  • arquivos de sessão: 50 MiB
  • eventos de runtime: 200.000
  • total de eventos exportados: 250.000
  • linhas individuais de evento de runtime são truncadas acima de 256 KiB
Revise os bundles antes de compartilhá-los fora da sua equipe. A redação é no melhor esforço e não pode conhecer todos os segredos específicos da 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
  • verifique se OPENCLAW_TRAJECTORY_DIR aponta para um diretório gravável
  • execute outra mensagem na sessão e exporte novamente
  • inspecione manifest.json para runtimeEventCount
Se o comando rejeitar o caminho de saída:
  • use um nome relativo como bug-1234
  • não passe /tmp/... nem ~/...
  • mantenha a exportação dentro de .openclaw/trajectory-exports/
Se a exportação falhar com erro de tamanho, a sessão ou o sidecar excedeu os limites de segurança da exportação. Inicie uma nova sessão ou exporte uma reprodução menor.