ComfyUI Painter

本地 ComfyUI 画图工作流 + CivitAI 集成。通过 API 控制本地 ComfyUI 生成图片（文生图/图生视频），支持 CivitAI 模型搜索/下载/更新检查/自动调参。Use when: 用户说画图、生成图片、generate image、comfyui、换模型、调参数、出图、搜模型、下载模型、c站、civitai，或在 Discord #🎨-画图频道的任何消息。NOT for: 非图片生成相关的请求。

Audits

Suspicious

ClawScanSuspicious

Agentic behavior and permission review.

Static analysisPass

Pattern checks against bundled files.

VirusTotalPass

Multi-engine malware detections and file reputation.

Install

openclaw skills install comfyui-painter

ComfyUI Painter v2.0

通过 ComfyUI API 在本地 RTX 5090 上生成图片，集成 CivitAI 模型管理。

工作流程

检查 ComfyUI 是否运行，未运行则自动启动
解析用户需求：提示词、模型、参数
自动调参：根据模型从 CivitAI 获取推荐参数（或使用 config 缓存）
调用 generate.py 生成图片
将图片发送到 Discord
心跳时调用 auto_shutdown.py 检查空闲关闭

脚本路径

所有脚本相对于此 skill 目录：

scripts/comfyui_manager.py — 启动/关闭/状态
scripts/generate.py — 生成图片（Python API 调用）
scripts/auto_shutdown.py — 空闲自动关闭检查
scripts/civitai.py — CivitAI 集成（搜索/详情/下载/更新检查/推荐参数）
scripts/auto_tune.py — 自动调参（从 CivitAI 样图元数据提取推荐设置）
config.json — 配置文件（模型别名、默认参数、路径、CivitAI 关联）

使用方式

启动 ComfyUI

import scripts.comfyui_manager as mgr
mgr.start()  # 自动从 WSL 启动 Windows ComfyUI 进程

生成图片

from scripts.generate import generate
result = generate(
    positive="your prompt here",
    model="noobv6",        # 见下方模型别名
    batch_size=4,
    width=1024,
    height=1536,
    steps=20,
    cfg=5,
)
# result = {"ok": True, "images": ["/mnt/d/.../sdi_00201_.png", ...]}

带自动调参生成

from scripts.auto_tune import get_tuned_params
from scripts.generate import generate

params = get_tuned_params("janku")  # 从 CivitAI 获取推荐参数
result = generate(
    positive="your prompt",
    model="janku",
    steps=params["steps"],
    cfg=params["cfg"],
    width=params["width"],
    height=params["height"],
)

CivitAI 搜索模型

python3 scripts/civitai.py search "anime checkpoint" --limit 5

CivitAI 查看模型详情

python3 scripts/civitai.py info 140272

CivitAI 获取推荐参数

python3 scripts/civitai.py params 140272

CivitAI 检查本地模型更新

python3 scripts/civitai.py check-updates

⚠️ 需要计算 SHA256，每个文件约 30 秒

CivitAI 下载模型

python3 scripts/civitai.py download "https://civitai.com/api/download/models/XXXXX" --filename model_name.safetensors

更新所有模型的推荐参数到 config

python3 scripts/auto_tune.py update-all

发送图片到 Discord

生成完成后，将图片 cp 到 workspace 临时目录，用 message tool 发送到 #🎨-画图频道（channel:1476675131404193823）。

关闭 ComfyUI

import scripts.comfyui_manager as mgr
mgr.stop()

模型别名

别名	Checkpoint	CivitAI ID	版本	风格
hassaku	hassakuXLIllustrious_v34	140272	v3.4	Illustrious 动漫
noobv6	pornmasterPro_noobV6	1045588	noob-V6	NoobAI 动漫（默认）
noobv4	pornmasterPro_noobV4	1045588	noob-V4	NoobAI 动漫（旧版）
sdxlv8	pornmaster_proSDXLV8	82543	Pro-SDXL-V8	SDXL 写实
janku	JANKUTrainedNoobaiRouwei_v69	1277670	v6.9	NoobAI+RouWei 混合
nova3d	nova3DCGXL_ilV80	715287	IL v8.0	3DCG/2.5D
unholy	unholyDesireMixSinister_v70	1307857	v7.0	暗黑美学
flux	flux1-dev-bnb-nf4-v2	638187	BNB NF4 v2	Flux 写实

自动调参（model_params）

每个模型在 config.json 中有 CivitAI 推荐的最佳参数。生成时：

用户指定的参数优先
未指定则使用 config.json → model_params[alias] 的推荐值
model_params 也没有则使用 defaults 全局默认

模型	Steps	CFG	采样器
hassaku	20	7	euler_a
janku	20	7	euler_a
noobv6	20	7	euler_a
sdxlv8	25	5	dpmpp_2m
nova3d	20	7	euler_a
unholy	20	7	euler_a
flux	20	1	euler

CivitAI 配置

API Key 存于 ~/.openclaw/workspace/credentials/civitai.md，格式：

# CivitAI API Key
Token: your_api_key_here

提示词优化指南

用户给自然语言描述时，转换为专业 Stable Diffusion 提示词：

质量标签在前：masterpiece, best quality, absurdres, highres
用 BREAK 分隔不同语义段
动作/姿势用专业标签：mating press, pov, from below, spread legs
细节标签：detailed skin, sweat, wet skin, motion blur, dynamic angle
负面提示词加入：censored, mosaic censoring, bar censor

心跳集成

每次心跳时运行 auto_shutdown.py 检查空闲时间，超过 15 分钟无使用自动关闭 ComfyUI 释放显存。