Gói quỹ đạo

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. 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:

/export-trajectory

Bí danh:

/trajectory

OpenClaw ghi gói dưới workspace:

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

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

/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:

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:

{
  "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:

<session>.trajectory.jsonl

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

<session>.trajectory-path.json

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

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:

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
• Quản lý phiên
• Công cụ exec