Naar hoofdinhoud gaan

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Trajectory capture is OpenClaw’s vluchtrecorder per sessie. Het legt een gestructureerde tijdlijn vast voor elke agent-run, waarna /export-trajectory de huidige sessie verpakt in een geredigeerde supportbundel. Gebruik dit wanneer je vragen moet beantwoorden zoals:
  • Welke prompt, systeemprompt en tools zijn naar het model verzonden?
  • Welke transcriptberichten en toolaanroepen hebben tot dit antwoord geleid?
  • Is de run verlopen, afgebroken, gecompacteerd, of op een providerfout gestuit?
  • Welk model, welke plugins, Skills en runtime-instellingen waren actief?
  • Welke gebruiks- en prompt-cachemetadata heeft de provider geretourneerd?
Als je een breed supportrapport indient voor een live Gateway-probleem, begin dan met /diagnostics. Diagnostics verzamelt de gesaneerde Gateway-bundel en kan, voor OpenAI Codex-harnesssessies, na goedkeuring ook Codex-feedback naar OpenAI-servers sturen. Gebruik /export-trajectory wanneer je specifiek de gedetailleerde prompt-, tool- en transcripttijdlijn per sessie nodig hebt.

​
Snel starten

Verzend dit in de actieve sessie: 
/export-trajectory
Alias: 
/trajectory
OpenClaw schrijft de bundel onder de werkruimte: 
.openclaw/trajectory-exports/openclaw-trajectory-<session>-<timestamp>/
Je kunt een relatieve naam voor de uitvoermap kiezen: 
/export-trajectory bug-1234
Het aangepaste pad wordt opgelost binnen .openclaw/trajectory-exports/. Absolute paden en ~-paden worden geweigerd. Trajectory-bundels kunnen prompts, modelberichten, toolschema’s, toolresultaten, runtime-events en lokale paden bevatten. De slashopdracht in de chat loopt daarom elke keer via exec-goedkeuring. Keur de export één keer goed wanneer je de bundel wilt maken; gebruik geen allow-all. In groepschats stuurt OpenClaw de goedkeuringsprompt en het exportresultaat privé naar de eigenaar, in plaats van de trajectory-details terug in de gedeelde ruimte te plaatsen. Voor lokale inspectie of supportworkflows kun je het goedgekeurde opdrachtpad ook rechtstreeks uitvoeren: 
openclaw sessions export-trajectory --session-key "agent:main:telegram:direct:123" --workspace .

​
Toegang

Trajectory-export is een eigenaarsopdracht. De afzender moet slagen voor de normale autorisatiecontroles voor opdrachten en eigenaarscontroles voor het kanaal.

​
Wat wordt vastgelegd

Trajectory capture staat standaard aan voor OpenClaw-agent-runs. Runtime-events omvatten:
  • session.started
  • trace.metadata
  • context.compiled
  • prompt.submitted
  • model.fallback_step, inclusief het bronmodel, volgende model, reden/details van de fout, positie in de keten, en of fallback vooruitging, slaagde, of de keten uitputte
  • model.completed
  • trace.artifacts
  • session.ended
Transcriptevents worden ook gereconstrueerd vanuit de actieve sessietak:
  • gebruikersberichten
  • assistentberichten
  • toolaanroepen
  • toolresultaten
  • compactions
  • modelwijzigingen
  • labels en aangepaste sessievermeldingen
Events worden geschreven als JSON Lines met deze schemamarkering: 
{
  "traceSchema": "openclaw-trajectory",
  "schemaVersion": 1
}

​
Bundelbestanden

Een geëxporteerde bundel kan bevatten:
BestandInhoud
manifest.jsonBundelschema, bronbestanden, eventaantallen en gegenereerde bestandslijst
events.jsonlGeordende runtime- en transcripttijdlijn
session-branch.jsonGeredigeerde actieve transcripttak en sessieheader
metadata.jsonOpenClaw-versie, OS/runtime, model, configuratiesnapshot, plugins, Skills en promptmetadata
artifacts.jsonEindstatus, fouten, gebruik, prompt-cache, compaction-aantal, assistenttekst en toolmetadata
prompts.jsonIngediende prompts en geselecteerde details voor promptopbouw
system-prompt.txtLaatst gecompileerde systeemprompt, wanneer vastgelegd
tools.jsonTooldefinities die naar het model zijn verzonden, wanneer vastgelegd
manifest.json vermeldt de bestanden die in die bundel aanwezig zijn. Sommige bestanden worden weggelaten wanneer de sessie de bijbehorende runtimedata niet heeft vastgelegd.

​
Vastleglocatie

Standaard worden runtime-trajectory-events naast het sessiebestand geschreven: 
<session>.trajectory.jsonl
OpenClaw schrijft ook een pointerbestand op basis van best effort naast de sessie: 
<session>.trajectory-path.json
Stel OPENCLAW_TRAJECTORY_DIR in om runtime-trajectory-sidecars in een toegewezen map op te slaan: 
export OPENCLAW_TRAJECTORY_DIR=/var/lib/openclaw/trajectories
Wanneer deze variabele is ingesteld, schrijft OpenClaw één JSONL-bestand per sessie-id in die map. Sessieonderhoud verwijdert trajectory-sidecars wanneer de bijbehorende sessievermelding wordt gesnoeid, begrensd, of verwijderd door het schijfbudget voor sessies. Runtimebestanden buiten de sessiemap worden alleen verwijderd wanneer het pointerdoel nog steeds bewijst dat het bij die sessie hoort.

​
Vastleggen uitschakelen

Stel OPENCLAW_TRAJECTORY=0 in voordat je OpenClaw start: 
export OPENCLAW_TRAJECTORY=0
Dit schakelt runtime-trajectory-capture uit. /export-trajectory kan nog steeds de transcripttak exporteren, maar runtime-only bestanden zoals gecompileerde context, providerartefacten en promptmetadata kunnen ontbreken.

​
Privacy en limieten

Trajectory-bundels zijn bedoeld voor support en debugging, niet voor openbare publicatie. OpenClaw redigeert gevoelige waarden voordat exportbestanden worden geschreven:
  • inloggegevens en bekende secret-achtige payloadvelden
  • afbeeldingsdata
  • lokale statuspaden
  • werkruimtepaden, vervangen door $WORKSPACE_DIR
  • homemappaden, waar gedetecteerd
De exporter begrenst ook de invoergrootte:
  • runtime-sidecarbestanden: 50 MiB
  • sessiebestanden: 50 MiB
  • runtime-events: 200.000
  • totaal geëxporteerde events: 250.000
  • afzonderlijke runtime-eventregels worden afgekapt boven 256 KiB
Controleer bundels voordat je ze buiten je team deelt. Redactie is best effort en kan niet elk applicatiespecifiek secret kennen.

​
Problemen oplossen

Als de export geen runtime-events heeft:
  • bevestig dat OpenClaw is gestart zonder OPENCLAW_TRAJECTORY=0
  • controleer of OPENCLAW_TRAJECTORY_DIR naar een schrijfbare map wijst
  • voer nog een bericht uit in de sessie en exporteer daarna opnieuw
  • inspecteer manifest.json op runtimeEventCount
Als de opdracht het uitvoerpad weigert:
  • gebruik een relatieve naam zoals bug-1234
  • geef geen /tmp/... of ~/... door
  • houd de export binnen .openclaw/trajectory-exports/
Als de export mislukt met een groottefout, heeft de sessie of sidecar de veiligheidslimieten voor export overschreden. Start een nieuwe sessie of exporteer een kleinere reproductie.

​
Gerelateerd