Get started

CLI สำหรับบันทึกการสนทนา

openclaw transcripts

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

ใช้ CLI เมื่อต้องการหาโน้ตของเมื่อวาน เปิดไฟล์ Markdown ในเอดิเตอร์ ป้อนทรานสคริปต์ให้เครื่องมืออื่น หรือดีบักว่าเซสชันถูกจัดเก็บไว้ที่ใดบนดิสก์ เครื่องมือนี้ไม่เริ่มหรือหยุดการบันทึก

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

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

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

คำสั่ง

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

เมื่อรหัสเซสชันที่มนุษย์ตั้งซ้ำกันข้ามวัน ให้ใช้ตัวเลือกที่ระบุวันที่จาก list เช่น openclaw transcripts show 2026-05-22/standup รหัสเซสชันเริ่มต้นมีไทม์สแตมป์และส่วนต่อท้ายแบบสุ่ม; กำหนดค่ารหัสเซสชันแบบคงที่เฉพาะเมื่อรหัสนั้นไม่ซ้ำกันภายในวันเดียวกัน

เอาต์พุต

list พิมพ์หนึ่งเซสชันต่อหนึ่งบรรทัด:

text
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 พิมพ์ออบเจ็กต์ที่มี:

  • sessionId
  • selector
  • date
  • title
  • startedAt
  • stoppedAt
  • source
  • path
  • summaryPath
  • hasSummary

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

การประชุมหลายรายการต่อวัน

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

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

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

การกำหนดค่า

การบันทึกทรานสคริปต์เป็นแบบเลือกเปิดใช้ เพราะแหล่งที่มาสดสามารถเข้าร่วมและบันทึกเสียงการประชุมได้ เปิดใช้เครื่องมือด้วย transcripts.enabled ระดับบนสุด:

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

กำหนดค่าแหล่งที่มาแบบเริ่มอัตโนมัติด้วย transcripts.autoStart ใน openclaw.json แต่ละรายการจะเปิดใช้เมื่อมีอยู่; ละเว้นรายการเพื่อปิดใช้แหล่งที่มานั้น

json
{  "transcripts": {    "enabled": true,    "autoStart": [      {        "providerId": "discord-voice",        "guildId": "1234567890",        "channelId": "2345678901"      },      {        "providerId": "slack-huddle",        "accountId": "workspace",        "channelId": "C123"      }    ]  }}
Was this useful?
On this page

On this page