| name | image-background-replace |
| description | 替换图片整体背景/换场景，保留前景主体不变。当用户说换背景、替换背景、换成 xx 背景、商品换场景、人像换背景、证件照换底色、换底时触发。本工具不能输出透明背景。执行时会使用本地 meitu CLI、Meitu OpenAPI 凭证并写入本地输出目录。 |
| version | 1.0.0 |
| metadata | {"openclaw":{"requires":{"bins":"[Truncated]","env":"[Truncated]","paths":"[Truncated]"},"primaryEnv":"MEITU_OPENAPI_ACCESS_KEY","security":{"dataFlow":"Inputs, selected local context, and generated prompts may be sent to Meitu OpenAPI when used by the workflow.","credentials":"Credentials are used only for CLI authentication and must not be disclosed."}}} |
| security | {"credential_use":"Uses Meitu OpenAPI credentials from env or ~/.meitu/credentials.json for CLI calls; credentials must not be echoed, logged, or embedded in prompts.","remote_processing":"Input images and background prompts are sent to Meitu OpenAPI.","persistence":"Generated images are written to the resolved output directory."} |
| 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":"[Truncated]"},{"type":"file_write","paths":"[Truncated]"},{"type":"exec","commands":"[Truncated]"}]} |
图片换背景（image-background-replace）
Overview
对已有图片做整体背景替换/换场景，保留前景主体不变。覆盖商品换场景、人像换背景、宠物换场景、电商白底图、证件照换底色（白/蓝/红）、文字描述任意目标场景的 AI 生成。本工具不能输出透明背景。
API Mapping
- 背景替换：
image_gummy_generate_v45
Dependencies
- meitu-cli:
>=2.0.6（npm install -g meitu-cli@latest）
- 凭证：CONFIG AKSK →
meitu tools update；EXEC AKSK → 实际执行（见根 CONFIG.md）
- 环境变量：
MEITU_OPENAPI_TOOL_TASK_MODE=command
路径别名：$VISUAL = {OPENCLAW_HOME}/workspace/visual/
Core Workflow
Preflight → Execute → Deliver
Preflight
meitu --version ≥ 2.0.6（否则 npm install -g meitu-cli@latest）- 确认已跑过
meitu tools update（用 CONFIG AKSK）
- 当前 AKSK = EXEC，且
MEITU_OPENAPI_TOOL_TASK_MODE=command
- 解析 output_dir：openclaw.yaml →
./output/ ｜else → $VISUAL/output/image-background-replace/；mkdir -p
Execute
触发信号 / 路由规则
| 场景 | 判定关键词 | 路由 |
|---|
| 整体背景替换 | 换背景、换场景、换底色、证件照换底 | image_gummy_generate_v45 |
决策顺序：
0. 前置拦截：prompt 含"透明"/"透明底"/"透明背景" → 不调用本工具，提示走抠图
- 参数齐全判断：
image_url 缺失 → 追问；prompt 缺失 → 用默认"白色背景"
- 唯一路由：调用
image_gummy_generate_v45
单 API 工具：参数齐全即调用，失败重试 1 次后返回错误；不做跨工具兜底。
参数定义
| 参数 | 类型 | 必填 | 范围 | 默认值 | 说明 |
|---|
image_url | STRING | 是 | -- | -- | 图片地址。缺失 → 提示"请提供需要换背景的图片" |
|
