ComfyUI Skill

核心用法

ComfyUI Local Skill 是一款面向本地 AI 图像生成的工具型 skill，通过连接用户自托管的 ComfyUI 服务器实现私有化图像创作。核心使用流程包括：

1. 环境配置：设置 COMFYUI_SERVER_ADDRESS 环境变量指向本地 ComfyUI 实例地址，并开启 ComfyUI 的 "Enable Dev mode" 以允许 API 调用
2. 基础生成：调用 comfy_gen.py 脚本，传入文本提示词和服务器地址即可生成图像
3. 高级工作流：将 API 格式的 JSON 工作流文件放入 workflows/ 目录，通过 --workflow 参数调用自定义流程，支持自动注入提示词和随机种子

默认搭载 Juggernaut XL SDXL 高质量工作流，输出自动备份至 image-gens/ 目录。

显著优点

• 数据隐私：完全本地化运行，图像生成过程不经过第三方云端，敏感提示词与产出内容零外流
• 高度可定制：支持 ComfyUI 生态的任意工作流导入，从简单文生图到复杂多节点合成均可实现
• 硬件自主权：充分利用本地 GPU 算力，无订阅费用、无生成次数限制
• SDXL 默认优化：内置成熟的高质量 SDXL 配置，开箱即用

潜在缺点与局限性

• 部署门槛高：要求用户独立搭建 ComfyUI 环境、配置 Python 依赖及模型文件，技术门槛显著高于云端方案
• 网络依赖：虽为本地运行，但仍需确保 OpenClaw 与 ComfyUI 服务器间的局域网连通性
• 参数控制受限：当前脚本未暴露 Lora 权重等细粒度参数接口，需手动修改工作流 JSON
• 输出命名规范不足：生成文件采用临时命名格式，不利于批量管理
• 路径处理敏感：含空格或特殊字符的工作流路径需手动加单引号转义

适合人群

• 对 AI 图像生成有隐私合规要求的创作者与企业用户
• 已拥有中高端 NVIDIA GPU 且熟悉 ComfyUI/Stable Diffusion 生态的技术爱好者
• 需要批量、自动化图像生产流程的开发者
• 追求工作流极致自定义、不愿受云端服务限制的专业设计师

常规风险

• 环境配置错误风险：服务器地址或 Dev mode 设置不当将导致 API 连接失败
• 模型与插件兼容性：自定义工作流可能依赖特定模型或节点插件，版本不匹配易引发执行错误
• 资源消耗：SDXL 级别模型对显存要求较高，低配置设备可能触发 OOM 或生成超时
• 网络暴露风险：若将 ComfyUI 监听地址设为 0.0.0.0，可能存在局域网内未授权访问隐患

核心用法

ComfyUI Local Skill 是一款专为 OpenClaw 设计的本地图像生成工具，通过 WebSocket/HTTP 协议连接用户自行部署的 ComfyUI 服务器，实现完全私有的 AI 图像生成。使用时需先配置 COMFYUI_SERVER_ADDRESS 环境变量指向本地 ComfyUI 实例地址，并确保 ComfyUI 开启开发者模式（"Enable Dev mode"）。核心调用方式为执行 Python 脚本 comfy_gen.py，支持两种模式：直接输入提示词使用默认 SDXL 工作流生成图像，或指定自定义 JSON 工作流文件路径以实现更复杂的图像生成管线。生成的图像自动保存至 image-gens/ 目录，并可配置同步到本地文档文件夹。

显著优点

该技能的最大优势在于数据隐私与本地可控性。与云端图像生成服务不同，所有计算均在用户本地硬件完成，图像数据和提示词不会上传至任何外部服务器，特别适合处理敏感或商业机密内容。技术实现上，采用 Python 标准库完成全部功能，零第三方依赖，部署轻量且维护成本低。默认集成 Juggernaut XL 高质量 SDXL 工作流，开箱即用即可获得专业级图像输出。更难得的是支持完全自定义工作流——用户可将 ComfyUI 中设计的复杂节点工作流导出为 API JSON 格式，放置于 workflows/ 目录后通过参数调用，脚本会自动注入提示词和随机种子，实现高度灵活的生成控制。自动备份机制也确保了创作成果的安全存储。

潜在缺点与局限性

首要限制是硬件门槛与部署复杂度。用户必须自行在具备足够算力的机器上安装并运行 ComfyUI，这对非技术用户构成显著障碍。其次，脚本功能相对精简：缺乏直接的 LoRA 权重控制参数，需在工作流 JSON 中手动配置；输出文件名默认为 ComfyUI_temp_... 格式，无法自定义命名规则；错误处理机制较为笼统，使用通用 Exception 捕获，调试体验欠佳。网络通信方面，当前默认使用 HTTP 而非 HTTPS，在同一局域网内存在中间人攻击的理论风险。此外，工作流路径含空格时需手动加引号，用户体验细节有待打磨。

适合的目标群体

该技能最适合具备一定技术背景的 AI 图像创作者——包括：拥有本地 GPU 算力、已部署 ComfyUI 的 Stable Diffusion 进阶用户；对数据隐私有严格要求的设计师、插画师或内容创作者；需要批量生成图像并集成到自动化工作流中的开发者和工作室；以及希望脱离云端服务、实现完全自主可控的 AI 艺术爱好者。对于完全的新手用户，建议先从 ComfyUI 官方文档学习部署后再尝试本技能。

使用风险

常规风险主要包括：网络配置风险，错误的 COMFYUI_SERVER_ADDRESS 或防火墙设置将导致连接失败；存储管理风险，image-gens/ 目录持续累积文件可能占用大量磁盘空间；工作流兼容性风险，自定义 JSON 工作流若节点结构不符合预期，可能导致注入失败或生成异常；性能依赖风险，图像生成速度完全取决于本地硬件配置，低配机器可能出现长时间等待；版本同步风险，ComfyUI 服务端更新后 API 行为变化可能影响技能兼容性，建议关注双方版本匹配。