| name | video-element-remove |
| description | 使用 meitu-cli 从视频中消除路人/字幕/水印/Logo 或一键清屏全部文字。当用户提到去路人、去行人、去字幕、去对白、去水印、去 Logo、去角标、消除抖音号、清屏、纯净画面、不要出现任何字时触发。 |
| version | 1.0.0 |
| metadata | {"openclaw":{"requires":{"bins":"[Truncated]","env":"[Truncated]","paths":"[Truncated]"},"primaryEnv":"MEITU_OPENAPI_ACCESS_KEY"}} |
| requirements | {"credentials":[{"name":"MEITU_OPENAPI_ACCESS_KEY","source":"env | ~/.meitu/credentials.json"},{"name":"MEITU_OPENAPI_SECRET_KEY","source":"env | ~/.meitu/credentials.json"}],"env":{"MEITU_OPENAPI_TOOL_TASK_MODE":"command"},"permissions":[{"type":"file_read","paths":"[Truncated]"},{"type":"file_write","paths":"[Truncated]"},{"type":"exec","commands":"[Truncated]"}]} |
Video Element Remove
Overview
对已有视频做元素消除，覆盖 4 类场景（仅此 4 类，不处理鞋子/垃圾/随机物体等任意对象）：
- 去路人 / 行人：消除背景路人、行人，基于内容检测自动处理。
- 去字幕（随时间变化）：消除随时间变化的字幕条带（对白、中文字幕、底部文字）。
- 去水印 / Logo / 角标（固定位置）：消除固定位置的水印、Logo、平台角标、抖音号。
- 一键清屏：一次性清除画面中所有文字（字幕 + 水印 + UI 文字）。
不处理：添加 Logo/水印、视频内容替换、图片去水印、视频画质增强。
API Mapping
| 场景 | API name |
|---|
| 去路人 / 行人 | video_content_remove |
| 去字幕（随时间变化的对白条带） | video_subtitle_remove |
| 去水印 / Logo / 角标（固定位置） | video_watermark_remove |
| 一键清屏（去全部文字） | video_allwords_remove |
Dependencies
- meitu-cli:
>=2.0.6
- 凭证：CONFIG AKSK →
meitu tools update；EXEC AKSK → 跑命令
- 环境变量：
MEITU_OPENAPI_TOOL_TASK_MODE=command
路径别名： $VISUAL = {OPENCLAW_HOME}/workspace/visual/
Core Workflow
Preflight → Execute → Deliver
Preflight
meitu --version 与 meitu auth verify --json- 检测
MEITU_OPENAPI_TOOL_TASK_MODE=command
- output_dir：项目 →
./output/；一次性 → $VISUAL/output/video-element-remove/；mkdir -p
Execute
触发信号与路由
核心判断维度：消除目标类型。Agent 调用前先识别视频画面内容，生成 prompt 描述（如"视频右上角有平台水印，底部有中文字幕"）。
prompt → 路由映射：
prompt 信号词 | 路由 API |
|---|
| 路人 / 行人 / 背景里的人 | video_content_remove |
| 字幕 / 台词 / 对白 / 底部文字 | video_subtitle_remove |
| 水印 / Logo / 角标 / 平台标 / 固定位置标识 | video_watermark_remove |
| 所有文字 / 全部字 / 清屏 / 全部清除 | video_allwords_remove |
| 字幕 + 水印 同时去 | video_subtitle_remove + video_watermark_remove 并行调用 |
场景互斥边界
- "去所有字"（全部文字）→
video_allwords_remove；"去字幕"（仅字幕）→ video_subtitle_remove
- 固定位 Logo →
video_watermark_remove；随时间字幕 → video_subtitle_remove
subtitle_remove + watermark_remove 可并行；allwords_remove 与其他互斥（清屏已包含）
参数定义
| 参数 | 类型 | 必填 | 范围 | 默认 | 说明 |
|---|
video_url | STRING | 是 | — | — | 视频地址 |
prompt | STRING | 是 | — | — | Agent 对视频画面的描述，工具据此判断消除类型 |
说明：
- 识别不到任何信号词时默认走
video_subtitle_remove（最常见消除诉求）
- 清屏需二次确认（会去除所有文字）
工具调用
meitu video-element-remove --video_url {url} --prompt "{画面描述}" --json --download-dir {output_dir} --skill_name skill_video-element-remove
错误降级
| 场景 | 处理 |
|---|
video_url 缺失 | 提示"请提供视频链接"，不调用 |
video_url 不可访问 | 直接返回错误，不重试 |
prompt 为空或无信号词 | Agent 识别视频画面生成描述后重新判断 |
| 意图模糊（"去字"） | 按画面识别：仅字幕→subtitle；字幕+水印+UI→allwords；仅固定 Logo→watermark |
| 用户要"去字幕+去全部文字" | 互斥，默认走 video_allwords_remove |
| API 调用失败 / 超时 | 重试 1 次，仍失败返回错误 |
| 内容合规拦截 | 直接返回合规提示，不重试 |
Deliver
mv {file} {output_dir}/{date}_{name}_element-remove.mp4
Output
- 格式：MP4
- 命名：
{YYYY-MM-DD}_{descriptive-name}_element-remove.mp4
- 位置：项目 →
./output/；一次性 → $VISUAL/output/video-element-remove/
基线 Task ID
t_mt1a3i5n7b339aa95a-03dd-4f3e-9d31-786dc86b33aa
