메뉴
双图换脸/换头合成，将源图人脸替换到目标场景图上，保留目标图构图、身体和背景并自动做肤色融合与光影匹配。仅在用户明确提供两张图，并表达换脸、换头、把 A 的脸换到 B 上、face swap 或明确的 P 脸合成意图时触发。执行时会使用本地 Meitu OpenAPI 凭证授权，并将源人脸图和目标场景图发送到 Meitu 外部服务处理。
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 | image-face-swap |
| description | 双图换脸/换头合成，将源图人脸替换到目标场景图上，保留目标图构图、身体和背景并自动做肤色融合与光影匹配。仅在用户明确提供两张图，并表达换脸、换头、把 A 的脸换到 B 上、face swap 或明确的 P 脸合成意图时触发。执行时会使用本地 Meitu OpenAPI 凭证授权，并将源人脸图和目标场景图发送到 Meitu 外部服务处理。 |
| 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":{"credentialUse":"Uses Meitu OpenAPI credentials from env or ~/.meitu/credentials.json for CLI authentication; credentials must not be echoed, logged, or embedded in prompts.","remoteProcessing":"Source face images and target scene images are transmitted to Meitu OpenAPI for face-swap processing.","biometricNotice":"Face images are sensitive biometric-like personal data; users should understand that provided images are processed by an external Meitu service."}}} |
| security | {"credential_use":"Uses Meitu OpenAPI credentials from env or ~/.meitu/credentials.json for CLI authentication; credentials must not be echoed, logged, or embedded in prompts.","remote_processing":"Source face images and target scene images are transmitted to Meitu OpenAPI for face-swap processing.","biometric_notice":"Face images are sensitive biometric-like personal data; users should understand that provided images are processed by an external Meitu service."} |
| 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/"]},{"type":"exec","commands":["meitu"]}]} |
双图换脸/换头合成，将源图人脸替换到目标场景图上。保留目标图的构图/身体/背景，自动肤色融合光影匹配；用于角色扮演、把自己的脸放到另一张图上、趣味合成。一次只换一张脸。
执行前应让用户清楚知道：本 Skill 会读取 Meitu 凭证、调用本地 meitu CLI、将两张人脸相关图片发送到 Meitu OpenAPI 处理，并把结果写入 ./output/ 或 $VISUAL/output/image-face-swap/。
image_face_swap>=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-face-swap/；mkdir -p触发信号 / 路由规则
核心判断维度：图片数量 + head/sence 角色分配。
| 场景 | 判定 | 路由 |
|---|---|---|
| 双图换脸 | 提供 2 张图，意图换脸 | image_face_swap，head/sence 按规则分配 |
决策顺序：
image_face_swap单 API 工具：参数齐全即调用，失败重试 1 次后返回错误；不做跨工具兜底。侧脸/遮挡严重不阻断调用，但告知效果可能受限。
参数定义
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
head_image_url | STRING | 是 | -- | 人脸源图 URL |
sence_image_url | STRING | 是 | -- | 场景底图 URL（保留构图/身体/背景） |
prompt | STRING | 是 | -- | 附加提示词。缺失 → 提示"请描述换脸效果要求" |
工具调用
meitu image-face-swap \
--skill_name skill_image-face-swap \
--head_image_url <head_url> \
--sence_image_url <sence_url> \
--prompt "<effect_description>" \
--json \
--download-dir {output_dir}
错误降级
| 场景 | 处理方式 |
|---|---|
| 图片不足 2 张 | 提示"请提供两张图片：一张人脸源图，一张目标场景图" |
| 图片 3+ 张 | 取前 2 张（第 1=head，第 2=sence），告知用户 |
head_image_url / sence_image_url 不可访问 | 返回图片链接无效错误，不重试 |
| 未检测到人脸（head） | 返回错误：人脸源图需包含清晰正脸 |
image_face_swap 调用失败 | 重试 1 次，仍失败返回错误 |
| 内容合规拦截 | 返回合规提示，不重试 |
| 侧脸 / 遮挡严重 | 不阻断调用，告知效果可能受限 |
| 视频换脸 | 拒绝，仅支持图片 |
| 多人同时换脸 | 本工具一次只换一张脸 |
downloaded_files[0].saved_path 读取已下载文件路径mv {downloaded_files[0].saved_path} {output_dir}/{YYYY-MM-DD}_{descriptive}_image-face-swap.jpg{YYYY-MM-DD}_{descriptive}_image-face-swap.jpg./output/，一次性 → $VISUAL/output/image-face-swap/见 references/task-id-baseline.md 中对应行。