ชุดรวมทราเจกทอรี

Trajectory capture คือเครื่องบันทึกการทำงานรายเซสชันของ OpenClaw โดยจะบันทึกไทม์ไลน์แบบมีโครงสร้างสำหรับการรัน agent แต่ละครั้ง จากนั้น /export-trajectory จะจัดแพ็กเกจเซสชันปัจจุบันเป็นชุดข้อมูลสนับสนุนที่ผ่านการปกปิดข้อมูลแล้ว

ใช้เมื่อต้องตอบคำถามเช่น:

• prompt, system prompt และ tools ใดถูกส่งไปยังโมเดล?
• ข้อความ transcript และ tool calls ใดนำไปสู่คำตอบนี้?
• การรันหมดเวลา ถูกยกเลิก ถูก compact หรือพบข้อผิดพลาดจาก provider หรือไม่?
• โมเดล, Plugin, Skills และการตั้งค่า runtime ใดที่ใช้งานอยู่?
• provider ส่งคืน usage และ prompt-cache metadata อะไรบ้าง?

หากคุณกำลังส่งรายงานสนับสนุนแบบกว้างสำหรับปัญหา Gateway แบบ live ให้เริ่มจาก /diagnostics Diagnostics จะรวบรวมชุดข้อมูล Gateway ที่ผ่านการทำให้ปลอดภัยแล้ว และสำหรับเซสชัน OpenAI Codex harness ยังสามารถส่ง ข้อเสนอแนะของ Codex ไปยังเซิร์ฟเวอร์ OpenAI หลังได้รับการอนุมัติได้ ใช้ /export-trajectory เมื่อคุณต้องการไทม์ไลน์ prompt, tool และ transcript แบบละเอียดเฉพาะรายเซสชัน

# เริ่มต้นอย่างรวดเร็ว

ส่งสิ่งนี้ในเซสชันที่ใช้งานอยู่:

/export-trajectory

นามแฝง:

/trajectory

OpenClaw จะเขียน bundle ไว้ใต้ workspace:

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

คุณสามารถเลือกชื่อไดเรกทอรีเอาต์พุตแบบสัมพัทธ์ได้:

/export-trajectory bug-1234

เส้นทางที่กำหนดเองจะถูก resolve ภายใน .openclaw/trajectory-exports/ เส้นทางแบบ absolute และเส้นทาง ~ จะถูกปฏิเสธ

Trajectory bundles อาจมี prompts, model messages, tool schemas, tool results, runtime events และ local paths ดังนั้นคำสั่ง slash ในแชตจึงต้องผ่าน การอนุมัติ exec ทุกครั้ง อนุมัติการ export หนึ่งครั้งเมื่อคุณตั้งใจจะสร้าง bundle; อย่าใช้ allow-all ในแชตกลุ่ม OpenClaw จะส่ง prompt ขออนุมัติและผลลัพธ์การ export ให้เจ้าของแบบส่วนตัว แทนที่จะโพสต์รายละเอียด trajectory กลับไปยังห้องที่แชร์

สำหรับการตรวจสอบในเครื่องหรือ workflow งานสนับสนุน คุณยังสามารถรันเส้นทางคำสั่งที่ได้รับอนุมัติโดยตรงได้:

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

# การเข้าถึง

Trajectory export เป็นคำสั่งของเจ้าของ ผู้ส่งต้องผ่านการตรวจสอบสิทธิ์คำสั่งตามปกติและการตรวจสอบเจ้าของสำหรับ channel นั้น

# สิ่งที่ถูกบันทึก

Trajectory capture เปิดใช้งานเป็นค่าเริ่มต้นสำหรับการรัน agent ของ OpenClaw

Runtime events ประกอบด้วย:

• session.started
• trace.metadata
• context.compiled
• prompt.submitted
• model.fallback_step รวมถึงโมเดลต้นทาง โมเดลถัดไป เหตุผล/รายละเอียดความล้มเหลว ตำแหน่งใน chain และ fallback เดินหน้าต่อ สำเร็จ หรือใช้ chain จนหมดหรือไม่
• model.completed
• trace.artifacts
• session.ended

Transcript events ยังถูกสร้างใหม่จาก branch เซสชันที่ใช้งานอยู่ด้วย:

• ข้อความผู้ใช้
• ข้อความผู้ช่วย
• tool calls
• tool results
• Compactions
• การเปลี่ยนโมเดล
• labels และรายการเซสชันที่กำหนดเอง

Events จะถูกเขียนเป็น JSON Lines พร้อม schema marker นี้:

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

# ไฟล์ใน Bundle

Bundle ที่ export แล้วอาจมี:

