Get started

CLI สำหรับข้อความถอดเสียง

openclaw transcripts

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

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

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

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

คำสั่ง

bash
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
คำสั่ง คำอธิบาย
list แสดงรายการเซสชันที่จัดเก็บไว้
show <session> พิมพ์ summary.md ที่จัดเก็บไว้
path <session> พิมพ์พาธ summary.md
path <session> --dir พิมพ์ไดเรกทอรีเซสชัน
path <session> --metadata พิมพ์ metadata.json
path <session> --transcript พิมพ์ transcript.jsonl
--json พิมพ์เอาต์พุตที่เครื่องอ่านได้ (ใช้ได้กับทุกคำสั่งย่อย)

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

เอาต์พุต

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

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

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

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

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

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

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

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

text
~/.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 ใหม่

การกำหนดค่า

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

json
{  "transcripts": {    "enabled": true  }}
  • enabled (ค่าเริ่มต้น false): เปิดเครื่องมือ กำหนดค่าแหล่งที่มาเริ่มต้นอัตโนมัติด้วย transcripts.autoStart แต่ละรายการจะ เปิดใช้เมื่อมีรายการนั้นอยู่ หากต้องการปิดใช้แหล่งที่มานั้นให้ละเว้นรายการ discord-voice เป็นแหล่งที่มาแบบรวมมาให้ซึ่งรองรับการเริ่มต้นอัตโนมัติ และต้องใช้ guildId กับ channelId:
json
{  "transcripts": {    "enabled": true,    "autoStart": [      {        "providerId": "discord-voice",        "guildId": "1234567890",        "channelId": "2345678901"      }    ]  }}
Was this useful?
On this page

On this page