/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?
/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:.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:
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.startedtrace.metadatacontext.compiledprompt.submittedmodel.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ńcuchmodel.completedtrace.artifactssession.ended
- wiadomości użytkownika
- wiadomości asystenta
- wywołania narzędzi
- wyniki narzędzi
- kompaktacje
- zmiany modelu
- etykiety i niestandardowe wpisy sesji
Pliki pakietu
Wyeksportowany pakiet może zawierać:| Plik | Zawartość |
|---|---|
manifest.json | Schemat pakietu, pliki źródłowe, liczby zdarzeń i lista wygenerowanych plików |
events.jsonl | Uporządkowana oś czasu środowiska uruchomieniowego i transkryptu |
session-branch.json | Zredagowana aktywna gałąź transkryptu i nagłówek sesji |
metadata.json | Wersja OpenClaw, system operacyjny/środowisko uruchomieniowe, model, migawka konfiguracji, Plugin, Skills i metadane promptów |
artifacts.json | Końcowy status, błędy, użycie, pamięć podręczna promptów, liczba kompaktacji, tekst asystenta i metadane narzędzi |
prompts.json | Przesłane prompty i wybrane szczegóły budowania promptów |
system-prompt.txt | Najnowszy skompilowany prompt systemowy, jeśli został przechwycony |
tools.json | Definicje narzędzi wysłane do modelu, jeśli zostały przechwycone |
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:OPENCLAW_TRAJECTORY_DIR, aby przechowywać pliki pomocnicze trajektorii środowiska uruchomieniowego w
dedykowanym katalogu:
Wyłączanie przechwytywania
UstawOPENCLAW_TRAJECTORY=0 przed uruchomieniem OpenClaw:
/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 ustawOPENCLAW_TRAJECTORY_FLUSH_TIMEOUT_MS przed uruchomieniem OpenClaw:
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
- 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
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_DIRwskazuje zapisywalny katalog - uruchom kolejną wiadomość w sesji, a następnie wyeksportuj ponownie
- sprawdź
manifest.jsonpod kątemruntimeEventCount
- użyj względnej nazwy, takiej jak
bug-1234 - nie przekazuj
/tmp/...ani~/... - trzymaj eksport wewnątrz
.openclaw/trajectory-exports/