openclaw transcripts
用于检查和导出持久化会议转录的命令。Google Meet、Microsoft Teams 和 Zoom 浏览器参与者会自动捕获笔记;transcripts 智能体工具还支持通过提供商捕获和手动导入。
规范转录状态存储在位于 $OPENCLAW_STATE_DIR/state/openclaw.sqlite 的共享 SQLite 数据库中。show 和 path 会显式地将面向用户的工件具体化到状态目录下:
~/.openclaw;可使用 OPENCLAW_STATE_DIR 覆盖。日期目录取自会话开始时间;会话目录是从会话 ID 派生的文件系统安全 slug。
命令
<session> 接受裸会话 ID 或包含日期的选择器(YYYY-MM-DD/<session>)。当同一会话 ID 出现在多个日期时,请使用限定形式,例如 openclaw transcripts show 2026-05-22/standup。默认会话 ID 包含时间戳和随机后缀;仅当固定 ID 在当天唯一时,才为会话指定该 ID。
输出
list 为每个会话打印一行以制表符分隔的内容:选择器、开始时间、标题、摘要路径。
show 或 path 时最安全的值。
list --json 返回包含 sessionId、selector、date、title、startedAt、stoppedAt、source、path、summaryPath、hasSummary 的对象。存储的会议源 URL 仅包含源和路径;查询字符串、片段和嵌入式凭据会在持久化之前移除。
show --json 返回已存储的会话元数据、选择器、会话目录、摘要路径和摘要 Markdown 文本。
path --json 返回所选路径,以及该工件能否具体化。已存储会话的元数据和转录导出始终存在;在会话生成摘要之前,摘要路径会报告 exists: false。
每天多个会话
会话先按日期分组,再按会话 ID 分组。一天内的十场会议会形成十个同级文件夹:standup)不会在同一日期重复时,才使用该 ID。
缺少摘要
实时会话会在会话停止时存储并具体化summary.md;导入的转录则会在导入后立即执行此操作。在捕获仍处于活动状态、提供商在停止期间失败,或元数据在任何话语到达之前已存储时,会话可能会出现在 list 中但没有摘要。
使用 path <session> --transcript 检查原始的仅追加转录,或运行 transcripts 工具的 summarize 操作以重新生成 Markdown 摘要。
升级旧版文件存储
早于 SQLite 存储的 OpenClaw 版本会将规范运行时状态直接写入$OPENCLAW_STATE_DIR/transcripts/ 下。运行:
transcripts.migrated-* 归档中。运行时命令不会回退到旧版文件。在确认导入的会话以及依赖的所有导出内容无误之前,请保留该归档。
配置
默认启用会议转录捕获。要在全局范围内选择退出:enabled(默认值为true):启用自动会议笔记、转录工具和已配置的自动启动源。当会议笔记不应持久化到主机时,将其设置为false。显式请求的会议transcribe模式会保留其现有的有界实时字幕尾部,但此设置为 false 时不会写入持久化行。 使用transcripts.autoStart配置自动启动源。每个条目只要存在即为启用;省略条目即可禁用相应源。discord-voice是内置的支持自动启动的源,需要guildId和channelId:
google-meet、teams 和 zoom。它们的别名分别为 googlemeet/meet、teams-meetings/microsoft-teams/msteams 和 zoom-meetings。会议提供商会附加到已处于活动状态的会议机器人会话;正常加入会议不需要 autoStart 条目。