Chuyển đến nội dung chính
Ghi lại quỹ đạo là hộp đen theo từng phiên của OpenClaw. Tính năng này 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ợ đã được biên tập, bao gồm:
  • Lời nhắc, lời nhắc hệ thống và các công cụ được gửi đến mô hình
  • Những thông báo bản ghi và lệnh gọi công cụ nào đã dẫn đến câu trả lời
  • Lần chạy có hết thời gian chờ, bị hủy, được Compaction hay gặp lỗi nhà cung cấp hay không
  • Mô hình, các plugin, Skills và cài đặt thời gian chạy nào đang hoạt động
  • Siêu dữ liệu về mức sử dụng và bộ nhớ đệm lời nhắc do nhà cung cấp trả về
Để có báo cáo hỗ trợ Gateway tổng quát, trước tiên hãy bắt đầu bằng /diagnostics; lệnh này thu thập gói Gateway đã được làm sạch và, đối với các phiên dùng bộ khung OpenAI Codex, có thể gửi phản hồi về Codex đến OpenAI sau khi được phê duyệt. Hãy dùng /export-trajectory khi bạn cần dòng thời gian chi tiết theo từng phiên về lời nhắc, công cụ và bản ghi.

​
Bắt đầu nhanh

Gửi trong phiên đang hoạt động (bí danh /trajectory):
OpenClaw ghi gói này vào không gian làm việc:
Truyền tên thư mục đầu ra tương đối để ghi đè vị trí đó:
Tên này đượ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. Các gói quỹ đạo có thể chứa lời nhắc, thông báo mô hình, lược đồ công cụ, kết quả công cụ, sự kiện thời gian chạy và đường dẫn cục bộ, vì vậy lệnh trò chuyện luôn phải qua bước phê duyệt thực thi. Chỉ phê duyệt việc xuất một lần khi bạn có ý định tạo gói; không sử dụng chế độ cho phép tất cả. Trong các cuộc trò chuyện nhóm, OpenClaw gửi riêng lời nhắc phê duyệt và kết quả xuất cho chủ sở hữu thay vì đăng thông tin chi tiết về quỹ đạo trở lại phòng dùng chung. Để kiểm tra cục bộ hoặc dùng trong quy trình hỗ trợ, hãy chạy trực tiếp lệnh CLI nền tảng:
Các cờ khác: --output <path> (tên thư mục bên trong .openclaw/trajectory-exports), --store <path> (ghi đè kho lưu trữ phiên), --agent <id> (ID tác nhân để phân giải kho lưu trữ), --json (đầu ra có cấu trúc).

​
Quyền truy cập

Xuất quỹ đạo là lệnh dành cho chủ sở hữu. Người gửi phải vượt qua các bước kiểm tra ủy quyền lệnh thông thường cùng với bước kiểm tra chủ sở hữu của kênh.

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

Ghi lại quỹ đạo được bật mặc định cho các lần chạy tác nhân OpenClaw. Các sự kiện thời gian chạy 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 chuỗi đã tiến tiếp, thành công hay cạn kiệt
  • model.completed
  • trace.artifacts
  • session.ended
Các sự kiện bản ghi được tái dựng từ nhánh phiên đang hoạt động: thông báo của người dùng, thông báo của trợ lý, lệnh gọi công cụ, kết quả công cụ, các lần Compaction, thay đổi mô hình, nhãn và mục nhập phiên tùy chỉnh. Các sự kiện được ghi dưới dạng JSON Lines với dấu chỉ lược đồ sau:

​
Các tệp trong gói

manifest.json liệt kê các tệp có trong một gói nhất định; một số tệp bị bỏ qua khi phiên không ghi lại dữ liệu thời gian chạy tương ứng.

​
Lưu trữ dữ liệu ghi lại

