/install beauty-image
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
- 执行 generate_image_v3.py (优先) 或 generate_image_v2.py (V2兼容)
- 解析输出中
MEDIA_URL:开头的行 - 用 markdown 语法展示图片:
 - 如有多张图, 逐一展示所有
MEDIA_URL:行 - 不下载图片,除非用户要求保存
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张)
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install beauty-image - After installation, invoke the skill by name or use
/beauty-image - Provide required inputs per the skill's parameter spec and get structured output
What is Beauty Image?
商业化AI图片生成助手。40+场景模板, 30+风格词典, 智能意图识别, 结构化Prompt, 三引擎智能路由 (Wanx/Seedream4/Seedream5)。 It is an AI Agent Skill for Claude Code / OpenClaw, with 133 downloads so far.
How do I install Beauty Image?
Run "/install beauty-image" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Beauty Image free?
Yes, Beauty Image is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Beauty Image support?
Beauty Image is cross-platform and runs anywhere OpenClaw / Claude Code is available (darwin, linux, win32).
Who created Beauty Image?
It is built and maintained by 圆规 (@yh22e); the current version is v3.2.0.