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

Documentation Index

Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Запис траєкторії — це покроковий реєстратор 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/
Якщо експорт завершується помилкою розміру, сеанс або допоміжний файл перевищив безпечні межі експорту. Почніть новий сеанс або експортуйте менше відтворення.

​
Пов’язане