---
read_when:
    - می‌خواهید خلاصه‌های ذخیره‌شدهٔ رونوشت‌ها را از ترمینال بخوانید
    - به مسیرِ خلاصهٔ Markdown رونوشت‌ها نیاز دارید
    - شما در حال اشکال‌زدایی چیدمان ذخیره‌سازی رونوشت‌های هسته هستید
summary: مرجع CLI برای `openclaw transcripts` (فهرست کردن، نمایش دادن، و یافتن رونوشت‌های ذخیره‌شده)
title: CLI رونوشت‌ها
x-i18n:
    generated_at: "2026-06-27T17:29:22Z"
    model: gpt-5.5
    postprocess_version: locale-links-v1
    provider: openai
    source_hash: ae6010cfb4e051182f1c48d0d728b30d054542e1e7983ff15a2432840193f9c0
    source_path: cli/transcripts.md
    workflow: 16
---

# `openclaw transcripts`

رونوشت‌هایی را که ابزار اصلی `transcripts` در OpenClaw نوشته است بررسی کنید. این CLI فقط خواندنی است؛ ضبط، وارد کردن و خلاصه‌سازی در اختیار ابزار عامل و منابع شروع خودکار پیکربندی‌شده هستند.

وقتی می‌خواهید یادداشت‌های دیروز را پیدا کنید، فایل Markdown را در یک ویرایشگر باز کنید، یک رونوشت را به ابزار دیگری بدهید، یا عیب‌یابی کنید که یک نشست در کجای دیسک ذخیره شده است، از CLI استفاده کنید. این ابزار ضبط را شروع یا متوقف نمی‌کند.

مصنوعات زیر دایرکتوری وضعیت OpenClaw قرار دارند:

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

دایرکتوری وضعیت پیش‌فرض `~/.openclaw` است؛ برای استفاده از دایرکتوری دیگر، `OPENCLAW_STATE_DIR` را تنظیم کنید. دایرکتوری تاریخ از زمان شروع نشست می‌آید، و دایرکتوری نشست یک بخش امن برای سامانه فایل است که از شناسه نشست مشتق شده است.

## فرمان‌ها

```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`: نشست‌های ذخیره‌شده، انتخابگر واجد تاریخ، زمان شروع، عنوان، و مسیر `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`. شناسه‌های نشست پیش‌فرض شامل یک مهر زمانی و پسوند تصادفی هستند؛ شناسه‌های نشست ثابت را فقط زمانی پیکربندی کنید که در همان روز یکتا باشند.

## خروجی

`list` در هر خط یک نشست چاپ می‌کند:

```text
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` مسیر انتخاب‌شده و اینکه آن فایل وجود دارد یا نه را برمی‌گرداند.

## نشست‌های زیاد در هر روز

Transcripts نشست‌ها را ابتدا بر اساس تاریخ و سپس بر اساس شناسه نشست گروه‌بندی می‌کند. ده جلسه در یک روز به ده پوشه هم‌سطح تبدیل می‌شوند:

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

برای بیشتر خودکارسازی‌ها از شناسه‌های تولیدشده پیش‌فرض استفاده کنید. از یک شناسه ثابت مانند `standup` فقط زمانی استفاده کنید که همان شناسه در همان تاریخ دو بار استفاده نخواهد شد.

## خلاصه‌های گمشده

نشست‌های زنده وقتی نشست متوقف می‌شود `summary.md` را می‌نویسند. رونوشت‌های واردشده بلافاصله پس از وارد کردن، `summary.md` را می‌نویسند. یک نشست همچنان می‌تواند بدون خلاصه در `list` ظاهر شود، وقتی ضبط فعال است، یک ارائه‌دهنده هنگام توقف شکست خورده است، یا فراداده پیش از رسیدن هر گفته‌ای نوشته شده است.

برای بررسی رونوشت فقط‌افزودنی از `path <session> --transcript` استفاده کنید، و برای بازتولید خلاصه Markdown از کنش `summarize` در ابزار `transcripts` استفاده کنید.

## پیکربندی

ضبط رونوشت اختیاری است، چون منابع زنده می‌توانند به صدای جلسه ملحق شوند و آن را ضبط کنند. ابزار را با `transcripts.enabled` در سطح بالا فعال کنید:

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

منابع شروع خودکار را با `transcripts.autoStart` در `openclaw.json` پیکربندی کنید. هر ورودی با حضور داشتن فعال می‌شود؛ برای غیرفعال کردن آن منبع، ورودی را حذف کنید.

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