Beauty Image

商业化AI图片生成助手。40+场景模板, 30+风格词典, 智能意图识别, 结构化Prompt, 三引擎智能路由 (Wanx/Seedream4/Seedream5)。

Security Scan

The skill appears to implement the claimed image-generation features, but the declared required environment variables are inconsistent with the code and metadata (ARK and DEEPSEEK are optional in practice), so the manifest overclaims privileges — review before installing.

Purpose & Capability

Name/description match the code: scripts build prompts, parse intent, and call three image/LLM providers (DashScope/Wanx, VolcEngine/Seedream, DeepSeek). Requesting the 'uv' binary is coherent. However, the registry metadata (requires.env) lists DASHSCOPE_API_KEY, ARK_API_KEY, and DEEPSEEK_API_KEY as required, while README/SKILL.md and the scripts treat only at least one provider key as necessary (ARK and DEEPSEEK are optional). This is an inconsistency between declared requirements and actual need.

Instruction Scope

SKILL.md instructs the agent to ask user confirmation, run the provided scripts, parse MEDIA_URL lines, and not download images unless requested. Runtime instructions reference ~/.openclaw/openclaw.json and expected API endpoints (dashscope.aliyuncs.com, ark.cn-beijing.volces.com, api.deepseek.com) which are consistent with purpose. There are no instructions to read unrelated files or exfiltrate arbitrary data.

Install Mechanism

No external download/install spec is present (instruction + included Python scripts). Dependencies are normal (uv runner and requests). No suspicious remote installers, URL shorteners, or extracted archives are used.

Credentials

The skill metadata marks three API keys as required, but the code clearly treats ARK_API_KEY (Seedream) and DEEPSEEK_API_KEY (LLM intent parsing) as optional — only one provider key is needed for functionality. Declaring all three as required is disproportionate and misleading. The primaryEnv = DASHSCOPE_API_KEY is reasonable, but users should not supply unrelated keys unless needed. The scripts also read ~/.openclaw/openclaw.json for keys, which is proportional to the stated purpose but is additional config access to note.

Persistence & Privilege

always:false and disable-model-invocation:false (normal). The skill does not request permanent system-wide privileges and does not modify other skills' configs. It only reads its own config and optionally ~/.openclaw/openclaw.json.

What to consider before installing

This skill appears to do what it says (build prompts, detect intent, and call three image/LLM providers). Before installing: (1) Note the metadata incorrectly lists ARK_API_KEY and DEEPSEEK_API_KEY as required — you only need to provide at least one provider key (DASHSCOPE_API_KEY or ARK_API_KEY) and DEEPSEEK is optional for deeper LLM parsing. Do not put unrelated secrets into environment variables or openclaw.json. (2) Expect the skill to make network calls to DashScope (Aliyun), VolcEngine (Seedream), and DeepSeek; those services will receive your prompts and may incur usage costs — only enable the keys you trust. (3) Run scripts/check.py after installation to verify configured keys and behavior. (4) If you want to limit exposure, only set the single API key for the provider you plan to use (e.g., DASHSCOPE_API_KEY) and do not provide ARK/DEEPSEEK unless you need them. (5) If you need higher assurance, review the network calls in the generate_*.py files and test in an isolated environment.

Beauty Image V3 — 商业化AI图片生成

AI 图片生成助手。触发后必须先询问用户确认，再执行生成。

V3升级: 意图识别(40+场景) + 结构化Prompt + 风格词典(30+) + 智能引擎路由

触发场景	询问确认内容
名片设计	姓名、职称、公司、风格(赛博朋克/极简/金属)
海报创作	主题、配色、排版风格、文字元素
头像/IP	人物描述、风格、表情、背景
产品摄影	产品描述、背景、布光偏好
3D/材质	主体、材质(水晶/毛绒/充气/乐高)、场景
通用图片	画面描述、尺寸比例、风格、引擎选择

执行流程: 触发 → 意图识别 → 模板匹配 → 询问缺失信息 → Prompt构建 → 引擎路由 → 生成 → 展示

Usage (V3 脚本, 推荐)

智能模式 (自动识别意图+模板+路由)

uv run {baseDir}/scripts/generate_image_v3.py --prompt "帮我做一张赛博朋克风格的个人名片"
uv run {baseDir}/scripts/generate_image_v3.py --prompt "画一只猫的水晶质感手办"
uv run {baseDir}/scripts/generate_image_v3.py --prompt "上海天气卡片"
uv run {baseDir}/scripts/generate_image_v3.py --prompt "做个毛绒版的苹果logo"

指定场景模板

uv run {baseDir}/scripts/generate_image_v3.py --prompt "猫" --scene 3d_crystal
uv run {baseDir}/scripts/generate_image_v3.py --prompt "武士" --scene art_ukiyoe_card --style 浮世绘
uv run {baseDir}/scripts/generate_image_v3.py --prompt "咖啡店" --scene 3d_miniature

指定字段 (JSON)

uv run {baseDir}/scripts/generate_image_v3.py --prompt "名片" --scene biz_card --fields '{"name":"圆规","title":"CEO","company":"XyvaClaw"}'

Raw模式 (兼容V2, 直接传prompt)

uv run {baseDir}/scripts/generate_image_v3.py --prompt "一幅美丽的风景画" --raw

指定尺寸/比例

uv run {baseDir}/scripts/generate_image_v3.py --prompt "城市全景" --size 全景
uv run {baseDir}/scripts/generate_image_v3.py --prompt "手机壁纸" --size 9:16
uv run {baseDir}/scripts/generate_image_v3.py --prompt "小红书配图" --size 小红书
uv run {baseDir}/scripts/generate_image_v3.py --prompt "电影海报" --size 海报

