菜单
图片前景主体与背景精准分离，输出透明底 PNG（标准四类：人物、宠物、商品、图形印章）或白底图（非标准主体或用户明确要白底）。仅在用户明确要求抠图、去背景、透明背景/透明底、提取主体，或明确要求把已有图片抠成白底时触发。执行时会使用本地 meitu CLI、Meitu OpenAPI 凭证并写入本地输出目录。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
用于基于用户原图制作规格化证件照、证件照换底色或单人写真套图。当用户要证件照、一寸照、二寸照、护照/签证照、白底/蓝底/红底证件版、写真照、三宫格写真、主题/场景写真时触发。不适用于多人合影、卡通化转绘、普通人像轻修。执行时会读取 Meitu 凭证、调用本地 `meitu` CLI，把人像照片、生成提示词与任务参数发送到 Meitu OpenAPI，并把结果写入本地输出目录。
Unified Meitu CLI capability skill. Covers credentials, command mapping, execution pattern, and user-facing error guidance for built-in image/video commands plus auth/account/recharge CLI capabilities.
生成无人声、无歌词的纯音乐 / BGM，适合背景音乐、氛围铺垫、情绪渲染，时长 30–120 秒。仅在用户明确要求生成纯音乐/背景音乐时触发。执行时会读取 Meitu 凭证、调用本地 `meitu` CLI，并把音频生成请求发送到 Meitu OpenAPI，结果写入本地输出目录。
歌词驱动的完整歌曲生成（含人声），也支持强节奏成品级纯音乐。仅当用户明确要求生成歌曲/音频成品，并提供或同意补充风格与歌词参数时触发；普通音乐讨论、歌词创作、闲聊式演唱请求不触发。
替换图片整体背景/换场景，保留前景主体不变。当用户说换背景、替换背景、换成 xx 背景、商品换场景、人像换背景、证件照换底色、换底时触发。本工具不能输出透明背景。执行时会使用本地 meitu CLI、Meitu OpenAPI 凭证并写入本地输出目录。
去除图片颗粒感/噪点/杂色，保留细节同时降噪。当用户说去噪、降噪、去颗粒、去噪点、杂色、颗粒感、画面脏、ISO 高、噪声时触发。
| name | image-cutout |
| description | 图片前景主体与背景精准分离，输出透明底 PNG（标准四类：人物、宠物、商品、图形印章）或白底图（非标准主体或用户明确要白底）。仅在用户明确要求抠图、去背景、透明背景/透明底、提取主体，或明确要求把已有图片抠成白底时触发。执行时会使用本地 meitu CLI、Meitu OpenAPI 凭证并写入本地输出目录。 |
| version | 1.0.0 |
| metadata | {"openclaw":{"requires":{"bins":["meitu"],"env":["MEITU_OPENAPI_ACCESS_KEY","MEITU_OPENAPI_SECRET_KEY","MEITU_OPENAPI_TOOL_TASK_MODE"],"paths":{"read":["~/.meitu/credentials.json","~/.meitu/tool-registry.json","~/.openclaw/workspace/visual/","./openclaw.yaml"],"write":["~/.openclaw/workspace/visual/","./output/"]}},"primaryEnv":"MEITU_OPENAPI_ACCESS_KEY","security":{"dataFlow":"Inputs, selected local context, and generated prompts may be sent to Meitu OpenAPI when used by the workflow.","credentials":"Credentials are used only for CLI authentication and must not be disclosed."}}} |
| security | {"credential_use":"Uses Meitu OpenAPI credentials from env or ~/.meitu/credentials.json for CLI calls; credentials must not be echoed, logged, or embedded in prompts.","remote_processing":"Input images and subject prompts are sent to Meitu OpenAPI.","persistence":"Generated cutout images are written to the resolved output directory."} |
| 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":["~/.meitu/credentials.json","~/.meitu/tool-registry.json","./","~/.openclaw/workspace/visual/","./openclaw.yaml"]},{"type":"file_write","paths":["~/.openclaw/workspace/visual/","./output/","$VISUAL/output/image-cutout/","~/.openclaw/workspace/visual/output/image-cutout/"]},{"type":"exec","commands":["meitu"]}]} |
对已有图片做前景主体与背景的精准分离。标准四类主体（人物/宠物/商品/图形印章）走 api_v1_sod_async 输出透明底 PNG；非标准主体（建筑/植物/车辆/食物/家具等）或用户明确要求白底的场景走 image_praline_edit_v2 输出白底图（RGB 255,255,255）。任何涉及"透明背景/透明底"的需求都归本工具。
api_v1_sod_asyncimage_praline_edit_v2image_praline_edit_2image_mint_editmodel 映射：auto（默认按路由）/praline_pro→v2/praline_lite→2/mint_edit→mint
>=2.0.6（npm install -g meitu-cli@latest）meitu tools update；EXEC AKSK → 实际执行（见根 CONFIG.md）MEITU_OPENAPI_TOOL_TASK_MODE=command路径别名：
$VISUAL={OPENCLAW_HOME}/workspace/visual/
Preflight → Execute → Deliver
meitu --version ≥ 2.0.6（否则 npm install -g meitu-cli@latest）meitu tools update（用 CONFIG AKSK）MEITU_OPENAPI_TOOL_TASK_MODE=command./output/ ｜else → $VISUAL/output/image-cutout/；mkdir -p触发信号 / 路由规则
核心判断维度：Agent 画面识别的主体类型。
| 场景 | 判定关键词 | 路由 | 输出 |
|---|---|---|---|
| 标准四类主体 | 人物/宠物/商品/图形印章 | api_v1_sod_async | 透明底 PNG |
| 非标准主体 | 建筑/植物/车辆/食物/家具/其他 | image_praline_edit_v2 | 白底 RGB(255,255,255) |
| 用户明确要求白底 | 白底、纯白背景 | image_praline_edit_v2 | 白底 |
| 主体类型无法判断 | Agent 识别失败 | api_v1_sod_async 默认 | 透明底 |
决策顺序：
prompt 描述image_praline_edit_v2（白底优先级更高）参数定义
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
image_url | STRING | 是 | -- | 图片地址。缺失 → 提示"请提供需要抠图的图片" |
prompt | STRING | 是 | -- | Agent 对图片主体的描述（如"白底商品图，主体为运动鞋"） |
image_praline_edit_v2 内部 prompt（系统自动追加，不暴露给用户）：
结合图片分析，根据指令锁定图像主体（保持原貌不形变），将背景重置为纯白（RGB 255, 255, 255）
工具调用
meitu image-cutout \
--skill_name skill_image-cutout \
--image_url <image_url> \
--prompt "<subject_description>" \
--json \
--download-dir {output_dir}
错误降级
| 场景 | 处理方式 |
|---|---|
image_url 缺失 | 提示"请提供需要抠图的图片"，不调用 |
image_url 不可访问 | 返回图片链接无效错误，不重试 |
prompt 为空 | Agent 识别主体生成 prompt；无法判断默认走 api_v1_sod_async |
| 未检测到前景主体（标准路径） | 返回错误，提示需包含清晰前景主体 |
api_v1_sod_async 失败 | 重试 1 次，仍失败返回错误 |
image_praline_edit_v2 失败 | 重试 1 次 → 降级 image_praline_edit_2 |
image_praline_edit_2 失败 | 降级 image_mint_edit |
image_mint_edit 失败 | 返回错误 |
| 内容合规拦截 | 返回合规提示，不重试、不降级 |
| 用户说"替换为透明背景" | 虽含"替换"但目标是透明 → 走本工具，不走背景替换 |
| 视频输入 | 拒绝，仅支持图片 |
downloaded_files[0].saved_path 读取已下载文件路径mv {downloaded_files[0].saved_path} {output_dir}/{YYYY-MM-DD}_{descriptive}_image-cutout.png{YYYY-MM-DD}_{descriptive}_image-cutout.png./output/，一次性 → $VISUAL/output/image-cutout/见 references/task-id-baseline.md 中对应行。