Trajektorienbündel

Trajectory Capture ist der sitzungsbezogene Flugschreiber von OpenClaw. Sie zeichnet eine strukturierte Zeitleiste für jeden Agentenlauf auf, anschließend paketiert /export-trajectory die aktuelle Sitzung in ein redigiertes Support-Bundle.

Verwenden Sie sie, wenn Sie Fragen wie diese beantworten müssen:

• Welcher Prompt, System-Prompt und welche Tools wurden an das Modell gesendet?
• Welche Transkriptnachrichten und Tool-Aufrufe führten zu dieser Antwort?
• Hat der Lauf ein Timeout erreicht, wurde er abgebrochen, kompaktifiziert oder ist ein Provider-Fehler aufgetreten?
• Welches Modell, welche Plugins, Skills und Laufzeiteinstellungen waren aktiv?
• Welche Nutzungs- und Prompt-Cache-Metadaten hat der Provider zurückgegeben?

Wenn Sie einen umfassenden Support-Bericht für ein Live-Gateway-Problem einreichen, beginnen Sie mit /diagnostics. Diagnostics sammelt das bereinigte Gateway-Bundle und kann bei OpenAI-Codex-Harness-Sitzungen nach Genehmigung auch Codex-Feedback an OpenAI-Server senden. Verwenden Sie /export-trajectory, wenn Sie speziell die detaillierte sitzungsbezogene Zeitleiste für Prompts, Tools und Transkript benötigen.

# Schnellstart

Senden Sie dies in der aktiven Sitzung:

/export-trajectory

Alias:

/trajectory

OpenClaw schreibt das Bundle unterhalb des Arbeitsbereichs:

.openclaw/trajectory-exports/openclaw-trajectory-<session>-<timestamp>/

Sie können einen relativen Namen für das Ausgabeverzeichnis wählen:

/export-trajectory bug-1234

Der benutzerdefinierte Pfad wird innerhalb von .openclaw/trajectory-exports/ aufgelöst. Absolute Pfade und ~-Pfade werden abgelehnt.

Trajectory-Bundles können Prompts, Modellnachrichten, Tool-Schemata, Tool-Ergebnisse, Laufzeitereignisse und lokale Pfade enthalten. Der Chat-Slash-Befehl läuft daher jedes Mal über die Exec-Genehmigung. Genehmigen Sie den Export einmal, wenn Sie das Bundle erstellen möchten; verwenden Sie nicht „allow-all“. In Gruppenchats sendet OpenClaw die Genehmigungsabfrage und das Exportergebnis privat an den Besitzer, statt die Trajectory-Details zurück in den gemeinsamen Raum zu posten.

Für lokale Prüfung oder Support-Workflows können Sie den genehmigten Befehlspfad auch direkt ausführen:

openclaw sessions export-trajectory --session-key "agent:main:telegram:direct:123" --workspace .

# Zugriff

Trajectory-Export ist ein Besitzerbefehl. Der Absender muss die normalen Autorisierungsprüfungen für Befehle und die Besitzerprüfungen für den Kanal bestehen.

# Was aufgezeichnet wird

Trajectory Capture ist für OpenClaw-Agentenläufe standardmäßig aktiviert.

Laufzeitereignisse umfassen:

• session.started
• trace.metadata
• context.compiled
• prompt.submitted
• model.fallback_step, einschließlich Quellmodell, nächstem Modell, Fehlergrund/-details, Kettenposition und ob der Fallback die Kette fortgesetzt, erfolgreich abgeschlossen oder erschöpft hat
• model.completed
• trace.artifacts
• session.ended

Transkriptereignisse werden außerdem aus dem aktiven Sitzungszweig rekonstruiert:

• Benutzernachrichten
• Assistentennachrichten
• Tool-Aufrufe
• Tool-Ergebnisse
• Compactions
• Modellwechsel
• Labels und benutzerdefinierte Sitzungseinträge

Ereignisse werden als JSON Lines mit dieser Schemamarkierung geschrieben:

{
  "traceSchema": "openclaw-trajectory",
  "schemaVersion": 1
}

# Bundle-Dateien

Ein exportiertes Bundle kann Folgendes enthalten:

Datei	Inhalte
manifest.json	Bundle-Schema, Quelldateien, Ereigniszahlen und Liste generierter Dateien
events.jsonl	Geordnete Laufzeit- und Transkriptzeitleiste
session-branch.json	Redigierter aktiver Transkriptzweig und Sitzungsheader
metadata.json	OpenClaw-Version, Betriebssystem/Laufzeit, Modell, Konfigurations-Snapshot, Plugins, Skills und Prompt-Metadaten
artifacts.json	Endstatus, Fehler, Nutzung, Prompt-Cache, Compaction-Anzahl, Assistententext und Tool-Metadaten
prompts.json	Eingereichte Prompts und ausgewählte Details zum Prompt-Aufbau
system-prompt.txt	Zuletzt kompilierter System-Prompt, sofern erfasst
tools.json	An das Modell gesendete Tool-Definitionen, sofern erfasst

