核心用法
ComfyUI-OpenClaw Skill 是一个专为 API 调用 ComfyUI 设计的高效代理技能。通过预置工作流模板(gen_z 文生图、qwen_edit 图生图编辑),用户可通过简洁 CLI 指令触发复杂图像生成任务。核心脚本 comfy_client.py 封装了提示词注入、图像自动上传、结果轮询等全流程,输出目录统一托管于 outputs/comfy/。
显著优点
1. 令牌经济:采用模板 ID 映射机制,聊天上下文中无需传输完整工作流 JSON;优先使用文件元数据路径替代视觉分析,大幅降低 LLM 上下文消耗
2. 自动资源处理:图生图任务支持本地图像路径自动上传,无需手动 base64 编码
3. 即插即用扩展:新增工作流仅需放置 JSON 文件并更新 WORKFLOW_MAP 字典,无需改动核心架构
4. 多格式交付:支持消息插件直发或本地文件打开,避免 base64 数据膨胀
潜在局限
- 硬编码依赖:主机地址
192.168.1.38:8190需预先配置,缺乏动态服务发现能力 - 模板维护成本:工作流逻辑变更需同步维护
comfy_client.py中的注入逻辑 - 单实例限制:当前架构未体现多 ComfyUI 节点负载均衡或故障转移机制
适合人群
本地/内网部署 ComfyUI 的自动化工作流用户、需要批量 API 调用的 AIGC 开发者、追求令牌效率的 LLM 代理集成场景。
常规风险
- 网络暴露风险:内网地址若配合端口转发至公网,需额外鉴权层防护
- 路径遍历隐患:
input_image_path参数若未严格校验,存在潜在文件系统越界风险 - 依赖版本锁定:ComfyUI 节点版本迭代可能导致预置 JSON 工作流兼容性失效