Install
openclaw skills install @thcjp/comfyui-painter-tool-freeopenclaw skills install @thcjp/comfyui-painter-tool-free功能说明: 本技能涵盖 中文交互、化工作流场景 等核心能力。
ComfyUI绘画免费版是一款面向个人用户的轻量级本地AI图像生成工具,基于ComfyUI工作流引擎实现。提供文生图核心能力,内置默认工作流与基础模型支持,帮助用户通过文字描述快速生成图像。完全本地运行,无需云端API。
| 能力 | 说明 |
|---|---|
| 文生图 | 根据文字描述生成图像 |
| 默认工作流 | 内置标准文生图工作流 |
| 基础模型 | 支持SD1.5、SDXL等基础模型 |
| 参数调整 | 采样步数、CFG、种子、尺寸 |
| 图像保存 | 自动保存到本地目录 |
| 提示词优化 | 基础提示词建议 |
技术实现要点:核心能力基于input_params参数与output_format配置实现,支持创建/查询/修改/删除等操作模式,通过config_options进行运行时配置。 |
用input_params参数进行配置。
输出: 返回核心功能执行的执行结果,包含操作状态和输出数据。
input_params参数,支持创建/查询/导出操作用config_options参数进行配置。
输出: 返回参数配置与调用的执行结果,包含操作状态和输出数据。
config_options参数,支持修改/重置/导入操作用output_format参数进行配置。
输出: 返回结果处理与输出的执行结果,包含操作状态和输出数据。
output_format参数,支持导出/保存/转换操作
能力覆盖范围:本skill的核心能力覆盖以下场景关键词:ComfyUI、图像生成工具、支持文生图基础工、作流与默认模型、适合个人创作、绘画免费版、面向个人用户的轻、量级本地、Text、Image、基础工作流、内置默认文生图工、开箱即用、默认模型支持、Use、when、模型调用、智能对话、Agent、LLM、应用时使用、不适用于需要、确定性的关键决策等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持。根据文字描述生成图像。
# 启动ComfyUI服务
cd ComfyUI
python main.py --listen 0.0.0.0 --port 8188
# 使用默认工作流生成图像
python generate.py --prompt "a beautiful sunset over mountains, golden light, photorealistic" \
--output ./output/sunset.png
# Python API调用ComfyUI
import requests
import json
COMFYUI_URL = "http://localhost:8188"
def generate_image(prompt, negative_prompt="", seed=-1, steps=20, cfg=7.0,
width=512, height=512, model="v1-5-pruned-emaonly.safetensors"):
"""基础文生图"""
workflow = {
"3": {
"class_type": "KSampler",
"inputs": {
"seed": seed,
"steps": steps,
"cfg": cfg,
"sampler_name": "euler",
"scheduler": "normal",
"denoise": 1.0,
"model": ["4", 0],
"positive": ["6", 0],
"negative": ["7", 0],
"latent_image": ["5", 0]
}
},
"4": {
"class_type": "CheckpointLoaderSimple",
"inputs": {"ckpt_name": model}
},
"5": {
"class_type": "EmptyLatentImage",
"inputs": {"width": width, "height": height, "batch_size": 1}
},
"6": {
"class_type": "CLIPTextEncode",
"inputs": {"text": prompt, "clip": ["4", 1]}
},
"7": {
"class_type": "CLIPTextEncode",
"inputs": {"text": negative_prompt, "clip": ["4", 1]}
},
"8": {
"class_type": "VAEDecode",
"inputs": {"samples": ["3", 0], "vae": ["4", 2]}
},
"9": {
"class_type": "SaveImage",
"inputs": {"filename_prefix": "ComfyUI", "images": ["8", 0]}
}
}
# 提交工作流
response = requests.post(f"{COMFYUI_URL}/prompt", json={"prompt": workflow})
prompt_id = response.json()["prompt_id"]
# 等待完成并获取结果
# ... 轮询 /history/{prompt_id} 获取结果
return prompt_id
# 生成图像
generate_image(
prompt="a beautiful sunset over mountains, golden light, photorealistic",
negative_prompt="blurry, low quality, distorted",
steps=20,
cfg=7.0,
width=512,
height=512
)
调整生成参数获得不同效果。
# 高质量生成(更多步数)
python generate.py \
--prompt "portrait of a woman, detailed face, soft lighting" \
--steps 30 \
--cfg 8.0 \
--width 768 \
--height 768 \
--output ./output/portrait.png
# 快速预览(少步数)
python generate.py \
--prompt "landscape, mountains, river" \
--steps 10 \
--cfg 5.0 \
--width 512 \
--height 512 \
--output ./output/preview.png
使用固定种子复现相同结果。
# 固定种子生成
python generate.py \
--prompt "cyberpunk city, neon lights, rain" \
--seed 42 \
--steps 25 \
--output ./output/cyberpunk.png
# 相同种子相同结果
python generate.py \
--prompt "cyberpunk city, neon lights, rain" \
--seed 42 \
--steps 25 \
--output ./output/cyberpunk_copy.png
# 克隆ComfyUI
git clone
cd ComfyUI
# 安装依赖
pip install -r requirements.txt
# 下载SD1.5模型
cd models/checkpoints
wget https://huggingface.co/runwayml/stable-diffusion-v1-5/resolve/main/v1-5-pruned-emaonly.safetensors
# 启动ComfyUI
python main.py --listen 0.0.0.0 --port 8188
# 生成领先张图像
python generate.py --prompt "a cat sitting on a windowsill" --output ./output/cat.png
| 参数 | 默认值 | 说明 | 推荐范围 |
|---|---|---|---|
steps | 20 | 采样步数 | 10-50 |
cfg | 7.0 | CFG Scale | 5.0-15.0 |
seed | -1 | 随机种子 | -1或正整数 |
width | 512 | 图像宽度 | 512-1024 |
height | 512 | 图像高度 | 512-1024 |
sampler | euler | 采样器 | euler/euler_a/dpmpp_2m |
| 模型 | 类型 | 显存需求 | 说明 |
|---|---|---|---|
| SD 1.5 | 基础 | 4GB+ | 经典模型,速度快 |
| SDXL | 基础 | 8GB+ | 高质量,分辨率大 |
| SDXL Turbo | 快速 | 6GB+ | 极速生成 |
| 采样器 | 速度 | 质量 | 特点 |
|---|---|---|---|
| euler | 快 | 中 | 基础采样 |
| euler_a | 快 | 中高 | 带噪声调度 |
| dpmpp_2m | 中 | 高 | 推荐常用 |
| dpmpp_sde | 慢 | 最高 | 质量优选 |
降低图像尺寸(如512x512),减少采样步数,或使用SD1.5而非SDXL。关闭其他占显存的程序。
优化提示词,增加细节描述。调整CFG值(7-9通常效果较好)。尝试不同采样器。
免费版仅支持文生图。图生图功能需要升级至PRO版本。
免费版支持基础模型。自定义模型(如CivitAI下载的模型)需要升级至PRO版本。
减少采样步数,使用SD1.5模型,或使用SDXL Turbo快速模型。确保GPU驱动为最新版本。
| 依赖项 | 类型 | 是否必需 | 获取方式 |
|---|---|---|---|
| LLM API | API | 必需 | 由Agent内置LLM提供 |
| Python 3 | 运行时 | 必需 | python.org 下载安装 |
| ComfyUI | 工作流引擎 | 必需 | ComfyUI项目下载 |
| PyTorch | 深度学习框架 | 必需 | pip install torch |
| requests | Python库 | 必需 | pip install requests |
| 基础模型 | AI模型 | 必需 | HuggingFace下载 |
| 错误场景 | 原因 | 处理方式 |
|---|---|---|
| 配置错误 | 参数缺失或格式错误 | 检查依赖说明中的配置要求 |
| 运行时错误 | 运行环境不满足 | 确认运行环境符合依赖说明 |
| 网络错误 | 连接超时或不可达 | 执行ping命令测试网络连通性,检查防火墙和代理设置连接后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令,参考国内替代方案 |
| 风险类型 | 防范措施 |
|---|---|
| API密钥泄露 | 通过环境变量配置,禁止硬编码到代码或配置文件中 |
| 命令执行风险 | 仅执行白名单命令,避免拼接用户输入到命令行参数中 |
| 网络通信安全 | 使用HTTPS协议,验证SSL证书有效性 |
| 敏感数据暴露 | 输出结果中不包含密钥、令牌等敏感信息 |
使用前请确认已阅读依赖说明章节,确保运行环境满足安全要求。
| 操作场景 | 手动耗时 | 自动化耗时 | 效率提升 |
|---|---|---|---|
| 文件解析与提取 | 5-10分钟/个 | <5秒/个 | 60-120x |
| 批量文件处理(100个) | 8-16小时 | <5分钟 | 96-192x |
| API调用与响应解析 | 2-3分钟/次 | <1秒/次 | 120-180x |
| 多接口数据聚合 | 15-30分钟 | <10秒 | 90-180x |
| 命令执行与结果收集 | 3-5分钟/次 | <2秒/次 | 90-150x |
| 重复任务批量执行 | 因任务而异 | 线性缩减 | 5-50x |
| 错误排查与修复 | 10-30分钟 | <30秒 | 20-60x |
| 对比维度 | 本技能 | 传统手动方式 | 通用脚本工具 |
|---|---|---|---|
| 自动化程度 | 全流程自动 | 完全手动 | 部分自动 |
| 错误处理 | 内置错误恢复 | 依赖人工经验 | 基本try-catch |
| 可复用性 | 参数化配置 | 一次性脚本 | 模板化 |
| 安全合规 | 内置安全检查 | 无安全保障 | 无安全保障 |
| 适用场景 | 核心功能 | 通用场景 | 通用场景 |