manifest.json listet die in diesem Bundle vorhandenen Dateien auf. Einige Dateien werden ausgelassen, wenn die Sitzung die entsprechenden Laufzeitdaten nicht erfasst hat.

# Speicherort der Erfassung

Standardmäßig werden Laufzeit-Trajectory-Ereignisse neben die Sitzungsdatei geschrieben:

<session>.trajectory.jsonl

OpenClaw schreibt außerdem nach bestem Aufwand eine Pointer-Datei neben die Sitzung:

<session>.trajectory-path.json

Setzen Sie OPENCLAW_TRAJECTORY_DIR, um Laufzeit-Trajectory-Sidecars in einem dedizierten Verzeichnis zu speichern:

export OPENCLAW_TRAJECTORY_DIR=/var/lib/openclaw/trajectories

Wenn diese Variable gesetzt ist, schreibt OpenClaw eine JSONL-Datei pro Sitzungs-ID in dieses Verzeichnis.

Die Sitzungswartung entfernt Trajectory-Sidecars, wenn ihr zugehöriger Sitzungseintrag durch das Festplattenbudget für Sitzungen bereinigt, begrenzt oder verdrängt wird. Laufzeitdateien außerhalb des Sitzungsverzeichnisses werden nur entfernt, wenn das Pointer-Ziel weiterhin nachweist, dass es zu dieser Sitzung gehört.

# Erfassung deaktivieren

Setzen Sie OPENCLAW_TRAJECTORY=0, bevor Sie OpenClaw starten:

export OPENCLAW_TRAJECTORY=0

Dies deaktiviert die Laufzeit-Trajectory-Erfassung. /export-trajectory kann weiterhin den Transkriptzweig exportieren, aber reine Laufzeitdateien wie kompilierter Kontext, Provider-Artefakte und Prompt-Metadaten können fehlen.

# Datenschutz und Grenzen

Trajectory-Bundles sind für Support und Debugging konzipiert, nicht für öffentliche Veröffentlichung. OpenClaw redigiert sensible Werte, bevor Exportdateien geschrieben werden:

• Zugangsdaten und bekannte geheimnisähnliche Payload-Felder
• Bilddaten
• lokale Statuspfade
• Arbeitsbereichspfade, ersetzt durch $WORKSPACE_DIR
• Home-Verzeichnispfade, sofern erkannt

Der Exporter begrenzt außerdem die Eingabegröße:

• Laufzeit-Sidecar-Dateien: Live-Erfassung stoppt bei 10 MiB und zeichnet ein Kürzungsereignis auf, wenn Speicherplatz verbleibt; der Export akzeptiert vorhandene Laufzeit-Sidecars bis 50 MiB
• Sitzungsdateien: 50 MiB
• Laufzeitereignisse: 200.000
• insgesamt exportierte Ereignisse: 250.000
• einzelne Laufzeitereigniszeilen werden oberhalb von 256 KiB gekürzt

Prüfen Sie Bundles, bevor Sie sie außerhalb Ihres Teams teilen. Redigierung erfolgt nach bestem Aufwand und kann nicht jedes anwendungsspezifische Geheimnis kennen.

# Fehlerbehebung

Wenn der Export keine Laufzeitereignisse enthält:

• bestätigen Sie, dass OpenClaw ohne OPENCLAW_TRAJECTORY=0 gestartet wurde
• prüfen Sie, ob OPENCLAW_TRAJECTORY_DIR auf ein beschreibbares Verzeichnis verweist
• führen Sie eine weitere Nachricht in der Sitzung aus und exportieren Sie dann erneut
• prüfen Sie manifest.json auf runtimeEventCount

Wenn der Befehl den Ausgabepfad ablehnt:

• verwenden Sie einen relativen Namen wie bug-1234
• übergeben Sie nicht /tmp/... oder ~/...
• behalten Sie den Export innerhalb von .openclaw/trajectory-exports/

Wenn der Export mit einem Größenfehler fehlschlägt, hat die Sitzung oder das Sidecar die Sicherheitsgrenzen für den Export überschritten. Starten Sie eine neue Sitzung oder exportieren Sie eine kleinere Reproduktion.

# Verwandt

• Diffs
• Sitzungsverwaltung
• Exec-Tool