| name | meitu-cutout |
| description | 使用 meitu-cli 为人物、宠物、商品、图标或印章抠图，分离前景主体并生成透明背景 PNG。当用户针对上述五类主体提到抠图、去背景、透明背景、背景移除、cutout、remove background、提取主体时触发；白底隔离和其他主体类型不支持。 |
| version | 1.1.0 |
| metadata | {"openclaw":{"requires":{"bins":"[Truncated]","env":"[Truncated]","paths":"[Truncated]"},"primaryEnv":"MEITU_OPENAPI_ACCESS_KEY","security":{"outputConstraints":"output_dir must resolve only to ./output/ in project mode or $VISUAL/output/meitu-cutout/ in one-off mode; final mv targets must remain inside these declared directories."}}} |
| security | {"output_constraints":"output_dir must resolve only to ./output/ in project mode or $VISUAL/output/meitu-cutout/ in one-off mode; final mv targets must remain inside these declared directories.","overwrite_policy":"Do not move or overwrite files outside the declared output directories."} |
| requirements | {"credentials":[{"name":"MEITU_OPENAPI_ACCESS_KEY","source":"env | ~/.meitu/credentials.json"},{"name":"MEITU_OPENAPI_SECRET_KEY","source":"env | ~/.meitu/credentials.json"}],"permissions":[{"type":"file_read","paths":"[Truncated]"},{"type":"file_write","paths":"[Truncated]"},{"type":"exec","commands":"[Truncated]"}]} |
Meitu Cutout
Overview
调用 meitu image-cutout 从图片中分离前景主体，输出透明背景 PNG。仅支持人物、宠物、商品、图标、印章五类主体；可选人像、商品、图形三种模型，也可省略模型参数自动检测。
Dependencies
- meitu-cli:
npm install -g meitu-cli@latest
- 凭证: 首选 env vars
MEITU_OPENAPI_ACCESS_KEY / MEITU_OPENAPI_SECRET_KEY，或预置 ~/.meitu/credentials.json；仅在用户明确要求写入本地凭证时，再执行 meitu config set-ak --value "..." / meitu config set-sk --value "..."
路径别名： 下文中 $VISUAL = {OPENCLAW_HOME}/workspace/visual/
Core Workflow
Preflight → [Context: 跳过（工具型抠图，无创意自由度）] → Execute → Deliver
Preflight
meitu --version → 未安装则提示 npm install -g meitu-cli@latestmeitu auth verify --json → 凭证无效则引导配置- Detect mode: cwd has
openclaw.yaml → project mode; else → one-off
检查 $VISUAL 目录 → 确定 capabilities
- output_dir 解析（Preflight 内 MUST 完成）：
Resolve output_dir: openclaw.yaml →
./output/ | else → $VISUAL/output/meitu-cutout/
mkdir -p {output_dir}
Execute
输入解析
用户提供图片，支持两种形式：
- 本地文件路径（如
./photo.jpg）
- 图片 URL（如
https://example.com/photo.jpg）
如果用户只说"帮我抠图"但没给图片 → 问："请提供需要抠图的图片（本地路径或 URL）"。
模型选择
| 图片主体 | model_type | 输出 |
|---|
| 人像、证件照、半身照 | 0 | 透明底 PNG，保留发丝细节 |
| 商品、产品、电商图 | 1 | 透明底 PNG，优化产品边缘 |
| 设计素材、图标、印章 | 2 | 透明底 PNG |
| 宠物或类型不确定 | 省略 | 服务端自动选择模型，输出透明底 PNG |
model_type 仅允许 0、1、2。建筑、植物、车辆、食物、家具等非五类主体以及白底隔离不受支持，不得通过 prompt 或替代 API 绕过限制；需要生成白底时改用 。
