openclaw transcripts
檢查由 OpenClaw 核心 transcripts 工具寫入的逐字稿。此命令列介面為唯讀;擷取、匯入和摘要由代理工具以及已設定的自動啟動來源負責。
當你想尋找昨天的筆記、在編輯器中開啟 Markdown 檔案、將逐字稿提供給另一個工具,或偵錯某個工作階段落在磁碟上的位置時,請使用此命令列介面。它不會啟動或停止擷取。
成品位於 OpenClaw 狀態目錄下:
~/.openclaw;設定 OPENCLAW_STATE_DIR 可使用不同目錄。日期目錄來自工作階段開始時間,而工作階段目錄則是從工作階段 id 衍生出的安全檔案系統區段。
命令
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。預設工作階段 id 包含時間戳記和隨機後綴;只有在固定工作階段 id 於當日內唯一時,才設定固定工作階段 id。
輸出
list 每行列印一個工作階段:
show 或 path 時最安全的值。
list --json 會列印包含以下欄位的物件:
sessionIdselectordatetitlestartedAtstoppedAtsourcepathsummaryPathhasSummary
show --json 會傳回已儲存的工作階段中繼資料、選擇器、工作階段目錄、摘要路徑和摘要 Markdown 文字。path --json 會傳回所選路徑,以及該檔案是否存在。
每天多場會議
逐字稿會先依日期分組工作階段,再依工作階段 id 分組。同一天的十場會議會成為十個同層資料夾:standup 這樣的固定 id。
缺少摘要
即時工作階段會在工作階段停止時寫入summary.md。匯入的逐字稿會在匯入後立即寫入 summary.md。當擷取仍在進行中、提供者在停止期間失敗,或中繼資料在任何發言到達前就已寫入時,工作階段仍可能出現在 list 中但沒有摘要。
使用 path <session> --transcript 檢查僅附加的逐字稿,並使用 transcripts 工具動作 summarize 重新產生 Markdown 摘要。
設定
逐字稿擷取為選擇啟用,因為即時來源可以加入並錄製會議音訊。使用頂層transcripts.enabled 啟用此工具:
openclaw.json 中使用 transcripts.autoStart 設定自動啟動來源。每個項目只要存在即為啟用;省略某個項目即可停用該來源。