---
read_when:
    - Bạn muốn đọc các bản tóm tắt bản ghi đã lưu từ thiết bị đầu cuối
    - Bạn cần đường dẫn đến bản tóm tắt Markdown của bản ghi
    - Bạn đang gỡ lỗi bố cục lưu trữ bản ghi hội thoại lõi
summary: Tham chiếu CLI cho `openclaw transcripts` (liệt kê, hiển thị và định vị bản ghi đã lưu)
title: CLI bản ghi cuộc trao đổi
x-i18n:
    generated_at: "2026-06-27T17:21:02Z"
    model: gpt-5.5
    postprocess_version: locale-links-v1
    provider: openai
    source_hash: ae6010cfb4e051182f1c48d0d728b30d054542e1e7983ff15a2432840193f9c0
    source_path: cli/transcripts.md
    workflow: 16
---

# `openclaw transcripts`

Kiểm tra bản ghi được công cụ `transcripts` lõi của OpenClaw ghi lại. CLI này ở chế độ chỉ đọc; việc ghi, nhập và tóm tắt do công cụ agent và các nguồn tự khởi động đã cấu hình đảm nhiệm.

Dùng CLI khi bạn muốn tìm ghi chú hôm qua, mở tệp Markdown trong trình soạn thảo, đưa một bản ghi vào công cụ khác, hoặc gỡ lỗi xem một phiên được lưu ở đâu trên đĩa. Công cụ này không bắt đầu hoặc dừng việc ghi.

Artifact nằm trong thư mục trạng thái OpenClaw:

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

Thư mục trạng thái mặc định là `~/.openclaw`; đặt `OPENCLAW_STATE_DIR` để dùng một thư mục khác. Thư mục ngày lấy từ thời điểm bắt đầu phiên, và thư mục phiên là một phân đoạn hệ thống tệp an toàn được suy ra từ id phiên.

## Lệnh

```bash
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`: liệt kê các phiên đã lưu, bộ chọn kèm ngày, thời điểm bắt đầu, tiêu đề và đường dẫn `summary.md`.
- `show <session>`: in `summary.md` đã lưu.
- `path <session>`: in đường dẫn `summary.md`.
- `path <session> --dir`: in thư mục phiên.
- `path <session> --metadata`: in `metadata.json`.
- `path <session> --transcript`: in `transcript.jsonl`.
- `--json`: in đầu ra máy đọc được.

Khi id phiên do con người đặt bị lặp qua nhiều ngày, dùng bộ chọn kèm ngày từ `list`, ví dụ `openclaw transcripts show 2026-05-22/standup`. Id phiên mặc định bao gồm dấu thời gian và hậu tố ngẫu nhiên; chỉ cấu hình id phiên cố định khi chúng là duy nhất trong ngày.

## Đầu ra

`list` in một phiên trên mỗi dòng:

```text
2026-05-22/standup  2026-05-22T09:00:00.000Z  Weekly standup  /Users/alex/.openclaw/transcripts/2026-05-22/standup/summary.md
```

Đầu ra được phân tách bằng tab. Các cột là bộ chọn, thời điểm bắt đầu, tiêu đề và đường dẫn tóm tắt. Bộ chọn là giá trị an toàn nhất để truyền lại cho `show` hoặc `path`.

`list --json` in các đối tượng có:

- `sessionId`
- `selector`
- `date`
- `title`
- `startedAt`
- `stoppedAt`
- `source`
- `path`
- `summaryPath`
- `hasSummary`

`show --json` trả về siêu dữ liệu phiên đã lưu, bộ chọn, thư mục phiên, đường dẫn tóm tắt và văn bản Markdown tóm tắt. `path --json` trả về đường dẫn đã chọn và cho biết tệp đó có tồn tại hay không.

## Nhiều cuộc họp mỗi ngày

Transcripts nhóm các phiên theo ngày, rồi theo id phiên. Mười cuộc họp trong một ngày trở thành mười thư mục cùng cấp:

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

Dùng id được tạo mặc định cho hầu hết tự động hóa. Dùng id cố định như `standup` chỉ khi cùng id đó sẽ không được dùng hai lần trong cùng một ngày.

## Thiếu bản tóm tắt

Các phiên trực tiếp ghi `summary.md` khi phiên dừng. Các bản ghi được nhập sẽ ghi `summary.md` ngay sau khi nhập. Một phiên vẫn có thể xuất hiện trong `list` mà không có bản tóm tắt khi việc ghi đang hoạt động, provider gặp lỗi trong lúc dừng, hoặc siêu dữ liệu được ghi trước khi có bất kỳ lời thoại nào đến.

Dùng `path <session> --transcript` để kiểm tra bản ghi chỉ ghi thêm, và dùng hành động `summarize` của công cụ `transcripts` để tạo lại bản tóm tắt Markdown.

## Cấu hình

Việc ghi bản ghi là tùy chọn bật vì các nguồn trực tiếp có thể tham gia và ghi âm cuộc họp. Bật công cụ bằng `transcripts.enabled` cấp cao nhất:

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

Cấu hình các nguồn tự khởi động bằng `transcripts.autoStart` trong `openclaw.json`. Mỗi mục được bật khi có mặt; bỏ qua một mục để tắt nguồn đó.

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