jimeng-video-openclaw-stable（jimeng video OpenClaw stable 视频）

Jimeng Video

用于 Jimeng 视频任务，目标是稳定完成：

• 打开视频页
• 提交生成
• 等待完成
• 下载本地文件

浏览器必须走 OpenClaw 托管链路：

openclaw browser --browser-profile <profile> <subcommand>

0) 强制执行约束（提高成功率）

A. 前置健康检查固定化（每次必做）

按顺序固定执行，不跳步：

1. status
2. 如 running:false 则 start
3. open 视频页
4. snapshot

只有上一步成功，才进入下一步。

B. 状态机执行（禁止自由发挥）

只允许按以下状态前进：

• PRECHECK
• MODE_GUARD
• SUBMIT
• POLL
• DOWNLOAD
• VERIFY
• DONE / FAILED

每个状态都有：

• 成功条件
• 最大重试次数
• 失败后的去向

C. 轮询策略固定

• 轮询间隔：20–30 秒
• 最大总等待：12 分钟
• 到上限仍未完成：标记 FAILED(timeout)，不要无限等

D. 防抖与去风暴

• 页面未跳转时，禁止重复 open
• 非 ref 失效场景，禁止连续 snapshot
• 同一状态下 snapshot 连续失败 2 次，先回 PRECHECK

1) 适用场景

当用户要：

• 生成 Jimeng 视频
• 找到最新一条已生成视频
• 下载视频到本地

不适用于：

• 纯文本问答（不需要浏览器）
• 图片生成（请用 jimeng-image）

2) 入口与 profile

视频入口：

https://jimeng.jianying.com/ai-tool/home/?workspace=0&type=video

profile 选择优先级：

1. 当前 agent 专用 profile
2. 用户指定 profile
3. 默认 profile
4. openclaw（兜底）

3) 状态机定义（含成功条件和重试上限）

PRECHECK

动作：

1. status
2. 如未启动则 start
3. open 视频页
4. snapshot

成功条件：

• snapshot 能拿到可交互页面结构

重试上限：

• 整体最多 2 轮

失败去向：

• 超过上限 -> FAILED(precheck)

MODE_GUARD

动作：

• 检查当前模式是否 首尾帧
• 若是且没有上传首尾帧图片：切换到 全能参考
• 切换后重新 snapshot 确认

成功条件：

• 当前模式可用于无参考图生成（通常为 全能参考）

重试上限：

• 2 次

失败去向：

• 回 PRECHECK 1 次
• 再失败 -> FAILED(mode_guard)

SUBMIT

动作：

• 填写提示词
• 按需设置模型/时长/比例
• 点击生成
• snapshot 确认任务已提交

模型/时长规则（必须校验）：

• 若用户指定 Seedance 2.0 Fast，可选时长 4s~15s
• 用户指定不支持组合时：停止并告知，不要擅自改参数

成功条件：

• 页面出现“提交成功/排队中/生成中/可追踪任务”任一信号

重试上限：

• 2 次

失败去向：

• 回 MODE_GUARD 1 次
• 再失败 -> FAILED(submit)

POLL

动作：

• 每 20–30 秒检查一次
• 每轮只做一次 snapshot + 一次状态判断
• 判断是否出现：下载 / 去查看 / 已完成卡片

成功条件：

• 找到可下载入口（直接下载按钮或可进入详情页）

重试上限：

• 最多 24 轮（约 12 分钟）

失败去向：

• 超时 -> FAILED(timeout)

DOWNLOAD

动作：

• 优先在当前页下载
• 若当前页无下载入口，走资产页兜底：

- 打开 https://jimeng.jianying.com/ai-tool/asset - 查找最新生成视频 - 进入详情下载

成功条件：

• 下载命令返回本地路径

重试上限：

• 2 次

失败去向：

• 回 POLL 1 次再找入口
• 再失败 -> FAILED(download)

VERIFY

动作：

• 校验文件存在
• 校验大小 > 0
• 扩展名为 mp4（或页面声明的视频格式）

成功条件：

• 文件可用且路径可回报

重试上限：

• 1 次重新下载

失败去向：

• FAILED(verify)

4) 标准执行模板（最小可靠版）

1. PRECHECK
2. MODE_GUARD
3. SUBMIT
4. POLL（20–30 秒间隔，最长 12 分钟）
5. DOWNLOAD
6. VERIFY
7. 输出路径并 DONE

5) 故障处理

Gateway / 浏览器链路异常

• 先回 PRECHECK
• 不要在中间状态无限重试

Ref 失效

• 只允许“重新 snapshot 一次”
• 仍失败则回退上一个状态

下载入口消失

• 直接走资产页兜底，不在当前页盲点

6) 反模式（禁止）

• 连续重复 open 同一页面
• 高频 snapshot（无状态变化还不断抓）
• 忘记 running:false 就直接点页面
• 轮询无上限，导致看起来“卡死”
• 下载后不校验文件是否真实落地

7) 成功标准

任务完成必须回报：

1. 本地绝对路径
2. 文件校验结果（存在/大小/格式）
3. 失败时给出明确失败状态（如 FAILED(timeout)）