Các sự kiện quỹ đạo thời gian chạy được lưu cùng với phiên trong cơ sở dữ liệu SQLite riêng cho từng tác nhân. Việc xuất quỹ đạo tạo ra một gói hỗ trợ JSONL đã được biên tập; dữ liệu ghi lại trực tiếp trong thời gian chạy không phải là tệp JSONL phụ nằm cạnh phiên. Các tệp .trajectory.jsonl và .trajectory-path.json cũ vẫn có thể xuất hiện từ các bản phát hành trước hoặc các lần xuất tệp cũ được yêu cầu rõ ràng. Hoạt động bảo trì phiên coi những tệp này là mục tiêu dọn dẹp; quá trình ghi đang hoạt động sẽ ghi các hàng vào cơ sở dữ liệu.

​
Tắt ghi lại

Lệnh này tắt việc ghi lại quỹ đạo thời gian chạy trước khi khởi động OpenClaw. /export-trajectory vẫn có thể xuất nhánh bản ghi, nhưng dữ liệu chỉ có trong thời gian chạy như ngữ cảnh đã biên dịch, hiện vật của nhà cung cấp và siêu dữ liệu lời nhắc có thể bị thiếu.

​
Điều chỉnh thời gian chờ xả dữ liệu

OpenClaw xả các hàng quỹ đạo thời gian chạy trong quá trình dọn dẹp tác nhân. Thời gian chờ dọn dẹp mặc định là 10,000 ms. Trên ổ đĩa chậm hoặc kho lưu trữ lớn, hãy đặt OPENCLAW_TRAJECTORY_FLUSH_TIMEOUT_MS trước khi khởi động OpenClaw:
Thiết lập này kiểm soát thời điểm OpenClaw ghi nhật ký lỗi hết thời gian chờ openclaw-trajectory-flush rồi tiếp tục; nó không thay đổi giới hạn kích thước quỹ đạo. Để điều chỉnh tất cả các bước dọn dẹp tác nhân không truyền thời gian chờ rõ ràng, hãy đặt OPENCLAW_AGENT_CLEANUP_TIMEOUT_MS.

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

Các gói quỹ đạo dành 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 xuất:
  • thông tin xác thực và các trường tải trọng đã biết có dạng bí mật
  • dữ liệu hình ảnh
  • đường dẫn trạng thái cục bộ
  • đường dẫn không gian làm việc, được thay bằng $WORKSPACE_DIR
  • đường dẫn thư mục chính, khi phát hiện được
Trình xuất cũng giới hạn kích thước đầu vào:
  • ghi lại thời gian chạy: dữ liệu ghi trực tiếp là một cửa sổ cuộn có giới hạn 10 MiB, loại bỏ các sự kiện cũ nhất để dành chỗ cho sự kiện mới; quá trình xuất chấp nhận các tệp phụ thời gian chạy cũ hiện có có kích thước tối đa 50 MiB
  • tệp phiên: 50 MiB
  • sự kiện thời gian chạy mỗi lần xuất: 200,000
  • tổng số sự kiện được xuất: 250,000
  • các dòng sự kiện thời gian chạy riêng lẻ bị cắt bớt khi vượt quá 256 KiB
Hãy xem xét các gói trước khi chia sẻ chúng ra ngoài nhóm của bạn. Việc biên tập được thực hiện theo khả năng tốt nhất và không thể biết mọi bí mật riêng của từng ứng dụng.

​
Khắc phục sự cố

Nếu bản xuất không có sự kiện thời gian chạy:
  • xác nhận OpenClaw đã được khởi động mà không có OPENCLAW_TRAJECTORY=0
  • chạy thêm một thông báo trong phiên, rồi xuất lại
  • kiểm tra manifest.json để tìm runtimeEventCount
Nếu lệnh từ chối đường dẫn đầu ra:
  • sử dụng tên tương đối như bug-1234
  • không truyền /tmp/... hoặc ~/...
  • giữ bản xuất bên trong .openclaw/trajectory-exports/
Nếu quá trình xuất thất bại do lỗi kích thước, phiên hoặc tệp phụ đã vượt quá các giới hạn an toàn xuất ở trên. Hãy bắt đầu phiên mới hoặc xuất một trường hợp tái hiện nhỏ hơn.

​
Liên quan