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"]}]}

Meitu Beauty

Overview

一键 AI 人像精修：磨皮、美白、面部细节优化。基于 meitu image-edit --model gummy_pro 做写实人像修饰，仅支持单人人像照片。

执行前应让用户清楚知道：本 Skill 会读取 Meitu 凭证、调用本地 meitu CLI、将用户提供的人像图片与生成提示发送到 Meitu OpenAPI 处理，并把结果写入 ./output/ 或 $VISUAL/output/meitu-beauty/。人像照片属于敏感的个人外观数据，需确认用户对所处理照片具备使用和处理授权。

Dependencies

meitu-cli ≥ 2.0.6 — npm install -g meitu-cli@latest
凭证配置: 首选环境变量 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@latest
meitu 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-beauty/ mkdir -p {output_dir}

Execute

输入获取

用户提供图片，接受以下形式：

本地文件路径 → 使用 --image_list <path>
图片 URL → 使用 --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] 获取结果图片 URL
ok: 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，停止重试

Deliver

直接使用 Preflight 解析的 output_dir。

mv {file} {output_dir}/{date}_beauty_{original_name}.{ext}

命名示例：2026-03-23_beauty_portrait.jpg

Output

项目	规格
格式	与原图一致（通常 JPG）
数量	单张
命名	`{date}_beauty_{original_name}.{ext}`
位置	由 Deliver 步骤解析

Más de este repositorio

mismo repositorio

meitu-id-photo

meitu/meitu-skills

用于基于用户原图制作规格化证件照、证件照换底色或单人写真套图。当用户要证件照、一寸照、二寸照、护照/签证照、白底/蓝底/红底证件版、写真照、三宫格写真、主题/场景写真时触发。不适用于多人合影、卡通化转绘、普通人像轻修。执行时会读取 Meitu 凭证、调用本地 `meitu` CLI，把人像照片、生成提示词与任务参数发送到 Meitu OpenAPI，并把结果写入本地输出目录。

2026-07-1422

meitu-tools

meitu/meitu-skills

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.

2026-06-1522

audio-music-generate

meitu/meitu-skills

生成无人声、无歌词的纯音乐 / BGM，适合背景音乐、氛围铺垫、情绪渲染，时长 30–120 秒。仅在用户明确要求生成纯音乐/背景音乐时触发。执行时会读取 Meitu 凭证、调用本地 `meitu` CLI，并把音频生成请求发送到 Meitu OpenAPI，结果写入本地输出目录。

2026-06-1522

audio-song-generate

meitu/meitu-skills

歌词驱动的完整歌曲生成（含人声），也支持强节奏成品级纯音乐。仅当用户明确要求生成歌曲/音频成品，并提供或同意补充风格与歌词参数时触发；普通音乐讨论、歌词创作、闲聊式演唱请求不触发。

2026-06-1522

image-background-replace

meitu/meitu-skills

替换图片整体背景/换场景，保留前景主体不变。当用户说换背景、替换背景、换成 xx 背景、商品换场景、人像换背景、证件照换底色、换底时触发。本工具不能输出透明背景。执行时会使用本地 meitu CLI、Meitu OpenAPI 凭证并写入本地输出目录。

2026-06-1522

image-cutout

meitu/meitu-skills

图片前景主体与背景精准分离，输出透明底 PNG（标准四类：人物、宠物、商品、图形印章）或白底图（非标准主体或用户明确要白底）。仅在用户明确要求抠图、去背景、透明背景/透明底、提取主体，或明确要求把已有图片抠成白底时触发。执行时会使用本地 meitu CLI、Meitu OpenAPI 凭证并写入本地输出目录。

2026-06-1522

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"]}]}

Meitu Beauty

Overview

一键 AI 人像精修：磨皮、美白、面部细节优化。基于 meitu image-edit --model gummy_pro 做写实人像修饰，仅支持单人人像照片。

Dependencies

meitu-cli ≥ 2.0.6 — npm install -g meitu-cli@latest
凭证配置: 首选环境变量 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@latest
meitu 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-beauty/ mkdir -p {output_dir}

Execute

输入获取

用户提供图片，接受以下形式：

本地文件路径 → 使用 --image_list <path>
图片 URL → 使用 --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] 获取结果图片 URL
ok: 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，停止重试

Deliver

直接使用 Preflight 解析的 output_dir。

mv {file} {output_dir}/{date}_beauty_{original_name}.{ext}

命名示例：2026-03-23_beauty_portrait.jpg

Output

项目	规格
格式	与原图一致（通常 JPG）
数量	单张
命名	`{date}_beauty_{original_name}.{ext}`
位置	由 Deliver 步骤解析