列出模板/风格/引擎/尺寸

uv run {baseDir}/scripts/generate_image_v3.py --list-scenes
uv run {baseDir}/scripts/generate_image_v3.py --list-styles
uv run {baseDir}/scripts/generate_image_v3.py --list-providers
uv run {baseDir}/scripts/generate_image_v3.py --list-sizes

尺寸和比例 (15种 + 中文别名)

支持 15 种宽高比，可用比例名、中文别名或直接像素值指定。

比例	wanx 尺寸	中文别名
1:1	1280×1280	正方, 头像
3:4	1104×1472	小红书, A4
4:3	1472×1104	—
9:16	960×1696	竖版, 手机壁纸
16:9	1696×960	横版, PPT, 名片
2:3	1048×1568	海报
3:2	1568×1048	—
1:2	904×1816	—
2:1	1808×912	—
9:21	840×1960	竖屏, 长图
21:9	1952×840	宽屏, 电影
1:3	744×2224	长海报
3:1	2216×744	横幅, banner
1:4	640×2560	超长, 滚动长图
4:1	2560×640	全景, 超宽

Seedream 引擎支持 2K/3K 高分辨率输出。

场景模板 (26+)

分类	模板ID	名称	推荐引擎
商务	biz_card	名片设计	seedream5
商务	biz_poster	商业海报	seedream5
商务	biz_product	产品摄影	seedream4
社交	social_avatar	头像/IP	seedream4
社交	social_emoji	表情包	wanx
社交	social_card	金句卡片	wanx
创意	art_general	艺术创作	seedream5
创意	art_ukiyoe_card	浮世绘闪卡	seedream5
3D	3d_crystal	水晶质感	seedream5
3D	3d_plush	毛绒玩具	seedream4
3D	3d_inflatable	充气玩具	seedream4
3D	3d_miniature	微缩房间	seedream5
实用	util_weather	天气卡片	seedream5
实用	util_fridge_magnet	冰箱贴	seedream5
实用	util_food_map	美食地图	seedream5
实用	util_storyboard	电影分镜	seedream5
设计	design_ppt	PPT页面	seedream5
设计	design_logo	Logo	wanx
设计	design_packaging	包装设计	seedream5
人物	person_portrait	写实肖像	seedream5
人物	person_action_figure	手办	seedream5
场景	scene_chalkboard	黑板粉笔画	seedream4
电商	ecom_main	电商主图	wanx
电商	ecom_banner	电商横幅	wanx
内容	content_xhs	小红书配图	seedream4
内容	content_blog	文章头图	wanx

风格词典 (20+)

赛博朋克, 浮世绘, 水墨画, 吉卜力, 像素风, 油画, 漫画, 波普艺术, 清明上河图, 水晶, 毛绒, 充气, 乐高, 黏土, 电影感, 产品摄影, 街拍, 胶片, 等距微缩, 3D渲染

引擎选择指南

引擎	适用场景	画质	速度	费用
seedream5	最高画质，组图	⭐⭐⭐⭐⭐	中	中
seedream4	高画质，性价比	⭐⭐⭐⭐	较快	低
wanx	文字渲染好	⭐⭐⭐	快	低

V3自动按场景+风格路由引擎, 无需手动选择。

API Key 配置 (首次使用必读)

本技能需要至少配置 一个 API Key 才能使用。推荐配置通义万相 (免费额度较多)。

方式一: 环境变量 (推荐)

# 通义万相 (wanx引擎, 必选其一)
export DASHSCOPE_API_KEY=sk-xxxxxxxxxxxxxxxx

# 火山引擎 (seedream4/seedream5引擎, 可选, 画质更高)
export ARK_API_KEY=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

# DeepSeek (可选, 仅用于 --use-llm 深度意图解析)
export DEEPSEEK_API_KEY=sk-xxxxxxxxxxxxxxxx

方式二: openclaw.json 配置

在 ~/.openclaw/openclaw.json 中添加:

{
  "models": {
    "providers": {
      "wanxiang": { "apiKey": "sk-your-dashscope-key" },
      "ark": { "apiKey": "your-ark-api-key" },
      "deepseek": { "apiKey": "sk-your-deepseek-key" }
    }
  }
}

API Key 获取地址

引擎	Key名称	获取地址	说明
通义万相	DASHSCOPE_API_KEY	https://dashscope.console.aliyun.com/apiKey	阿里云百炼平台, 注册后有免费额度
Seedream	ARK_API_KEY	https://console.volcengine.com/ark/region:ark+cn-beijing/apiKey	火山引擎, 需开通方舟平台
DeepSeek	DEEPSEEK_API_KEY	https://platform.deepseek.com/api_keys	可选, 用于LLM意图解析

健康检查

uv run {baseDir}/scripts/check.py

Workflow

1. 执行 generate_image_v3.py (优先) 或 generate_image_v2.py (V2兼容)
2. 解析输出中 MEDIA_URL: 开头的行
3. 用 markdown 语法展示图片: ![Generated Image](URL)
4. 如有多张图, 逐一展示所有 MEDIA_URL: 行
5. 不下载图片，除非用户要求保存

Legacy

V2脚本 generate_image_v2.py 仍可使用 (无模板/无意图识别):

uv run {baseDir}/scripts/generate_image_v2.py --prompt "描述" --provider auto

V1脚本 generate_image.py 仅支持万相:

uv run {baseDir}/scripts/generate_image.py --prompt "描述" --model wan2.6-t2i

Notes

• V3自动识别场景并匹配模板, 构建结构化prompt
• 支持 --use-llm 启用DeepSeek意图解析 (低置信度时)
• 图片 URL 有效期 24 小时，请及时下载保存
• Seedream 5.0 lite 支持组图 (≤15张)