--- read_when: - Налагодження причин, чому агент відповів, зазнав збою або викликав інструменти певним чином - Експорт пакета підтримки для сеансу OpenClaw - Дослідження контексту промпта, викликів інструментів, помилок виконання або метаданих використання - Вимкнення або зміна місця запису траєкторій summary: Експорт пакетів траєкторій із вилученими конфіденційними даними для налагодження сеансу агента OpenClaw title: Пакети траєкторій x-i18n: generated_at: "2026-05-04T08:52:40Z" model: gpt-5.5 provider: openai source_hash: b8b1256e52d27185a48ceddaf7937b4f37ad6d57d075fea0d0b6d3abb871f1d8 source_path: tools/trajectory.md workflow: 16 --- Запис траєкторії — це покроковий реєстратор OpenClaw для кожного сеансу. Він записує структуровану шкалу часу для кожного запуску агента, а потім `/export-trajectory` пакує поточний сеанс у відредагований пакет підтримки. Використовуйте його, коли потрібно відповісти на такі запитання: - Який запит, системний запит і інструменти було надіслано моделі? - Які повідомлення транскрипту й виклики інструментів призвели до цієї відповіді? - Чи запуск перевищив час очікування, був перерваний, compact, або отримав помилку провайдера? - Які модель, plugins, Skills і параметри середовища виконання були активні? - Які метадані використання й кешу запитів повернув провайдер? Якщо ви подаєте широкий звіт до підтримки щодо проблеми live Gateway, почніть із [`/diagnostics`](/uk/gateway/diagnostics#chat-command). Діагностика збирає очищений пакет Gateway і, для сеансів OpenAI Codex harness, також може після схвалення надіслати відгук Codex на сервери OpenAI. Використовуйте `/export-trajectory`, коли вам потрібна саме детальна шкала часу запитів, інструментів і транскрипту для конкретного сеансу. ## Швидкий старт Надішліть це в активному сеансі: ```text /export-trajectory ``` Псевдонім: ```text /trajectory ``` OpenClaw записує пакет у робочому просторі: ```text .openclaw/trajectory-exports/openclaw-trajectory--/ ``` Можна вибрати відносну назву вихідного каталогу: ```text /export-trajectory bug-1234 ``` Власний шлях розв’язується всередині `.openclaw/trajectory-exports/`. Абсолютні шляхи й шляхи з `~` відхиляються. Пакети траєкторій можуть містити запити, повідомлення моделі, схеми інструментів, результати інструментів, події середовища виконання та локальні шляхи. Тому чатова slash-команда щоразу проходить через схвалення exec. Схваліть експорт один раз, коли справді маєте намір створити пакет; не використовуйте allow-all. У групових чатах OpenClaw надсилає запит на схвалення й результат експорту власнику приватно, замість публікувати деталі траєкторії назад у спільну кімнату. Для локального перегляду або процесів підтримки також можна напряму виконати схвалений шлях команди: ```bash openclaw sessions export-trajectory --session-key "agent:main:telegram:direct:123" --workspace . ``` ## Доступ Експорт траєкторії — це команда власника. Відправник має пройти звичайні перевірки авторизації команд і перевірки власника для каналу. ## Що записується Запис траєкторії типово ввімкнений для запусків агентів OpenClaw. Події середовища виконання включають: - `session.started` - `trace.metadata` - `context.compiled` - `prompt.submitted` - `model.fallback_step`, включно з вихідною моделлю, наступною моделлю, причиною/деталями помилки, позицією в ланцюжку, а також тим, чи fallback просунувся далі, завершився успішно або вичерпав ланцюжок - `model.completed` - `trace.artifacts` - `session.ended` Події транскрипту також реконструюються з активної гілки сеансу: - повідомлення користувача - повідомлення асистента - виклики інструментів - результати інструментів - compactions - зміни моделі - мітки та власні записи сеансу Події записуються як JSON Lines із таким маркером схеми: ```json { "traceSchema": "openclaw-trajectory", "schemaVersion": 1 } ``` ## Файли пакета Експортований пакет може містити: | Файл | Вміст | | --------------------- | ---------------------------------------------------------------------------------------------- | | `manifest.json` | Схема пакета, вихідні файли, кількість подій і список згенерованих файлів | | `events.jsonl` | Впорядкована шкала часу середовища виконання й транскрипту | | `session-branch.json` | Відредагована активна гілка транскрипту й заголовок сеансу | | `metadata.json` | Версія OpenClaw, ОС/середовище виконання, модель, знімок конфігурації, plugins, Skills і метадані запитів | | `artifacts.json` | Фінальний стан, помилки, використання, кеш запитів, кількість compaction, текст асистента й метадані інструментів | | `prompts.json` | Надіслані запити й вибрані деталі побудови запитів | | `system-prompt.txt` | Останній скомпільований системний запит, якщо його було записано | | `tools.json` | Визначення інструментів, надіслані моделі, якщо їх було записано | `manifest.json` перелічує файли, наявні в цьому пакеті. Деякі файли пропускаються, коли сеанс не записав відповідні дані середовища виконання. ## Розташування запису Типово події траєкторії середовища виконання записуються поруч із файлом сеансу: ```text .trajectory.jsonl ``` OpenClaw також записує best-effort файл-вказівник поруч із сеансом: ```text .trajectory-path.json ``` Установіть `OPENCLAW_TRAJECTORY_DIR`, щоб зберігати допоміжні файли траєкторій середовища виконання в окремому каталозі: ```bash export OPENCLAW_TRAJECTORY_DIR=/var/lib/openclaw/trajectories ``` Коли цю змінну встановлено, OpenClaw записує один файл JSONL на кожен ідентифікатор сеансу в цьому каталозі. Обслуговування сеансів видаляє допоміжні файли траєкторій, коли відповідний запис сеансу обрізається, обмежується або витісняється бюджетом диска для сеансів. Файли середовища виконання поза каталогом сеансів видаляються лише тоді, коли ціль вказівника все ще доводить, що належить цьому сеансу. ## Вимкнення запису Установіть `OPENCLAW_TRAJECTORY=0` перед запуском OpenClaw: ```bash export OPENCLAW_TRAJECTORY=0 ``` Це вимикає запис траєкторії середовища виконання. `/export-trajectory` усе ще може експортувати гілку транскрипту, але файли, доступні лише з середовища виконання, як-от скомпільований контекст, артефакти провайдера й метадані запитів, можуть бути відсутні. ## Конфіденційність і обмеження Пакети траєкторій призначені для підтримки й налагодження, а не для публічного розміщення. OpenClaw редагує чутливі значення перед записом файлів експорту: - облікові дані й відомі поля корисного навантаження, схожі на секрети - дані зображень - шляхи локального стану - шляхи робочого простору, замінені на `$WORKSPACE_DIR` - шляхи домашнього каталогу, якщо їх виявлено Експортер також обмежує розмір вхідних даних: - допоміжні файли середовища виконання: live-запис зупиняється на 10 MiB і записує подію truncation, коли місце ще лишається; експорт приймає наявні допоміжні файли середовища виконання до 50 MiB - файли сеансів: 50 MiB - події середовища виконання: 200,000 - загальна кількість експортованих подій: 250,000 - окремі рядки подій середовища виконання обрізаються понад 256 KiB Переглядайте пакети перед тим, як ділитися ними поза своєю командою. Редагування виконується best-effort і не може знати кожен секрет, специфічний для застосунку. ## Усунення несправностей Якщо в експорті немає подій середовища виконання: - підтвердьте, що OpenClaw було запущено без `OPENCLAW_TRAJECTORY=0` - перевірте, чи `OPENCLAW_TRAJECTORY_DIR` вказує на каталог із правом запису - надішліть ще одне повідомлення в сеансі, а потім експортуйте знову - перевірте `manifest.json` на `runtimeEventCount` Якщо команда відхиляє вихідний шлях: - використовуйте відносну назву, наприклад `bug-1234` - не передавайте `/tmp/...` або `~/...` - тримайте експорт усередині `.openclaw/trajectory-exports/` Якщо експорт завершується помилкою розміру, сеанс або допоміжний файл перевищив безпечні межі експорту. Почніть новий сеанс або експортуйте менше відтворення. ## Пов’язане - [Diffs](/uk/tools/diffs) - [Керування сеансами](/uk/concepts/session) - [Інструмент exec](/uk/tools/exec)