VideoDB 屏幕录制技能

由 VideoDB 提供支持的屏幕录制功能。当用户请求屏幕录制、希望搜索过往活动或需要语音转录时使用。

在 {baseDir} 目录下运行命令：npx tsx videodb.ts。

前置条件

1. 检查 API 密钥

在使用任何命令前，请确认已配置 API 密钥：

openclaw config get skills.entries.videodb-monitoring.env.VIDEODB_API_KEY

如果返回值 未设置 或为空：

• 请向用户索取其 VideoDB API 密钥
• 若用户提供密钥，请为其设置：

openclaw config set skills.entries.videodb-monitoring.env.VIDEODB_API_KEY 'sk-xxx'

• 若用户没有密钥，请引导其前往：https://console.videodb.io

2. 检查监控是否正在运行

openclaw config get skills.entries.videodb-monitoring.env.VIDEODB_IS_RUNNING

如果返回值 **不是 true**，请启动监控：

cd {baseDir} && nohup npx tsx monitor.ts > ~/.videodb/logs/monitor.log 2>&1 & disown && sleep 3

验证是否已成功启动：

openclaw config get skills.entries.videodb-monitoring.env.VIDEODB_CAPTURE_SESSION_ID

若返回一个会话 ID（如 cap-xxxxxxxx-...），则表示监控已就绪。

命令

获取当前时间戳

cd {baseDir} && npx tsx videodb.ts now

返回当前 Unix 时间戳（自纪元以来的秒数）。

生成播放链接

cd {baseDir} && npx tsx videodb.ts stream <start_timestamp> <end_timestamp>
cd {baseDir} && npx tsx videodb.ts stream <start_timestamp> <end_timestamp> --title "Checkout flow" --description "OpenClaw browser run"

为指定时间段生成可播放的录制链接。

若提供了 --title 或 --description，生成的播放页面将使用这些元数据。

开始索引

仅当用户要求搜索、摘要或转录时才启动索引：

cd {baseDir} && npx tsx videodb.ts start-indexing

此操作将启动：

• 系统音频的语音转录
• 音频索引
• 视觉内容索引

也可分别控制各项：

cd {baseDir} && npx tsx videodb.ts start-visual-index
cd {baseDir} && npx tsx videodb.ts start-transcript
cd {baseDir} && npx tsx videodb.ts start-audio-index

停止索引

一旦不再需要索引，请立即停止以节省成本：

cd {baseDir} && npx tsx videodb.ts stop-indexing

单独停止命令如下：

cd {baseDir} && npx tsx videodb.ts stop-visual-index
cd {baseDir} && npx tsx videodb.ts stop-transcript
cd {baseDir} && npx tsx videodb.ts stop-audio-index

搜索录制内容

cd {baseDir} && npx tsx videodb.ts search "user opened Amazon"

在已索引的屏幕活动中查找匹配事件。若尚未建立视觉索引，请先启动索引。

活动摘要

cd {baseDir} && npx tsx videodb.ts summary              # 最近 30 分钟
cd {baseDir} && npx tsx videodb.ts summary --hours 2    # 最近 2 小时

音频转录

cd {baseDir} && npx tsx videodb.ts transcript           # 最近 30 分钟
cd {baseDir} && npx tsx videodb.ts transcript --hours 1 # 最近 1 小时

录制工作流程

当用户请求对某项任务进行屏幕录制时：

1. 获取开始时间：

cd {baseDir} && npx tsx videodb.ts now

将结果存储为 start_time。

1. 执行操作（浏览器操作、文件编辑等）

1. 获取结束时间：

cd {baseDir} && npx tsx videodb.ts now

1. 生成播放链接：

cd {baseDir} && npx tsx videodb.ts stream <start_time> <end_time>

可选添加播放器元数据：

cd {baseDir} && npx tsx videodb.ts stream <start_time> <end_time> --title "Task recording" --description "Captured during OpenClaw task execution"

1. 在回复中包含链接：

Screen recording: https://rt.stream.videodb.io/...

若命令输出播放页面链接，请优先分享该链接给用户。

监控不会自动启动索引。若用户还需搜索、摘要或转录功能，请在执行相关命令前显式启动索引，并在完成后及时停止。

示例

用户：“打开 example.com 并把录制发给我”

# 检查前置条件
openclaw config get skills.entries.videodb-monitoring.env.VIDEODB_IS_RUNNING
# true

# 获取开始时间
cd {baseDir} && npx tsx videodb.ts now
# 1709740800

# 执行操作（打开浏览器并导航）
# ...

# 获取结束时间
cd {baseDir} && npx tsx videodb.ts now
# 1709740830

# 生成播放链接
cd {baseDir} && npx tsx videodb.ts stream 1709740800 1709740830 --title "example.com walkthrough" --description "OpenClaw browser automation"
# 📹 Screen recording (30s): https://rt.stream.videodb.io/abc123
# Player page: https://player.videodb.io/watch?v=example-slug

回复：

已完成！我打开了 example.com。

屏幕录制：https://rt.stream.videodb.io/abc123

使用场景

故障排查

若命令执行失败提示“No capture session”：

1. 检查监控是否运行：openclaw config get skills.entries.videodb-monitoring.env.VIDEODB_IS_RUNNING
2. 若未运行，请按前置条件部分启动
3. 若显示正在运行但仍失败，请重启监控

若摘要/搜索/转录提示“无索引”或“无转录”：

1. 使用 cd {baseDir} && npx tsx videodb.ts start-indexing 启动索引
2. 等待片刻以积累数据
3. 重试相关命令
4. 完成后使用 cd {baseDir} && npx tsx videodb.ts stop-indexing 停止索引