ComfyUI 本地技能

该技能允许 OpenClaw 通过连接本地网络中运行的 ComfyUI 实例来生成图像。

配置

1. 服务器地址：将 COMFYUI_SERVER_ADDRESS 环境变量设置为您的 PC 的 IP 地址和端口（例如：http://192.168.1.119:8189）。
2. API 模式：确保在 ComfyUI 设置中启用了 “启用开发模式（Enable Dev mode）”，以支持 API 交互。

使用方法

生成图像

使用提示词运行内置生成脚本：

python3 {skillDir}/scripts/comfy_gen.py "your image prompt" $COMFYUI_SERVER_ADDRESS

使用自定义工作流

将您的 API JSON 工作流文件放入 workflows/ 文件夹，然后在命令中指定路径：

python3 {skillDir}/scripts/comfy_gen.py "your prompt" $COMFYUI_SERVER_ADDRESS --workflow {skillDir}/workflows/my_workflow.json

功能特性

• 默认使用 SDXL：默认采用高质量 SDXL 工作流（Juggernaut XL）。
• 自动备份：默认将生成的图像保存至 image-gens/ 目录，并可配置为同步至本地文档文件夹。
• 支持自定义工作流：支持将外部 API JSON 工作流存放在 workflows/ 文件夹中。脚本会自动尝试将您的提示词及随机种子注入到工作流的对应节点中。

实现细节

该技能使用一个 Python 辅助脚本（scripts/comfy_gen.py）与 ComfyUI API 建立 WebSocket/HTTP 连接、提交提示词任务队列，并下载最终生成的图像。

ComfyUI 图像生成注意事项：

1. 服务器地址：

   • ComfyUI 服务器地址需作为直接参数传递给 comfy_gen.py 脚本（位于提示词之后），而不仅依赖环境变量。
   • 示例：python3 ... "Your prompt" http://192.168.1.119:8189 ...

2. 工作流路径：

   • 若指定的工作流文件路径中包含空格或特殊字符，则必须用单引号包裹，以确保脚本能正确解析。
   • 示例：--workflow '/path/to/your/workflow file name.json'

3. Lora 权重控制：

   • 当前版本的 comfy_gen.py 脚本未提供直接控制 Lora 权重的参数（例如：将 'l1lly' Lora 权重设为 0.90）。此功能可能需要在工作流 JSON 内部配置，或需对脚本或工作流进行相应修改。

4. 输出文件名：

   • 生成的图像默认可能以临时名称保存（例如：ComfyUI_temp_...png），而非更具描述性的命名。

5. ComfyUI 配置：

   • 请确认已在 ComfyUI 设置中启用 “启用开发模式（Enable Dev mode）”，以保障 API 正常交互。