openclaw transcripts

检查 OpenClaw 核心 transcripts 工具写入的转录记录。这个 CLI 是只读的；采集、导入和摘要由智能体工具以及已配置的自动启动来源负责。

当你想查找昨天的笔记、在编辑器中打开 Markdown 文件、把转录记录提供给另一个工具，或调试某个会话落盘位置时，可以使用这个 CLI。它不会启动或停止采集。

产物位于 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 在当天唯一时才配置它。

输出

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"      }    ]  }}