Перейти до основного вмісту

​
Пакети траєкторії

Захоплення траєкторії — це журнал польоту OpenClaw для кожної сесії. Воно записує структуровану часову шкалу для кожного запуску агента, а потім /export-trajectory пакує поточну сесію в пакет підтримки з редагуванням чутливих даних. Використовуйте це, коли потрібно відповісти на запитання на кшталт:
  • Які prompt, системний prompt та інструменти було надіслано моделі?
  • Які повідомлення транскрипту та виклики інструментів призвели до цієї відповіді?
  • Чи запуск завершився через timeout, abort, Compaction або помилку провайдера?
  • Які модель, plugin-и, Skills і налаштування середовища виконання були активні?
  • Які метадані usage та prompt-cache повернув провайдер?

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

Надішліть це в активній сесії: 
/export-trajectory
Псевдонім: 
/trajectory
OpenClaw записує пакет у workspace: 
.openclaw/trajectory-exports/openclaw-trajectory-<session>-<timestamp>/
Ви можете вибрати відносне ім’я вихідного каталогу: 
/export-trajectory bug-1234
Користувацький шлях визначається всередині .openclaw/trajectory-exports/. Абсолютні шляхи та шляхи з ~ відхиляються.

​
Доступ

Експорт траєкторії — це команда лише для власника. Відправник має пройти звичайні перевірки авторизації команд і перевірки власника для каналу.

​
Що записується

Захоплення траєкторії увімкнене за замовчуванням для запусків агентів OpenClaw. Події середовища виконання включають:
  • session.started
  • trace.metadata
  • context.compiled
  • prompt.submitted
  • model.completed
  • trace.artifacts
  • session.ended
Події транскрипту також відновлюються з активної гілки сесії:
  • повідомлення користувача
  • повідомлення асистента
  • виклики інструментів
  • результати інструментів
  • Compaction
  • зміни моделей
  • мітки та користувацькі записи сесії
Події записуються як JSON Lines із таким маркером схеми: 
{
  "traceSchema": "openclaw-trajectory",
  "schemaVersion": 1
}

​
Файли пакета

Експортований пакет може містити:
FileContents
manifest.jsonСхема пакета, вихідні файли, кількість подій і список згенерованих файлів
events.jsonlУпорядкована часова шкала середовища виконання та транскрипту
session-branch.jsonВідредагована активна гілка транскрипту та заголовок сесії
metadata.jsonВерсія OpenClaw, ОС/середовище виконання, модель, знімок конфігурації, plugin-и, Skills і метадані prompt
artifacts.jsonПідсумковий статус, помилки, usage, prompt cache, кількість Compaction, текст асистента та метадані інструментів
prompts.jsonНадіслані prompt-и та вибрані подробиці побудови prompt
system-prompt.txtОстанній скомпільований системний prompt, якщо його було захоплено
tools.jsonВизначення інструментів, надісланих моделі, якщо їх було захоплено
manifest.json перелічує файли, наявні в цьому пакеті. Деякі файли пропускаються, коли сесія не захопила відповідні дані середовища виконання.

​
Розташування захоплення

За замовчуванням події траєкторії середовища виконання записуються поруч із файлом сесії: 
<session>.trajectory.jsonl
OpenClaw також записує файл-покажчик best-effort поруч із сесією: 
<session>.trajectory-path.json
Установіть OPENCLAW_TRAJECTORY_DIR, щоб зберігати sidecar-файли траєкторії середовища виконання в окремому каталозі: 
export OPENCLAW_TRAJECTORY_DIR=/var/lib/openclaw/trajectories
Коли цю змінну встановлено, OpenClaw записує в цей каталог один JSONL-файл на кожен id сесії.

​
Вимкнення захоплення

Установіть OPENCLAW_TRAJECTORY=0 перед запуском OpenClaw: 
export OPENCLAW_TRAJECTORY=0
Це вимикає захоплення траєкторії середовища виконання. /export-trajectory усе ще може експортувати гілку транскрипту, але файли лише середовища виконання, як-от скомпільований контекст, артефакти провайдера та метадані prompt, можуть бути відсутні.

​
Приватність і обмеження

Пакети траєкторії призначені для підтримки та налагодження, а не для публічного розміщення. OpenClaw редагує чутливі значення перед записом файлів експорту:
  • облікові дані та відомі поля payload-ів, схожих на секрети
  • дані зображень
  • локальні шляхи стану
  • шляхи workspace, замінені на $WORKSPACE_DIR
  • шляхи до домашнього каталогу, де їх виявлено
Експортер також обмежує розмір вхідних даних:
  • файли sidecar середовища виконання: 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/
Якщо експорт завершується з помилкою розміру, сесія або sidecar перевищили обмеження безпеки експорту. Створіть нову сесію або експортуйте менше відтворення.