Get started
CLI สำหรับบันทึกการสนทนา
openclaw transcripts
ตรวจสอบทรานสคริปต์ที่เขียนโดยเครื่องมือ transcripts หลักของ OpenClaw CLI นี้เป็นแบบอ่านอย่างเดียว; การบันทึก การนำเข้า และการสรุปเป็นหน้าที่ของเครื่องมือเอเจนต์และแหล่งที่มาแบบเริ่มอัตโนมัติที่กำหนดค่าไว้
ใช้ CLI เมื่อต้องการหาโน้ตของเมื่อวาน เปิดไฟล์ Markdown ในเอดิเตอร์ ป้อนทรานสคริปต์ให้เครื่องมืออื่น หรือดีบักว่าเซสชันถูกจัดเก็บไว้ที่ใดบนดิสก์ เครื่องมือนี้ไม่เริ่มหรือหยุดการบันทึก
อาร์ติแฟกต์อยู่ใต้ไดเรกทอรีสถานะของ OpenClaw:
$OPENCLAW_STATE_DIR/transcripts/YYYY-MM-DD/<session>/ metadata.json transcript.jsonl summary.json summary.mdไดเรกทอรีสถานะเริ่มต้นคือ ~/.openclaw; ตั้งค่า OPENCLAW_STATE_DIR เพื่อใช้ตำแหน่งอื่น ไดเรกทอรีวันที่มาจากเวลาเริ่มเซสชัน และไดเรกทอรีเซสชันเป็นเซกเมนต์ระบบไฟล์ที่ปลอดภัยซึ่งได้มาจากรหัสเซสชัน
คำสั่ง
openclaw transcripts listopenclaw transcripts show <session>openclaw transcripts show YYYY-MM-DD/<session>openclaw transcripts path <session>openclaw transcripts path YYYY-MM-DD/<session>openclaw transcripts path <session> --diropenclaw transcripts path <session> --metadataopenclaw transcripts path <session> --transcriptopenclaw transcripts list --jsonopenclaw transcripts show <session> --jsonopenclaw transcripts path <session> --jsonlist: แสดงรายการเซสชันที่จัดเก็บ ตัวเลือกที่ระบุวันที่ เวลาเริ่มต้น ชื่อ และพาธsummary.mdshow <session>: พิมพ์summary.mdที่จัดเก็บไว้path <session>: พิมพ์พาธsummary.mdpath <session> --dir: พิมพ์ไดเรกทอรีเซสชันpath <session> --metadata: พิมพ์metadata.jsonpath <session> --transcript: พิมพ์transcript.jsonl--json: พิมพ์เอาต์พุตที่เครื่องอ่านได้
เมื่อรหัสเซสชันที่มนุษย์ตั้งซ้ำกันข้ามวัน ให้ใช้ตัวเลือกที่ระบุวันที่จาก list เช่น openclaw transcripts show 2026-05-22/standup รหัสเซสชันเริ่มต้นมีไทม์สแตมป์และส่วนต่อท้ายแบบสุ่ม; กำหนดค่ารหัสเซสชันแบบคงที่เฉพาะเมื่อรหัสนั้นไม่ซ้ำกันภายในวันเดียวกัน
เอาต์พุต
list พิมพ์หนึ่งเซสชันต่อหนึ่งบรรทัด:
2026-05-22/standup 2026-05-22T09:00:00.000Z Weekly standup /Users/alex/.openclaw/transcripts/2026-05-22/standup/summary.mdเอาต์พุตคั่นด้วยแท็บ คอลัมน์คือ ตัวเลือก เวลาเริ่มต้น ชื่อ และพาธสรุป ตัวเลือกคือค่าที่ปลอดภัยที่สุดสำหรับส่งกลับไปยัง show หรือ path
list --json พิมพ์ออบเจ็กต์ที่มี:
sessionIdselectordatetitlestartedAtstoppedAtsourcepathsummaryPathhasSummary
show --json ส่งคืนเมตาดาต้าเซสชันที่จัดเก็บ ตัวเลือก ไดเรกทอรีเซสชัน พาธสรุป และข้อความสรุป Markdown path --json ส่งคืนพาธที่เลือกและระบุว่าไฟล์นั้นมีอยู่หรือไม่
การประชุมหลายรายการต่อวัน
Transcripts จัดกลุ่มเซสชันตามวันที่ จากนั้นตามรหัสเซสชัน การประชุมสิบรายการในหนึ่งวันจะกลายเป็นโฟลเดอร์พี่น้องสิบโฟลเดอร์:
~/.openclaw/transcripts/2026-05-22/ transcript-2026-05-22T09-00-00-000Z-a1b2c3d4/ transcript-2026-05-22T10-30-00-000Z-b2c3d4e5/ standup/ใช้รหัสที่สร้างตามค่าเริ่มต้นสำหรับงานอัตโนมัติส่วนใหญ่ ใช้รหัสคงที่ เช่น standup เฉพาะเมื่อรหัสเดียวกันจะไม่ถูกใช้สองครั้งในวันที่เดียวกัน
สรุปที่หายไป
เซสชันสดเขียน summary.md เมื่อเซสชันหยุด ทรานสคริปต์ที่นำเข้าจะเขียน summary.md ทันทีหลังนำเข้า เซสชันยังคงปรากฏใน list ได้โดยไม่มีสรุป เมื่อการบันทึกยังทำงานอยู่ ผู้ให้บริการล้มเหลวระหว่างการหยุด หรือเมตาดาต้าถูกเขียนก่อนมีคำพูดใดๆ เข้ามา
ใช้ path <session> --transcript เพื่อตรวจสอบทรานสคริปต์แบบเขียนต่อท้ายเท่านั้น และใช้แอ็กชันเครื่องมือ transcripts ชื่อ summarize เพื่อสร้างสรุป Markdown ใหม่
การกำหนดค่า
การบันทึกทรานสคริปต์เป็นแบบเลือกเปิดใช้ เพราะแหล่งที่มาสดสามารถเข้าร่วมและบันทึกเสียงการประชุมได้ เปิดใช้เครื่องมือด้วย transcripts.enabled ระดับบนสุด:
{ "transcripts": { "enabled": true, "maxUtterances": 2000 }}กำหนดค่าแหล่งที่มาแบบเริ่มอัตโนมัติด้วย transcripts.autoStart ใน openclaw.json แต่ละรายการจะเปิดใช้เมื่อมีอยู่; ละเว้นรายการเพื่อปิดใช้แหล่งที่มานั้น
{ "transcripts": { "enabled": true, "autoStart": [ { "providerId": "discord-voice", "guildId": "1234567890", "channelId": "2345678901" }, { "providerId": "slack-huddle", "accountId": "workspace", "channelId": "C123" } ] }}