---
read_when:
    - Gỡ lỗi lý do tác nhân trả lời, thất bại hoặc gọi công cụ theo một cách nhất định
    - Xuất gói hỗ trợ cho một phiên OpenClaw
    - Điều tra ngữ cảnh lời nhắc, lệnh gọi công cụ, lỗi thời gian chạy hoặc siêu dữ liệu sử dụng
    - Tắt hoặc chuyển vị trí lưu bản ghi quỹ đạo
summary: Xuất các gói trajectory đã được che thông tin nhạy cảm để gỡ lỗi phiên tác tử OpenClaw
title: Gói quỹ đạo
x-i18n:
    generated_at: "2026-05-04T09:37:12Z"
    model: gpt-5.5
    provider: openai
    source_hash: b8b1256e52d27185a48ceddaf7937b4f37ad6d57d075fea0d0b6d3abb871f1d8
    source_path: tools/trajectory.md
    workflow: 16
---

Trajectory capture là bộ ghi chuyến bay theo từng phiên của OpenClaw. Nó ghi lại
dòng thời gian có cấu trúc cho mỗi lần chạy tác nhân, sau đó `/export-trajectory` đóng gói
phiên hiện tại thành một gói hỗ trợ đã biên tập.

Sử dụng nó khi bạn cần trả lời các câu hỏi như:

- Prompt, system prompt và công cụ nào đã được gửi tới mô hình?
- Những tin nhắn transcript và lệnh gọi công cụ nào đã dẫn tới câu trả lời này?
- Lần chạy có bị hết thời gian, hủy bỏ, compact hay gặp lỗi nhà cung cấp không?
- Mô hình, plugin, Skills và cài đặt runtime nào đang hoạt động?
- Nhà cung cấp đã trả về metadata sử dụng và prompt-cache nào?