ไฟล์	เนื้อหา
manifest.json	Bundle schema, source files, event counts และรายการไฟล์ที่สร้างขึ้น
events.jsonl	ไทม์ไลน์ runtime และ transcript ตามลำดับ
session-branch.json	Branch transcript ที่ใช้งานอยู่และส่วนหัวเซสชันที่ผ่านการปกปิดข้อมูลแล้ว
metadata.json	เวอร์ชัน OpenClaw, OS/runtime, โมเดล, config snapshot, Plugin, Skills และ prompt metadata
artifacts.json	สถานะสุดท้าย, errors, usage, prompt cache, จำนวน Compaction, ข้อความ assistant และ tool metadata
prompts.json	prompts ที่ส่งและรายละเอียดที่เลือกเกี่ยวกับการสร้าง prompt
system-prompt.txt	system prompt ที่ compile ล่าสุด เมื่อมีการบันทึกไว้
tools.json	tool definitions ที่ส่งไปยังโมเดล เมื่อมีการบันทึกไว้

manifest.json จะแสดงรายการไฟล์ที่มีอยู่ใน bundle นั้น ไฟล์บางไฟล์จะถูกละไว้ เมื่อเซสชันไม่ได้บันทึก runtime data ที่เกี่ยวข้อง

# ตำแหน่งที่บันทึก

โดยค่าเริ่มต้น runtime trajectory events จะถูกเขียนไว้ข้างไฟล์เซสชัน:

<session>.trajectory.jsonl

OpenClaw ยังเขียน pointer file แบบ best-effort ไว้ข้างเซสชันด้วย:

<session>.trajectory-path.json

ตั้งค่า OPENCLAW_TRAJECTORY_DIR เพื่อเก็บ runtime trajectory sidecars ไว้ใน ไดเรกทอรีเฉพาะ:

export OPENCLAW_TRAJECTORY_DIR=/var/lib/openclaw/trajectories

เมื่อตั้งค่าตัวแปรนี้ OpenClaw จะเขียนไฟล์ JSONL หนึ่งไฟล์ต่อ session id ในไดเรกทอรีนั้น

การบำรุงรักษาเซสชันจะลบ trajectory sidecars เมื่อรายการเซสชันที่เป็นเจ้าของถูก pruned, capped หรือ evicted โดย sessions disk budget ไฟล์ runtime ที่อยู่นอก ไดเรกทอรี sessions จะถูกลบเฉพาะเมื่อ pointer target ยังพิสูจน์ได้ว่าเป็นของเซสชันนั้น

# ปิดการบันทึก

ตั้งค่า OPENCLAW_TRAJECTORY=0 ก่อนเริ่ม OpenClaw:

export OPENCLAW_TRAJECTORY=0

สิ่งนี้จะปิด runtime trajectory capture /export-trajectory ยังคง export branch transcript ได้ แต่ไฟล์ที่มีเฉพาะ runtime เช่น compiled context, provider artifacts และ prompt metadata อาจหายไป

# ความเป็นส่วนตัวและข้อจำกัด

Trajectory bundles ถูกออกแบบมาสำหรับงานสนับสนุนและ debugging ไม่ใช่สำหรับโพสต์สาธารณะ OpenClaw จะปกปิดค่าที่ละเอียดอ่อนก่อนเขียนไฟล์ export:

• credentials และฟิลด์ payload ที่มีลักษณะคล้าย secret ที่รู้จัก
• ข้อมูลรูปภาพ
• local state paths
• workspace paths ซึ่งถูกแทนที่ด้วย $WORKSPACE_DIR
• home directory paths เมื่อถูกตรวจพบ

Exporter ยังจำกัดขนาดอินพุตด้วย:

• runtime sidecar files: live capture หยุดที่ 10 MiB และบันทึก truncation event เมื่อยังมีพื้นที่เหลือ; export ยอมรับ runtime sidecars ที่มีอยู่สูงสุด 50 MiB
• session files: 50 MiB
• runtime events: 200,000
• total exported events: 250,000
• บรรทัด runtime event แต่ละบรรทัดจะถูกตัดทอนเมื่อเกิน 256 KiB

ตรวจสอบ bundle ก่อนแชร์ออกนอกทีมของคุณ การปกปิดข้อมูลเป็นแบบ best-effort และไม่สามารถรู้ secret เฉพาะของทุกแอปพลิเคชันได้

# การแก้ไขปัญหา

หาก export ไม่มี runtime events:

• ยืนยันว่า OpenClaw ถูกเริ่มโดยไม่มี OPENCLAW_TRAJECTORY=0
• ตรวจสอบว่า OPENCLAW_TRAJECTORY_DIR ชี้ไปยังไดเรกทอรีที่เขียนได้หรือไม่
• รันข้อความอีกหนึ่งข้อความในเซสชัน แล้ว export อีกครั้ง
• ตรวจสอบ manifest.json สำหรับ runtimeEventCount

หากคำสั่งปฏิเสธเส้นทางเอาต์พุต:

• ใช้ชื่อแบบสัมพัทธ์ เช่น bug-1234
• อย่าส่ง /tmp/... หรือ ~/...
• เก็บ export ไว้ภายใน .openclaw/trajectory-exports/

หาก export ล้มเหลวด้วยข้อผิดพลาดด้านขนาด เซสชันหรือ sidecar เกิน ขีดจำกัดความปลอดภัยของการ export ให้เริ่มเซสชันใหม่หรือ export การทำซ้ำปัญหาที่เล็กลง

# ที่เกี่ยวข้อง

• Diffs
• การจัดการเซสชัน
• Exec tool