Pakiety trajektorii

Przechwytywanie trajektorii to rejestrator przebiegu sesji w OpenClaw. Zapisuje ustrukturyzowaną oś czasu dla każdego uruchomienia agenta, a następnie /export-trajectory pakuje bieżącą sesję w zredagowany pakiet wsparcia.

Użyj go, gdy musisz odpowiedzieć na pytania takie jak:

• Jaki prompt, prompt systemowy i narzędzia wysłano do modelu?
• Które wiadomości transkryptu i wywołania narzędzi doprowadziły do tej odpowiedzi?
• Czy uruchomienie przekroczyło limit czasu, zostało przerwane, skompaktowane albo napotkało błąd dostawcy?
• Który model, Plugin, Skills i ustawienia środowiska uruchomieniowego były aktywne?
• Jakie metadane użycia i pamięci podręcznej promptów zwrócił dostawca?

Jeśli zgłaszasz szeroki raport wsparcia dotyczący problemu z aktywnym Gateway, zacznij od /diagnostics. Diagnostyka zbiera oczyszczony pakiet Gateway, a dla sesji uprzęży OpenAI Codex może także wysłać opinię Codex do serwerów OpenAI po zatwierdzeniu. Użyj /export-trajectory, gdy potrzebujesz konkretnie szczegółowej osi czasu promptów, narzędzi i transkryptu dla danej sesji.

Szybki start

Wyślij to w aktywnej sesji:

/export-trajectory

Alias:

/trajectory

OpenClaw zapisuje pakiet w obszarze roboczym:

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

Możesz wybrać względną nazwę katalogu wyjściowego:

/export-trajectory bug-1234

Ścieżka niestandardowa jest rozwiązywana wewnątrz .openclaw/trajectory-exports/. Ścieżki bezwzględne i ścieżki ~ są odrzucane.

Pakiety trajektorii mogą zawierać prompty, wiadomości modelu, schematy narzędzi, wyniki narzędzi, zdarzenia środowiska uruchomieniowego i ścieżki lokalne. Dlatego polecenie ukośnikowe czatu uruchamia się przez zatwierdzenie exec za każdym razem. Zatwierdź eksport raz, gdy zamierzasz utworzyć pakiet; nie używaj allow-all. W czatach grupowych OpenClaw wysyła prompt zatwierdzenia i wynik eksportu prywatnie do właściciela zamiast publikować szczegóły trajektorii z powrotem we współdzielonym pokoju.

Do lokalnej inspekcji lub przepływów wsparcia możesz także uruchomić zatwierdzoną ścieżkę polecenia bezpośrednio:

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

Dostęp

Eksport trajektorii jest poleceniem właściciela. Nadawca musi przejść standardowe kontrole autoryzacji poleceń i kontrole właściciela dla kanału.

Co jest rejestrowane

Przechwytywanie trajektorii jest domyślnie włączone dla uruchomień agentów OpenClaw.

Zdarzenia środowiska uruchomieniowego obejmują:

• session.started
• trace.metadata
• context.compiled
• prompt.submitted
• model.fallback_step, w tym model źródłowy, następny model, przyczynę/szczegół niepowodzenia, pozycję w łańcuchu oraz informację, czy fallback przeszedł dalej, zakończył się powodzeniem, czy wyczerpał łańcuch
• model.completed
• trace.artifacts
• session.ended

Zdarzenia transkryptu są także rekonstruowane z aktywnej gałęzi sesji:

• wiadomości użytkownika
• wiadomości asystenta
• wywołania narzędzi
• wyniki narzędzi
• kompaktacje
• zmiany modelu
• etykiety i niestandardowe wpisy sesji

Zdarzenia są zapisywane jako JSON Lines z tym znacznikiem schematu:

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

Pliki pakietu

Wyeksportowany pakiet może zawierać:

manifest.json wymienia pliki obecne w danym pakiecie. Niektóre pliki są pomijane, gdy sesja nie przechwyciła odpowiadających im danych środowiska uruchomieniowego.

Lokalizacja przechwytywania

Domyślnie zdarzenia trajektorii środowiska uruchomieniowego są zapisywane obok pliku sesji:

<session>.trajectory.jsonl

OpenClaw zapisuje także plik wskaźnika best-effort obok sesji:

<session>.trajectory-path.json

Ustaw OPENCLAW_TRAJECTORY_DIR, aby przechowywać pliki pomocnicze trajektorii środowiska uruchomieniowego w dedykowanym katalogu:

