Пакети траєкторій

Запис траєкторії — це покроковий реєстратор OpenClaw для кожного сеансу. Він записує структуровану шкалу часу для кожного запуску агента, а потім /export-trajectory пакує поточний сеанс у відредагований пакет підтримки.

Використовуйте його, коли потрібно відповісти на такі запитання:

• Який запит, системний запит і інструменти було надіслано моделі?
• Які повідомлення транскрипту й виклики інструментів призвели до цієї відповіді?
• Чи запуск перевищив час очікування, був перерваний, compact, або отримав помилку провайдера?
• Які модель, plugins, Skills і параметри середовища виконання були активні?
• Які метадані використання й кешу запитів повернув провайдер?

Якщо ви подаєте широкий звіт до підтримки щодо проблеми live Gateway, почніть із /diagnostics. Діагностика збирає очищений пакет Gateway і, для сеансів OpenAI Codex harness, також може після схвалення надіслати відгук Codex на сервери OpenAI. Використовуйте /export-trajectory, коли вам потрібна саме детальна шкала часу запитів, інструментів і транскрипту для конкретного сеансу.

# Швидкий старт

Надішліть це в активному сеансі:

/export-trajectory

Псевдонім:

/trajectory

OpenClaw записує пакет у робочому просторі:

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

Можна вибрати відносну назву вихідного каталогу:

/export-trajectory bug-1234

Власний шлях розв’язується всередині .openclaw/trajectory-exports/. Абсолютні шляхи й шляхи з ~ відхиляються.

Пакети траєкторій можуть містити запити, повідомлення моделі, схеми інструментів, результати інструментів, події середовища виконання та локальні шляхи. Тому чатова slash-команда щоразу проходить через схвалення exec. Схваліть експорт один раз, коли справді маєте намір створити пакет; не використовуйте allow-all. У групових чатах OpenClaw надсилає запит на схвалення й результат експорту власнику приватно, замість публікувати деталі траєкторії назад у спільну кімнату.

Для локального перегляду або процесів підтримки також можна напряму виконати схвалений шлях команди:

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 із таким маркером схеми:

{
  "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 перелічує файли, наявні в цьому пакеті. Деякі файли пропускаються, коли сеанс не записав відповідні дані середовища виконання.

# Розташування запису

Типово події траєкторії середовища виконання записуються поруч із файлом сеансу:

<session>.trajectory.jsonl

OpenClaw також записує best-effort файл-вказівник поруч із сеансом:

<session>.trajectory-path.json

Установіть OPENCLAW_TRAJECTORY_DIR, щоб зберігати допоміжні файли траєкторій середовища виконання в окремому каталозі:

export OPENCLAW_TRAJECTORY_DIR=/var/lib/openclaw/trajectories

Коли цю змінну встановлено, OpenClaw записує один файл JSONL на кожен ідентифікатор сеансу в цьому каталозі.

Обслуговування сеансів видаляє допоміжні файли траєкторій, коли відповідний запис сеансу обрізається, обмежується або витісняється бюджетом диска для сеансів. Файли середовища виконання поза каталогом сеансів видаляються лише тоді, коли ціль вказівника все ще доводить, що належить цьому сеансу.

# Вимкнення запису

Установіть OPENCLAW_TRAJECTORY=0 перед запуском OpenClaw:

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
• Керування сеансами
• Інструмент exec