一键导入
meitu-beauty
对单人人像照片进行 AI 美颜处理(磨皮、美白、精修五官)。仅在用户明确要求单人人像美颜、磨皮、美白或人像精修,并已提供人像照片时触发;泛化的“让照片更好看”“修一下”不单独触发。
用 Codex 或 Claude 帮你安装 复制这段 Prompt,粘贴到 Codex、Claude 或其他助手里,让它检查 Skill 页面并帮你完成安装。
菜单
对单人人像照片进行 AI 美颜处理(磨皮、美白、精修五官)。仅在用户明确要求单人人像美颜、磨皮、美白或人像精修,并已提供人像照片时触发;泛化的“让照片更好看”“修一下”不单独触发。
用 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 凭证并写入本地输出目录。
图片前景主体与背景精准分离,输出透明底 PNG(标准四类:人物、宠物、商品、图形印章)或白底图(非标准主体或用户明确要白底)。仅在用户明确要求抠图、去背景、透明背景/透明底、提取主体,或明确要求把已有图片抠成白底时触发。执行时会使用本地 meitu CLI、Meitu OpenAPI 凭证并写入本地输出目录。
| name | meitu-beauty |
| description | 对单人人像照片进行 AI 美颜处理(磨皮、美白、精修五官)。仅在用户明确要求单人人像美颜、磨皮、美白或人像精修,并已提供人像照片时触发;泛化的“让照片更好看”“修一下”不单独触发。 |
| version | 1.1.0 |
| metadata | {"openclaw":{"requires":{"bins":["meitu"],"env":["MEITU_OPENAPI_ACCESS_KEY","MEITU_OPENAPI_SECRET_KEY"],"paths":{"read":["~/.meitu/credentials.json","~/.openclaw/workspace/visual/","./openclaw.yaml"],"write":["~/.openclaw/workspace/visual/","./output/"]}},"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"}],"permissions":[{"type":"file_read","paths":["~/.meitu/credentials.json","./","~/.openclaw/workspace/visual/","./openclaw.yaml"]},{"type":"file_write","paths":["~/.openclaw/workspace/visual/","./output/","$VISUAL/output/meitu-beauty/","~/.openclaw/workspace/visual/output/meitu-beauty/"]},{"type":"exec","commands":["meitu"]}]} |
一键 AI 人像精修:磨皮、美白、面部细节优化。基于 meitu image-edit --model gummy_pro 做写实人像修饰,仅支持单人人像照片。
执行前应让用户清楚知道:本 Skill 会读取 Meitu 凭证、调用本地 meitu CLI、将用户提供的人像图片与生成提示发送到 Meitu OpenAPI 处理,并把结果写入 ./output/ 或 $VISUAL/output/meitu-beauty/。人像照片属于敏感的个人外观数据,需确认用户对所处理照片具备使用和处理授权。
npm install -g meitu-cli@latestMEITU_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/
Preflight → [Context: 跳过(工具型美颜,无创意自由度)] → Execute → Deliver
meitu --version → 未安装则提示 npm install -g meitu-cli@latestmeitu auth verify --json → 凭证无效则引导配置openclaw.yaml → project mode; else → one-off
检查 $VISUAL 目录 → 确定 capabilities./output/ | else → $VISUAL/output/meitu-beauty/
mkdir -p {output_dir}输入获取
用户提供图片,接受以下形式:
--image_list <path>--image_list <url>--image_list <path>若用户未提供图片,主动询问:"请提供需要美颜的人像照片(文件路径或 URL)。"
人像校验(关键前置步骤)
此工具仅支持单人人像。调用前 MUST 校验:
读取用户提供的图片,目视检查:
若无法预判(如 URL 无法预览),直接调用工具,根据返回错误处理。
强度选择
| 用户意图 | prompt 追加语句 | 说明 |
|---|---|---|
| "自然美颜"、"轻微调整"、"稍微美化"、未指定强度 | natural portrait retouch, keep facial structure unchanged | 自然效果(默认) |
| "大力美颜"、"重度磨皮"、"效果强一点"、"狠狠美颜" | strong but realistic skin smoothing, brighter complexion, keep facial structure unchanged | 增强效果 |
调用命令
meitu image-edit \
--skill_name skill_meitu-beauty \
--image_list <url_or_path> \
--prompt "<beauty_instruction>" \
--model gummy_pro \
--json \
--download-dir {output_dir}
注意:
2.0.6已无image-beauty-enhance。人像美颜、肤质优化、细节修饰统一通过image-edit --model gummy_pro完成。
结果处理
ok: true → --download-dir 已指定,从 downloaded_files[0].saved_path 获取本地文件路径;若未使用 --download-dir,从 media_urls[0] 获取结果图片 URLok: false → 进入错误降级错误降级
先检查 CLI 原始错误字段 code、hint、error_name、action_url,再按 meitu-tools 规则归类为 error_type 后分流:
| error_type(由 CLI 原始字段归类) | 处理 | 可重试 |
|---|---|---|
CONTENT_REQUIREMENTS_UNMET(或 CLI 原始错误 code=98501 / error_name=CONTENT_REQUIREMENTS_UNMET) | 图片不含人脸或不符合单人要求。直接告知用户:"该图片不符合美颜要求(需要单人人像照片),请更换图片。" 不重试。 | 否 |
ORDER_REQUIRED | 余额不足,提示充值,展示 action_url | 否 |
CREDENTIALS_MISSING | 提示配置 AK/SK | 否 |
| 其他错误 | 按以下级别降级 ↓ | 视情况 |
通用降级(仅 retryable: true 或未知错误时):
| 级别 | 策略 | 操作 |
|---|---|---|
| L1 | 降低强度 | 将强修饰 prompt 收敛为 natural portrait retouch, keep facial structure unchanged 后重试 |
| L2 | 检查图片质量 | 提示用户更换更清晰、人脸更大的照片 |
| L3 | 检查图片格式 | 确认为 JPG/PNG/WEBP,非 GIF/BMP 等不支持格式 |
| L4 | 停止报错 | 连续 2 次失败 → 报告 code + hint,停止重试 |
直接使用 Preflight 解析的 output_dir。
mv {file} {output_dir}/{date}_beauty_{original_name}.{ext}
命名示例:2026-03-23_beauty_portrait.jpg
| 项目 | 规格 |
|---|---|
| 格式 | 与原图一致(通常 JPG) |
| 数量 | 单张 |
| 命名 | {date}_beauty_{original_name}.{ext} |
| 位置 | 由 Deliver 步骤解析 |