---
read_when:
    - Налагодження того, чому агент відповів, завершився помилкою або викликав інструменти певним чином
    - Експортування support-бандла для сесії OpenClaw
    - Дослідження контексту prompt-ів, викликів інструментів, помилок runtime або метаданих використання
    - Вимкнення або перенесення запису trajectory
summary: Експорт скорочених trajectory-бандлів для налагодження сесії агента OpenClaw
title: Trajectory-бандли
x-i18n:
    generated_at: "2026-04-23T23:09:01Z"
    model: gpt-5.4
    provider: openai
    source_hash: be799691e0c3375efd24e3bec9ce8f9ab22f01a0f8a9ce4288b7e6e952c29da4
    source_path: tools/trajectory.md
    workflow: 15
---

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

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

- Які prompt, system prompt та інструменти були надіслані моделі?
- Які повідомлення транскрипту й виклики інструментів привели до цієї відповіді?
- Чи запуск завершився timeout, abort, Compaction або помилкою провайдера?
- Які модель, Plugin-и, Skills і налаштування runtime були активними?
- Які метадані usage і prompt-cache повернув провайдер?

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

Надішліть це в активній сесії:

```text
/export-trajectory
```

Псевдонім:

```text
/trajectory
```

OpenClaw записує бандл у робочий простір:

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

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

```text
/export-trajectory bug-1234
```

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

## Доступ

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

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

Запис trajectory типово увімкнений для запусків агента OpenClaw.

Події runtime включають:

- `session.started`
- `trace.metadata`
- `context.compiled`
- `prompt.submitted`
- `model.completed`
- `trace.artifacts`
- `session.ended`

Події транскрипту також відновлюються з активної гілки сесії:

- повідомлення користувача
- повідомлення помічника
- виклики інструментів
- результати інструментів
- Compaction
- зміни моделі
- мітки й користувацькі записи сесії

Події записуються як JSON Lines з таким маркером schema:

```json
{
  "traceSchema": "openclaw-trajectory",
  "schemaVersion": 1
}
```

## Файли бандла

Експортований бандл може містити:

| Файл                  | Вміст                                                                                           |
| --------------------- | ----------------------------------------------------------------------------------------------- |
| `manifest.json`       | Схема бандла, вихідні файли, кількість подій і список згенерованих файлів                       |
| `events.jsonl`        | Упорядкована часова шкала runtime і транскрипту                                                 |
| `session-branch.json` | Скорочена активна гілка транскрипту і заголовок сесії                                           |
| `metadata.json`       | Версія OpenClaw, OS/runtime, модель, знімок config, Plugin-и, Skills і метадані prompt-ів       |
| `artifacts.json`      | Фінальний статус, помилки, usage, prompt cache, кількість Compaction, текст помічника і метадані інструментів |
| `prompts.json`        | Надіслані prompt-и й вибрані подробиці побудови prompt-ів                                       |
| `system-prompt.txt`   | Останній скомпільований system prompt, якщо його було записано                                  |
| `tools.json`          | Визначення інструментів, надісланих моделі, якщо їх було записано                               |

`manifest.json` перелічує файли, наявні в цьому бандлі. Деякі файли пропускаються,
якщо сесія не записала відповідні runtime-дані.

## Місце запису

Типово runtime-події trajectory записуються поруч із файлом сесії:

```text
<session>.trajectory.jsonl
```

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

```text
<session>.trajectory-path.json
```

Задайте `OPENCLAW_TRAJECTORY_DIR`, щоб зберігати runtime-sidecar-и trajectory в
окремому каталозі:

```bash
export OPENCLAW_TRAJECTORY_DIR=/var/lib/openclaw/trajectories
```

Коли цю змінну задано, OpenClaw записує в цей каталог один JSONL-файл на id сесії.

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

Задайте `OPENCLAW_TRAJECTORY=0` перед запуском OpenClaw:

```bash
export OPENCLAW_TRAJECTORY=0
```

Це вимикає запис trajectory runtime. `/export-trajectory` все ще може експортувати
гілку транскрипту, але файли лише runtime, як-от скомпільований контекст,
артефакти провайдера й метадані prompt-ів, можуть бути відсутні.

## Конфіденційність і обмеження

Trajectory-бандли призначені для підтримки й налагодження, а не для публічного розміщення.
OpenClaw скорочує чутливі значення перед записом файлів експорту:

- облікові дані та відомі поля payload, схожі на секрети
- дані зображень
- шляхи локального стану
- шляхи робочого простору, замінені на `$WORKSPACE_DIR`
- шляхи домашнього каталогу, де їх виявлено

Експортер також обмежує розмір вхідних даних:

- runtime-sidecar файли: 50 MiB
- файли сесій: 50 MiB
- runtime-події: 200,000
- загальна кількість експортованих подій: 250,000
- окремі рядки runtime-подій обрізаються при перевищенні 256 KiB

Переглядайте бандли перед тим, як ділитися ними поза межами вашої команди. Скорочення виконується в режимі best-effort
і не може знати всі секрети, специфічні для вашого застосунку.

## Усунення несправностей

Якщо в експорті немає runtime-подій:

- переконайтеся, що OpenClaw було запущено без `OPENCLAW_TRAJECTORY=0`
- перевірте, чи вказує `OPENCLAW_TRAJECTORY_DIR` на каталог, доступний для запису
- надішліть ще одне повідомлення в сесії, а потім експортуйте ще раз
- перегляньте `manifest.json` на предмет `runtimeEventCount`

Якщо команда відхиляє шлях виводу:

- використовуйте відносну назву, як-от `bug-1234`
- не передавайте `/tmp/...` або `~/...`
- зберігайте експорт усередині `.openclaw/trajectory-exports/`

Якщо експорт завершується помилкою через розмір, сесія або sidecar перевищили
безпечні межі експорту. Почніть нову сесію або експортуйте менше відтворення.

## Пов’язане

- [Diff-и](/uk/tools/diffs)
- [Керування сесіями](/uk/concepts/session)
- [Інструмент Exec](/uk/tools/exec)