export OPENCLAW_TRAJECTORY_DIR=/var/lib/openclaw/trajectories

Gdy ta zmienna jest ustawiona, OpenClaw zapisuje jeden plik JSONL na identyfikator sesji w tym katalogu.

Konserwacja sesji usuwa pliki pomocnicze trajektorii, gdy ich wpis sesji właściciela zostanie przycięty, ograniczony limitem lub usunięty przez budżet dyskowy sesji. Pliki środowiska uruchomieniowego poza katalogiem sesji są usuwane tylko wtedy, gdy cel wskaźnika nadal dowodzi, że należy do tej sesji.

Wyłączanie przechwytywania

Ustaw OPENCLAW_TRAJECTORY=0 przed uruchomieniem OpenClaw:

export OPENCLAW_TRAJECTORY=0

Wyłącza to przechwytywanie trajektorii środowiska uruchomieniowego. /export-trajectory nadal może wyeksportować gałąź transkryptu, ale pliki dostępne tylko w środowisku uruchomieniowym, takie jak skompilowany kontekst, artefakty dostawcy i metadane promptów, mogą być niedostępne.

Dostosowanie limitu czasu opróżniania

OpenClaw opróżnia pliki pomocnicze trajektorii środowiska uruchomieniowego podczas czyszczenia agenta. Domyślny limit czasu czyszczenia wynosi 10 000 ms. Na wolnych dyskach lub w dużych magazynach ustaw OPENCLAW_TRAJECTORY_FLUSH_TIMEOUT_MS przed uruchomieniem OpenClaw:

export OPENCLAW_TRAJECTORY_FLUSH_TIMEOUT_MS=30000

Kontroluje to moment, w którym OpenClaw zapisuje limit czasu openclaw-trajectory-flush i kontynuuje. Nie zmienia to limitów rozmiaru trajektorii. Aby dostosować wszystkie kroki czyszczenia agenta, które nie przekazują jawnego limitu czasu, ustaw OPENCLAW_AGENT_CLEANUP_TIMEOUT_MS.

Prywatność i limity

Pakiety trajektorii są przeznaczone do wsparcia i debugowania, a nie do publicznego publikowania. OpenClaw redaguje wrażliwe wartości przed zapisaniem plików eksportu:

• poświadczenia i znane pola ładunku przypominające sekrety
• dane obrazów
• ścieżki lokalnego stanu
• ścieżki obszaru roboczego, zastąpione przez $WORKSPACE_DIR
• ścieżki katalogu domowego, gdy zostaną wykryte

Eksporter ogranicza także rozmiar danych wejściowych:

• pliki pomocnicze środowiska uruchomieniowego: przechwytywanie na żywo zatrzymuje się przy 10 MiB i zapisuje zdarzenie obcięcia, gdy pozostaje miejsce; eksport akceptuje istniejące pliki pomocnicze środowiska uruchomieniowego do 50 MiB
• pliki sesji: 50 MiB
• zdarzenia środowiska uruchomieniowego: 200 000
• łącznie wyeksportowane zdarzenia: 250 000
• pojedyncze wiersze zdarzeń środowiska uruchomieniowego są obcinane powyżej 256 KiB

Przejrzyj pakiety przed udostępnieniem ich poza swoim zespołem. Redakcja działa na zasadzie best-effort i nie może znać każdego sekretu specyficznego dla aplikacji.

Rozwiązywanie problemów

Jeśli eksport nie ma zdarzeń środowiska uruchomieniowego:

• potwierdź, że OpenClaw został uruchomiony bez OPENCLAW_TRAJECTORY=0
• sprawdź, czy OPENCLAW_TRAJECTORY_DIR wskazuje zapisywalny katalog
• uruchom kolejną wiadomość w sesji, a następnie wyeksportuj ponownie
• sprawdź manifest.json pod kątem runtimeEventCount

Jeśli polecenie odrzuca ścieżkę wyjściową:

• użyj względnej nazwy, takiej jak bug-1234
• nie przekazuj /tmp/... ani ~/...
• trzymaj eksport wewnątrz .openclaw/trajectory-exports/

Jeśli eksport kończy się błędem rozmiaru, sesja lub plik pomocniczy przekroczyły limity bezpieczeństwa eksportu. Rozpocznij nową sesję albo wyeksportuj mniejszą reprodukcję.

Powiązane

• Różnice
• Zarządzanie sesją
• Narzędzie exec