openclaw transcripts

เครื่องมือตรวจสอบแบบอ่านอย่างเดียวสำหรับบทถอดเสียงที่เขียนโดยเครื่องมือเอเจนต์ transcripts การบันทึก การนำเข้า และการสรุปจะทำงานผ่านเครื่องมือนั้น ไม่ใช่ CLI นี้

อาร์ติแฟกต์อยู่ภายใต้ไดเรกทอรีสถานะ:

$OPENCLAW_STATE_DIR/transcripts/YYYY-MM-DD/<session>/  metadata.json  transcript.jsonl  summary.json  summary.md

ไดเรกทอรีสถานะเริ่มต้นคือ ~/.openclaw; กำหนดทับด้วย OPENCLAW_STATE_DIR ไดเรกทอรีวันที่มาจากเวลาเริ่มต้นของเซสชัน ส่วนไดเรกทอรีเซสชันคือ slug ที่ปลอดภัยสำหรับระบบไฟล์ซึ่งสร้างจากรหัสเซสชัน

คำสั่ง

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> --json

<session> รองรับทั้งรหัสเซสชันเปล่าและตัวเลือกที่ระบุวันที่ (YYYY-MM-DD/<session>) ใช้รูปแบบที่ระบุวันที่เมื่อมีรหัสเซสชันเดียวกัน ในมากกว่าหนึ่งวัน เช่น openclaw transcripts show 2026-05-22/standup รหัสเซสชันเริ่มต้นประกอบด้วยการประทับเวลาและส่วนต่อท้าย แบบสุ่ม ให้กำหนดรหัสคงที่แก่เซสชันเฉพาะเมื่อรหัสนั้นไม่ซ้ำกันภายในวันนั้น

ผลลัพธ์

list แสดงหนึ่งบรรทัดที่คั่นด้วยแท็บต่อเซสชัน ได้แก่ ตัวเลือก เวลาเริ่มต้น ชื่อเรื่อง และพาธสรุป

2026-05-22/standup  2026-05-22T09:00:00.000Z  การประชุมประจำสัปดาห์  /Users/user/.openclaw/transcripts/2026-05-22/standup/summary.md

ตัวเลือกคือค่าที่ปลอดภัยที่สุดสำหรับส่งกลับไปยัง show หรือ path

list --json คืนค่าออบเจ็กต์ที่มี sessionId, selector, date, title, startedAt, stoppedAt, source, path, summaryPath, hasSummary

show --json คืนค่าเมทาดาทาของเซสชันที่จัดเก็บไว้ ตัวเลือก ไดเรกทอรีเซสชัน พาธสรุป และข้อความ Markdown ของสรุป

path --json คืนค่าพาธที่เลือกและระบุว่าไฟล์นั้นมีอยู่หรือไม่

หลายเซสชันต่อวัน

เซสชันจะจัดกลุ่มตามวันที่ แล้วจึงตามรหัสเซสชัน การประชุมสิบครั้งในหนึ่งวันจะกลายเป็น โฟลเดอร์ร่วมระดับสิบโฟลเดอร์:

~/.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 เมื่อเซสชันหยุด ส่วนบทถอดเสียงที่นำเข้าจะ เขียนไฟล์นี้ทันทีหลังนำเข้า เซสชันอาจปรากฏใน list โดยไม่มีสรุป ขณะที่การบันทึกยังทำงานอยู่ หากผู้ให้บริการล้มเหลวระหว่างการหยุด หรือหาก เมทาดาทาถูกเขียนก่อนที่จะได้รับถ้อยคำใด ๆ

ใช้ path <session> --transcript เพื่อตรวจสอบบทถอดเสียงดิบแบบเพิ่มต่อท้ายเท่านั้น หรือเรียกใช้การดำเนินการ summarize ของเครื่องมือ transcripts เพื่อสร้างสรุป Markdown ขึ้นใหม่

การกำหนดค่า

ต้องเลือกเปิดใช้การบันทึก (แหล่งข้อมูลสดสามารถเข้าร่วมและบันทึกเสียงการประชุมได้) เปิดใช้ ด้วย:

{  "transcripts": {    "enabled": true,    "maxUtterances": 2000  }}

• enabled (ค่าเริ่มต้น false): เปิดใช้เครื่องมือ
• maxUtterances (ค่าเริ่มต้น 2000, จำกัดให้อยู่ระหว่าง 1-10000): ขนาดบัฟเฟอร์ถ้อยคำต่อ เซสชัน

กำหนดค่าแหล่งข้อมูลที่เริ่มโดยอัตโนมัติด้วย transcripts.autoStart แต่ละรายการจะ เปิดใช้งานเมื่อมีรายการนั้นอยู่ หากต้องการปิดใช้งานแหล่งข้อมูล ให้ละเว้นรายการนั้น discord-voice คือแหล่งข้อมูลแบบรวมมาให้ซึ่งรองรับการเริ่มโดยอัตโนมัติ และต้องระบุ guildId กับ channelId:

{  "transcripts": {    "enabled": true,    "autoStart": [      {        "providerId": "discord-voice",        "guildId": "1234567890",        "channelId": "2345678901"      }    ]  }}