openclaw transcripts

用於檢查由 transcripts 代理工具寫入之逐字稿的唯讀檢視器。 擷取、匯入與摘要皆透過該工具執行，而非此命令列介面。

成品位於狀態目錄下：

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

預設狀態目錄為 ~/.openclaw；可使用 OPENCLAW_STATE_DIR 覆寫。 日期目錄取自工作階段開始時間；工作階段目錄則是由工作階段 ID 衍生而來、可安全用於檔案系統的 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> 可接受單獨的工作階段 ID，或包含日期的選擇器（YYYY-MM-DD/<session>）。當同一工作階段 ID 出現在多個日期時，請使用包含日期的格式，例如 openclaw transcripts show 2026-05-22/standup。預設工作階段 ID 包含時間戳記與隨機後綴；僅當固定 ID 在當日唯一時，才為工作階段指定固定 ID。

輸出

list 會為每個工作階段輸出一行以 Tab 分隔的內容：選擇器、開始時間、標題、摘要路徑。

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 會傳回所選路徑，以及該檔案是否存在。

每日多個工作階段

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

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

自動化作業請使用預設產生的 ID。僅當同一日期內不會重複時，才使用 standup 之類的固定 ID。

缺少摘要

即時工作階段會在工作階段停止時寫入 summary.md；匯入的逐字稿則會在匯入後立即寫入。若擷取仍在進行、供應商在停止過程中失敗，或在收到任何發言前便已寫入中繼資料，工作階段可能會出現在 list 中，但沒有摘要。

使用 path <session> --transcript 檢查僅供附加的原始逐字稿，或執行 transcripts 工具的 summarize 動作，以重新產生 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"      }    ]  }}