> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 對話記錄命令列介面

# `openclaw transcripts`

用於持久化會議逐字稿的檢查與匯出命令。Google Meet、
Microsoft Teams 和 Zoom 瀏覽器參與者會自動擷取筆記；
`transcripts` 代理程式工具也支援提供者擷取與手動匯入。

標準逐字稿狀態位於共享 SQLite 資料庫的
`$OPENCLAW_STATE_DIR/state/openclaw.sqlite`。`show` 和 `path` 會明確地將
面向使用者的成品具體化至狀態目錄下：

```text theme={"theme":{"light":"min-light","dark":"min-dark"}}
$OPENCLAW_STATE_DIR/transcripts/YYYY-MM-DD/<session>/
  metadata.json
  transcript.jsonl
  summary.json
  summary.md
```

這些檔案是匯出成品，而非第二個執行階段儲存區。OpenClaw 不會在
擷取、摘要或列出期間讀回這些檔案。預設狀態目錄為
`~/.openclaw`；可使用 `OPENCLAW_STATE_DIR` 覆寫。日期目錄取自
工作階段開始時間；工作階段目錄則是由工作階段 ID 衍生的檔案系統安全 slug。

## 命令

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw transcripts list
openclaw 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> --dir
openclaw transcripts path <session> --metadata
openclaw transcripts path <session> --transcript
openclaw transcripts list --json
openclaw transcripts show <session> --json
openclaw 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>` 接受單獨的工作階段 ID 或包含日期的選擇器
（`YYYY-MM-DD/<session>`）。當同一工作階段 ID 出現在多個日期時，
請使用包含日期的形式，例如 `openclaw transcripts show
2026-05-22/standup`。預設工作階段 ID 包含時間戳記和隨機
尾碼；只有在該 ID 於當日唯一時，才應為工作階段指定固定 ID。

## 輸出

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

```text theme={"theme":{"light":"min-light","dark":"min-dark"}}
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` 的物件。
儲存的會議來源 URL 僅包含來源和路徑；查詢字串、
片段和內嵌認證資訊會在持久化前移除。

`show --json` 會傳回已儲存的工作階段中繼資料、選擇器、工作階段
目錄、摘要路徑和 Markdown 摘要文字。

`path --json` 會傳回所選路徑，以及該成品是否能夠
具體化。已儲存的工作階段一律會有中繼資料與逐字稿匯出；
在工作階段具有摘要之前，摘要路徑會回報 `exists: false`。

## 每日多個工作階段

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

```text theme={"theme":{"light":"min-light","dark":"min-dark"}}
~/.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
摘要。

## 升級舊版檔案儲存區

早於 SQLite 儲存區的 OpenClaw 版本會將標準執行階段狀態
直接寫入 `$OPENCLAW_STATE_DIR/transcripts/` 下方。執行：

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw doctor --fix
```

Doctor 會將完整的舊版目錄樹匯入 SQLite、驗證資料列數量與
順序、記錄移轉收據，並將已驗證的來源目錄樹移至帶有時間戳記的
`transcripts.migrated-*` 封存。執行階段命令不會退回使用
舊版檔案。在確認匯入的工作階段以及你所依賴的任何匯出成品之前，
請保留該封存。

## 設定

會議逐字稿擷取預設為啟用。若要全域停用：

```json theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  "transcripts": {
    "enabled": false
  }
}
```

* `enabled`（預設 `true`）：啟用自動會議筆記、逐字稿
  工具，以及已設定的自動啟動來源。當會議筆記不應持久化於主機上時，
  將其設為 `false`。明確要求的會議
  `transcribe` 模式會保留既有、有界限的即時字幕尾端，但此設定為 false 時
  不會寫入持久化資料列。
  使用 `transcripts.autoStart` 設定自動啟動來源。每個項目只要存在
  即為啟用；省略項目即可停用該來源。`discord-voice`
  是隨附且支援自動啟動的來源，並需要 `guildId` 和
  `channelId`：

```json theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  "transcripts": {
    "enabled": true,
    "autoStart": [
      {
        "providerId": "discord-voice",
        "guildId": "1234567890",
        "channelId": "2345678901"
      }
    ]
  }
}
```

會議提供者 ID 為 `google-meet`、`teams` 和 `zoom`。其別名
分別為 `googlemeet`/`meet`、`teams-meetings`/`microsoft-teams`/`msteams`，以及
`zoom-meetings`。會議提供者會附加至已啟用的
會議機器人工作階段；一般加入會議不需要 `autoStart` 項目。