Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

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