--- read_when: - Отладка того, почему агент ответил, завершился с ошибкой или вызвал инструменты определённым образом - Экспорт пакета поддержки для сеанса OpenClaw - Исследование контекста промпта, вызовов инструментов, ошибок среды выполнения или метаданных использования - Отключение или перенос захвата траектории summary: Экспорт пакетов траекторий с удалёнными конфиденциальными данными для отладки сеанса агента OpenClaw title: Пакеты траекторий x-i18n: generated_at: "2026-06-28T23:56:28Z" model: gpt-5.5 postprocess_version: locale-links-v1 provider: openai source_hash: bf48616c29a1055f26d39a88869c025db7e6261b13dcaa0cd35be438c6a86a88 source_path: tools/trajectory.md workflow: 16 --- Захват траектории — это посеансовый бортовой самописец OpenClaw. Он записывает структурированную временную шкалу для каждого запуска агента, затем `/export-trajectory` упаковывает текущий сеанс в отредактированный пакет для поддержки. Используйте его, когда нужно ответить на такие вопросы: - Какой промпт, системный промпт и инструменты были отправлены модели? - Какие сообщения транскрипта и вызовы инструментов привели к этому ответу? - Завершился ли запуск по тайм-ауту, был ли прерван, прошел ли Compaction или столкнулся с ошибкой провайдера? - Какая модель, Plugin, Skills и настройки среды выполнения были активны? - Какие метаданные использования и кэша промптов вернул провайдер? Если вы отправляете широкий отчет в поддержку о проблеме живого Gateway, начните с [`/diagnostics`](/ru/gateway/diagnostics#chat-command). Диагностика собирает санитизированный пакет Gateway и для сеансов harness OpenAI Codex также может отправлять отзыв 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` События транскрипта также реконструируются из активной ветки сеанса: - сообщения пользователя - сообщения ассистента - вызовы инструментов - результаты инструментов - Compaction - изменения модели - метки и пользовательские записи сеанса События записываются как JSON Lines с этим маркером схемы: ```json { "traceSchema": "openclaw-trajectory", "schemaVersion": 1 } ``` ## Файлы пакета Экспортированный пакет может содержать: | Файл | Содержимое | | --------------------- | ---------------------------------------------------------------------------------------------- | | `manifest.json` | Схема пакета, исходные файлы, счетчики событий и список сгенерированных файлов | | `events.jsonl` | Упорядоченная временная шкала среды выполнения и транскрипта | | `session-branch.json` | Отредактированная активная ветка транскрипта и заголовок сеанса | | `metadata.json` | Версия OpenClaw, ОС/среда выполнения, модель, снимок конфигурации, Plugin, 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`, чтобы хранить sidecar-файлы траектории среды выполнения в выделенном каталоге: ```bash export OPENCLAW_TRAJECTORY_DIR=/var/lib/openclaw/trajectories ``` Когда эта переменная задана, OpenClaw записывает один файл JSONL на каждый идентификатор сеанса в этом каталоге. Обслуживание сеансов удаляет sidecar-файлы траектории, когда принадлежащая им запись сеанса обрезается, ограничивается лимитом или вытесняется из-за дискового бюджета сеансов. Файлы среды выполнения вне каталога сеансов удаляются только тогда, когда целевой указатель все еще доказывает, что принадлежит этому сеансу. ## Отключение захвата Задайте `OPENCLAW_TRAJECTORY=0` перед запуском OpenClaw: ```bash export OPENCLAW_TRAJECTORY=0 ``` Это отключает захват траектории среды выполнения. `/export-trajectory` все еще может экспортировать ветку транскрипта, но файлы, существующие только в среде выполнения, такие как скомпилированный контекст, артефакты провайдера и метаданные промптов, могут отсутствовать. ## Настройка тайм-аута сброса OpenClaw сбрасывает sidecar-файлы траектории среды выполнения во время очистки агента. Тайм-аут очистки по умолчанию составляет 10 000 мс. На медленных дисках или больших хранилищах задайте `OPENCLAW_TRAJECTORY_FLUSH_TIMEOUT_MS` перед запуском OpenClaw: ```bash export OPENCLAW_TRAJECTORY_FLUSH_TIMEOUT_MS=30000 ``` Это управляет тем, когда OpenClaw логирует тайм-аут `openclaw-trajectory-flush` и продолжает работу. Это не меняет ограничения размера траектории. Чтобы настроить все шаги очистки агента, которые не передают явный тайм-аут, задайте `OPENCLAW_AGENT_CLEANUP_TIMEOUT_MS`. ## Конфиденциальность и ограничения Пакеты траектории предназначены для поддержки и отладки, а не для публичной публикации. OpenClaw редактирует чувствительные значения перед записью файлов экспорта: - учетные данные и известные поля полезной нагрузки, похожие на секреты - данные изображений - локальные пути состояния - пути рабочей области, заменяемые на `$WORKSPACE_DIR` - пути домашнего каталога, где они обнаружены Экспортер также ограничивает размер входных данных: - sidecar-файлы среды выполнения: живой захват останавливается на 10 MiB и записывает событие усечения, когда остается место; экспорт принимает существующие 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-файл превысил ограничения безопасности экспорта. Начните новый сеанс или экспортируйте меньшую репродукцию. ## Связанные материалы - [Diffs](/ru/tools/diffs) - [Управление сеансами](/ru/concepts/session) - [Инструмент Exec](/ru/tools/exec)