openclaw transcripts

檢查由 OpenClaw 核心 transcripts 工具寫入的逐字稿。此命令列介面為唯讀；擷取、匯入和摘要由代理工具以及已設定的自動啟動來源負責。

當你想尋找昨天的筆記、在編輯器中開啟 Markdown 檔案、將逐字稿提供給另一個工具，或偵錯某個工作階段落在磁碟上的位置時，請使用此命令列介面。它不會啟動或停止擷取。

成品位於 OpenClaw 狀態目錄下：

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

預設狀態目錄是 ~/.openclaw；設定 OPENCLAW_STATE_DIR 可使用不同目錄。日期目錄來自工作階段開始時間，而工作階段目錄則是從工作階段 id 衍生出的安全檔案系統區段。

命令

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：列印機器可讀輸出。

當人類可讀的工作階段 id 在不同日期重複時，請使用 list 中的含日期選擇器，例如 openclaw transcripts show 2026-05-22/standup。預設工作階段 id 包含時間戳記和隨機後綴；只有在固定工作階段 id 於當日內唯一時，才設定固定工作階段 id。

輸出

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 會列印包含以下欄位的物件：

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

show --json 會傳回已儲存的工作階段中繼資料、選擇器、工作階段目錄、摘要路徑和摘要 Markdown 文字。path --json 會傳回所選路徑，以及該檔案是否存在。

每天多場會議

逐字稿會先依日期分組工作階段，再依工作階段 id 分組。同一天的十場會議會成為十個同層資料夾：

~/.openclaw/transcripts/2026-05-22/  transcript-2026-05-22T09-00-00-000Z-a1b2c3d4/  transcript-2026-05-22T10-30-00-000Z-b2c3d4e5/  standup/

大多數自動化請使用預設產生的 id。只有在同一個 id 不會於同一天重複使用時，才使用像 standup 這樣的固定 id。

缺少摘要

即時工作階段會在工作階段停止時寫入 summary.md。匯入的逐字稿會在匯入後立即寫入 summary.md。當擷取仍在進行中、提供者在停止期間失敗，或中繼資料在任何發言到達前就已寫入時，工作階段仍可能出現在 list 中但沒有摘要。

使用 path <session> --transcript 檢查僅附加的逐字稿，並使用 transcripts 工具動作 summarize 重新產生 Markdown 摘要。

設定

逐字稿擷取為選擇啟用，因為即時來源可以加入並錄製會議音訊。使用頂層 transcripts.enabled 啟用此工具：

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

在 openclaw.json 中使用 transcripts.autoStart 設定自動啟動來源。每個項目只要存在即為啟用；省略某個項目即可停用該來源。

{  "transcripts": {    "enabled": true,    "autoStart": [      {        "providerId": "discord-voice",        "guildId": "1234567890",        "channelId": "2345678901"      },      {        "providerId": "slack-huddle",        "accountId": "workspace",        "channelId": "C123"      }    ]  }}