Nếu bạn đang gửi một báo cáo hỗ trợ phạm vi rộng cho sự cố Gateway trực tiếp, hãy bắt đầu với
[`/diagnostics`](/vi/gateway/diagnostics#chat-command). Diagnostics thu thập gói Gateway
đã được làm sạch và, đối với các phiên harness OpenAI Codex, cũng có thể gửi
phản hồi Codex tới máy chủ OpenAI sau khi được phê duyệt. Sử dụng `/export-trajectory` khi
bạn cần cụ thể dòng thời gian chi tiết theo từng phiên về prompt, công cụ và transcript.

## Bắt đầu nhanh

Gửi nội dung này trong phiên đang hoạt động:

```text
/export-trajectory
```

Bí danh:

```text
/trajectory
```

OpenClaw ghi gói dưới workspace:

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

Bạn có thể chọn tên thư mục đầu ra tương đối:

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

Đường dẫn tùy chỉnh được phân giải bên trong `.openclaw/trajectory-exports/`. Đường dẫn
tuyệt đối và đường dẫn `~` bị từ chối.

Gói trajectory có thể chứa prompt, tin nhắn mô hình, schema công cụ, kết quả
công cụ, sự kiện runtime và đường dẫn cục bộ. Vì vậy lệnh slash trong chat luôn
chạy qua phê duyệt exec. Hãy phê duyệt việc export một lần khi bạn có ý định
tạo gói; không dùng allow-all. Trong chat nhóm, OpenClaw gửi lời nhắc phê duyệt
và kết quả export riêng cho chủ sở hữu thay vì đăng chi tiết trajectory trở lại
phòng chung.

Đối với quy trình kiểm tra cục bộ hoặc hỗ trợ, bạn cũng có thể chạy trực tiếp
đường dẫn lệnh đã được phê duyệt:

```bash
openclaw sessions export-trajectory --session-key "agent:main:telegram:direct:123" --workspace .
```

## Quyền truy cập

Trajectory export là lệnh của chủ sở hữu. Người gửi phải vượt qua các kiểm tra
ủy quyền lệnh thông thường và kiểm tra chủ sở hữu cho kênh.

## Nội dung được ghi lại

Trajectory capture được bật mặc định cho các lần chạy tác nhân OpenClaw.

Sự kiện runtime bao gồm:

- `session.started`
- `trace.metadata`
- `context.compiled`
- `prompt.submitted`
- `model.fallback_step`, bao gồm mô hình nguồn, mô hình tiếp theo, lý do/chi tiết lỗi, vị trí trong chuỗi và việc fallback đã tiến lên, thành công hay dùng hết chuỗi
- `model.completed`
- `trace.artifacts`
- `session.ended`

Sự kiện transcript cũng được tái dựng từ nhánh phiên đang hoạt động:

- tin nhắn người dùng
- tin nhắn trợ lý
- lệnh gọi công cụ
- kết quả công cụ
- compactions
- thay đổi mô hình
- nhãn và mục phiên tùy chỉnh

Sự kiện được ghi dưới dạng JSON Lines với marker schema này:

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

## Tệp trong gói

Một gói đã export có thể chứa:

| Tệp                   | Nội dung                                                                                       |
| --------------------- | ---------------------------------------------------------------------------------------------- |
| `manifest.json`       | Schema gói, tệp nguồn, số lượng sự kiện và danh sách tệp đã tạo                                |
| `events.jsonl`        | Dòng thời gian runtime và transcript theo thứ tự                                                |
| `session-branch.json` | Nhánh transcript đang hoạt động và header phiên đã biên tập                                    |
| `metadata.json`       | Phiên bản OpenClaw, OS/runtime, mô hình, snapshot cấu hình, plugin, Skills và metadata prompt  |
| `artifacts.json`      | Trạng thái cuối, lỗi, sử dụng, prompt cache, số lượng compaction, văn bản trợ lý và metadata công cụ |
| `prompts.json`        | Prompt đã gửi và chi tiết tạo prompt đã chọn                                                    |
| `system-prompt.txt`   | System prompt đã biên dịch mới nhất, khi được ghi lại                                           |
| `tools.json`          | Định nghĩa công cụ được gửi tới mô hình, khi được ghi lại                                       |

`manifest.json` liệt kê các tệp có trong gói đó. Một số tệp bị bỏ qua
khi phiên không ghi lại dữ liệu runtime tương ứng.

## Vị trí capture

Theo mặc định, các sự kiện runtime trajectory được ghi cạnh tệp phiên:

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

OpenClaw cũng ghi một tệp con trỏ theo best-effort cạnh phiên:

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

Đặt `OPENCLAW_TRAJECTORY_DIR` để lưu sidecar runtime trajectory trong một
thư mục chuyên dụng:

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

Khi biến này được đặt, OpenClaw ghi một tệp JSONL cho mỗi id phiên trong
thư mục đó.

Bảo trì phiên xóa các sidecar trajectory khi mục phiên sở hữu chúng bị
cắt tỉa, giới hạn hoặc loại bỏ bởi ngân sách đĩa của phiên. Các tệp runtime bên ngoài
thư mục phiên chỉ bị xóa khi đích con trỏ vẫn chứng minh rằng nó
thuộc về phiên đó.

## Tắt capture

Đặt `OPENCLAW_TRAJECTORY=0` trước khi khởi động OpenClaw:

```bash
export OPENCLAW_TRAJECTORY=0
```

Điều này tắt runtime trajectory capture. `/export-trajectory` vẫn có thể export
nhánh transcript, nhưng các tệp chỉ có ở runtime như context đã biên dịch,
artifact nhà cung cấp và metadata prompt có thể bị thiếu.

## Quyền riêng tư và giới hạn

Gói trajectory được thiết kế cho hỗ trợ và gỡ lỗi, không phải để đăng công khai.
OpenClaw biên tập các giá trị nhạy cảm trước khi ghi tệp export:

- thông tin xác thực và các trường payload giống bí mật đã biết
- dữ liệu hình ảnh
- đường dẫn trạng thái cục bộ
- đường dẫn workspace, được thay bằng `$WORKSPACE_DIR`
- đường dẫn thư mục home, khi phát hiện được

Exporter cũng giới hạn kích thước đầu vào:

- tệp sidecar runtime: live capture dừng ở 10 MiB và ghi sự kiện cắt ngắn khi còn dung lượng; export chấp nhận sidecar runtime hiện có tối đa 50 MiB
- tệp phiên: 50 MiB
- sự kiện runtime: 200.000
- tổng số sự kiện đã export: 250.000
- từng dòng sự kiện runtime bị cắt ngắn khi vượt quá 256 KiB

Hãy xem lại các gói trước khi chia sẻ chúng bên ngoài nhóm của bạn. Việc biên tập là best-effort
và không thể biết mọi bí mật riêng theo từng ứng dụng.

## Khắc phục sự cố

Nếu bản export không có sự kiện runtime:

- xác nhận OpenClaw đã được khởi động mà không có `OPENCLAW_TRAJECTORY=0`
- kiểm tra xem `OPENCLAW_TRAJECTORY_DIR` có trỏ tới thư mục có thể ghi không
- chạy một tin nhắn khác trong phiên, rồi export lại
- kiểm tra `manifest.json` để tìm `runtimeEventCount`

Nếu lệnh từ chối đường dẫn đầu ra:

- dùng tên tương đối như `bug-1234`
- không truyền `/tmp/...` hoặc `~/...`
- giữ bản export bên trong `.openclaw/trajectory-exports/`

Nếu export thất bại với lỗi kích thước, phiên hoặc sidecar đã vượt quá
giới hạn an toàn export. Hãy bắt đầu một phiên mới hoặc export một bản tái hiện nhỏ hơn.

## Liên quan

- [Diffs](/vi/tools/diffs)
- [Quản lý phiên](/vi/concepts/session)
- [Công cụ exec](/vi/tools/exec)