Meitu Beauty

Meitu Beauty

Overview

一键 AI 美颜：磨皮、美白、精修五官。调用 meitu image-beauty-enhance，仅支持单人人像照片。

Dependencies

• meitu-cli ≥ 0.1.9 — npm install -g meitu-cli
• 凭证配置: meitu config set-ak --value "..." + meitu config set-sk --value "..." 或环境变量 OPENAPI_ACCESS_KEY / OPENAPI_SECRET_KEY
• oc-workspace.mjs: {OPENCLAW_HOME}/workspace/scripts/oc-workspace.mjs（可选，不存在时降级）

路径别名： 下文中 $VISUAL = {OPENCLAW_HOME}/workspace/visual/，$OC_SCRIPT = {OPENCLAW_HOME}/workspace/scripts/oc-workspace.mjs

Core Workflow

Preflight → [Context: 跳过（工具型美颜，无创意自由度）] → Execute → Deliver

Preflight

1. meitu --version → 未安装则提示 npm install -g meitu-cli
2. meitu auth verify --json → 凭证无效则引导配置
3. node $OC_SCRIPT resolve → 获取 mode, visual, can_read_knowledge, can_record 脚本不存在 → 检查 cwd 有无 openclaw.yaml → 确定 mode；检查 $VISUAL 目录 → 确定 capabilities
4. output_dir 解析（Preflight 内 MUST 完成）： node $OC_SCRIPT route-output --skill meitu-beauty --name tmp --ext tmp 脚本不存在 → 3 级 fallback： ① cwd 有 openclaw.yaml → ./output/ ② $VISUAL 存在 → $VISUAL/output/meitu-beauty/ ③ 均无 → ~/Downloads/ mkdir -p {output_dir}

Execute

输入获取

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

• 本地文件路径 → 使用 --image <path>
• 图片 URL → 使用 --image <url>
• 对话中直接发送的图片 → 保存到临时文件后使用 --image <path>

若用户未提供图片，主动询问："请提供需要美颜的人像照片（文件路径或 URL）。"

人像校验（关键前置步骤）

此工具仅支持单人人像。调用前 MUST 校验：

1. 读取用户提供的图片，目视检查：

   • 是否包含人脸 → 无人脸则拒绝："这张图片中没有检测到人像，美颜工具仅支持包含人脸的照片。"
   • 是否为单人 → 多人则拒绝："检测到多人，美颜工具仅支持单人照片。请裁剪为单人后重试。"
   • 人脸是否足够大且清晰 → 人脸过小/模糊则警告："人脸较小/模糊，美颜效果可能不明显，是否继续？"

2. 若无法预判（如 URL 无法预览），直接调用工具，根据返回错误处理。

强度选择

调用命令

meitu image-beauty-enhance \
  --image <url_or_path> \
  --beatify_type <0|1> \
  --json \
  --download-dir {output_dir}

注意: 参数拼写是 --beatify_type（非 --beautify_type），这是 CLI 的已知拼写。

结果处理

• ok: true → --download-dir 已指定，从 downloaded_files[0].saved_path 获取本地文件路径；若未使用 --download-dir，从 media_urls[0] 获取结果图片 URL
• ok: false → 进入错误降级

错误降级

先检查 error_name 分流，再按级别降级：

通用降级（仅 retryable: true 或未知错误时）：

Deliver

直接使用 Preflight 解析的 output_dir。

node $OC_SCRIPT rename --file {path} --name {effect}

脚本不存在 → mv 重命名为 {output_dir}/{date}_beauty_{original_name}.{ext}。

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

Output