openclaw transcripts¶

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

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

openclaw transcripts show '2026-05-22/notes: room/one'

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

`list` 按最新会议优先返回，包含选择器、开始时间、标题或提供方名称、utterance 数量和参与者。`limit` 默认为 20，接受 1 到 50 的整数。文本有长度限制；结构化结果位于 `details.sessions`。

```json validate=false
{ "action": "show", "selector": "2026-05-22/notes-room-one" }

show、stop 和 summarize 必须且只能提供 `selector` 或 `sessionId` 之一。其他操作会拒绝 `selector`；start 和 import 继续通过 `sessionId` 接受原始 ID。显式 `selector` 输入接受规范选择器以及上述历史日期/原始 ID 形式，但绝不会将整个输入作为原始 ID 回退处理。

旧版 `sessionId` 输入会同时考虑限定形式与 raw/slug 形式的含义。如果它们指向不同的录制，工具会报告歧义，而不列出候选详情。录制结束后，这种歧义仍然存在。请使用 start、import 或受授权的 list/status 返回的选择器，或在本地查看 `openclaw transcripts
list`，然后在 `selector` 字段中传入所需的值。raw-ID/selector 冲突中的两侧仍可通过各自的规范选择器寻址。

如果没有冲突的限定形式含义，也没有不同的 raw-ID/slug 候选，旧版 `sessionId` 会为 stop 和 summarize 选择当前精确匹配原始 ID 的录制，即使历史录制复用了该 ID。如果没有当前录制，重复的历史 ID 需要带日期的选择器。针对较旧录制的显式选择器不会停止其同 ID 的较新兄弟录制。

`show` 会选择并授权持久化录制，仅使用实时状态来报告该录制是否处于活动状态。即使有一个录制处于活动状态，重复的历史 ID 也需要带日期的选择器。

## Gateway 与 Control UI 读取 {#gateway-and-control-ui-reads}

无需终端即可在 [Control UI](../web/control-ui/settings.md#meetings-page) 中打开 **Meetings**，浏览已捕获的会议和笔记。该页面和其他 Gateway 客户端使用以下 RPC 方法：

| 方法                  | 参数                                                                                                                                             | 结果                                                                                                                                                                      |
| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `transcripts.list`    | 可选 `limit`（1–200，默认 50）、`cursor`、`query`、精确的 `providerId`/`accountId`/`agentId`，以及 `startedAfter`/`startedBefore` 日期时间范围     | 最新优先的 `sessions`，包括参与者、utterance 数量、活动状态、摘要可用性、受限概览和 `nextCursor`。                                                                          |
| `transcripts.get`     | 必需的 `selector`；可选的 `includeUtterances`、`limit`（1–100）、`cursor` 和 utterance `query`                                                   | 一个 `session`、已存储的 `summary`、可选的 `utterances` 和 `nextCursor`。显式分页返回完整文本；旧版请求保留下文所述的最近窗口。                                           |
| `transcripts.summarize` | 必需的 `selector`                                                                                                                               | 生成缺失的笔记，并返回与 `transcripts.get` 相同的 `session` 和 `summary` 结构。现有笔记会被保留；并发请求共享同一个摘要所有者。                                           |
| `transcripts.export`  | 必需的 `selector` 和 `format`（`markdown` 或 `jsonl`）                                                                                         | 一个 base64 编码的文件，包含 `filename`、`mimeType` 和 `sizeBytes`。                                                                                                      |


| 方法 | 参数 | 结果 |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `transcripts.status`    | 无 | 捕获启用状态、提供商可用性和设置元数据、已配置源的健康状态、活动订阅以及最新保存的转录。 |

读取方法需要 `operator.read` 或其写入/管理员隐含权限；
`transcripts.summarize` 需要 `operator.write`。所有方法都在一个受信任的 Gateway 域内公开会议。受限的操作员配置文件需要读取共享归档的权限；选择代理过滤器不会授予访问权限。当读取者需要隔离时，请使用独立的 Gateway 域。源定位器仅包含 `providerId`、`accountId`、`guildId`、`channelId`、`threadTs`、`fileId`、`kind`，以及存在时经过清理的 `meetingUrl`，绝不包含任意捕获元数据。参见 [Gateway 协议](../gateway/protocol.md)。

列表搜索匹配标题、会话/源 ID、已保存的摘要 Markdown 和概览，以及存储的语句文本，排除源会议 URL 和私有元数据。
日期边界使用会话开始时间：`startedAfter` 包含边界，`startedBefore` 不包含边界。日期按时间点比较，使用 JavaScript 日期字符串语义，包括存储的 UTC 偏移。原始时间戳和选择器保持不变。无法解析的存储日期排在最后，并排除在日期范围之外。相同时间点按会话 ID 排序，然后按原始时间戳排序。
按时间顺序的页面选择会扫描候选捕获，并在搜索时扫描其已保存的笔记和语句，然后仅投影所选页面的笔记和参与者。搜索时间随被搜索的已保存文本增长。
游标属于其当前查询和过滤器；更改其中任何一项都需要重新获取第一页。空值 `nextCursor` 结束分页。

存储的摘要 Markdown 是规范笔记文本，与 CLI 的 `show` 输出一致。读取不会生成摘要或物化文件。除非 `includeUtterances` 为 true，否则省略语句。提供 `limit`、`cursor` 或 `query` 会选择分页读取：每页最多 100 条语句，默认 50 条，且不截断存储文本。`query` 搜索完整存储的转录，包括未加载的页面。分页读取、列表和状态结果限制为 1 MiB，并在传输到 JavaScript 之前强制存储负载边界。超出行或无效游标会显式失败。
摘要参与者和模型/启发式来源在可用时显示；旧摘要无需包含它们。

为了与归档分页之前发布的客户端兼容，`transcripts.get` 在没有 `limit`、`cursor` 或 `query` 时，保留按时间顺序最近的 2,000 条语句，每个清理后的文本截断为 4,000 个 UTF-16 单元。
这些旧式请求返回 `nextCursor: null`，并保留 25 MiB 的公共结果上限，与现有 Gateway 客户端传输限制一致。它们保留文本截断和公共投影之前的原始行读取行为。
发送显式 `limit` 以采用有界页面读取并获取完整文本；使用 `nextCursor` 继续，直到其为 null。所有归档访问检查都适用于两种请求形式。

导出限制为 4 MiB，失败时不会返回部分文件。Markdown 保留存储的笔记，并在单独的标题下追加完整转录。JSONL 包含公共语句投影：序列、语句 ID、完整文本、说话者身份、源时间戳，以及可用时的最终性。它排除私有提供商元数据和文件系统路径；本地 CLI 导出保留其原始语句格式。
在 Gateway 主机上使用 `openclaw transcripts path <session> --transcript` 进行更大的导出。

状态报告已注册的订阅，而非已确认的录制。`armed`、`not-active` 和 `unknown` 保持区分；仅凭一个清理后的 URL 无法证明哪个原始邀请启动了捕获。提供商、已配置源和活动列表限制为 100 个条目，并省略计数。已保存语句计数来自持久化行。最新转录是最近更新的包含语句的会话；源语音时间不是摄取时间戳。

## JSON 输出 {#json-output}

`list --json` 返回包含 `sessionId`、`selector`、`date`、`title`、`startedAt`、`stoppedAt`、`source`、`path`、`summaryPath`、`hasSummary` 的对象。
存储的会议源 URL 仅包含源和路径；查询字符串、片段和嵌入凭据在持久化之前被移除。

`show --json` 返回存储的会话元数据、选择器、会话目录、摘要路径和摘要 Markdown 文本。

`path --json` 返回所选路径以及该工件是否可以物化。对于存储的会话，元数据和转录导出始终存在；在会话拥有摘要之前，摘要路径报告 `exists: false`。

## 每天多个会话 {#many-sessions-per-day}

会话按日期分组，然后按会话 ID 分组。一天中的十次会议变成十个同级文件夹：

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

openclaw agent --agent <owning-agent-or-main> --local --message \
  "Use transcripts summarize for session <session>."

openclaw doctor --fix

{
  "transcripts": {
    "enabled": false
  }
}

{
  "transcripts": {
    "enabled": true,
    "autoStart": [
      {
        "providerId": "discord-voice",
        "accountId": "work",
        "guildId": "1234567890",
        "channelId": "2345678901",
        "whenOccupied": true
      }
    ]
  }
}