OpenClaw 内置 comfy 插件，通过 ComfyUI workflow JSON 驱动图像、视频和音乐生成，支持本地 ComfyUI 实例和 Comfy Cloud。
| 属性 | 值 |
|---|---|
| Provider ID | comfy |
| 模型 | comfy/workflow |
| 支持能力 | image_generate、video_generate、music_generate |
| 认证 | 本地无需；Cloud 使用 COMFY_API_KEY 或 COMFY_CLOUD_API_KEY |
注意：插件完全由 workflow 驱动，不映射通用的 size、aspectRatio、resolution 等参数到 workflow 图。
快速开始
本地模式：
{
plugins: {
entries: {
comfy: {
config: {
mode: "local",
baseUrl: "http://127.0.0.1:8188",
image: {
workflowPath: "./workflows/flux-api.json",
promptNodeId: "6",
outputNodeId: "9",
},
},
},
},
},
agents: {
defaults: {
imageGenerationModel: { primary: "comfy/workflow" },
},
},
}Cloud 模式：
export COMFY_API_KEY="your-key"{
plugins: {
entries: {
comfy: {
config: {
mode: "cloud",
image: {
workflowPath: "./workflows/flux-api.json",
promptNodeId: "6",
outputNodeId: "9",
},
},
},
},
},
}配置关键字段
共享字段：
| 字段 | 类型 | 说明 |
|---|---|---|
mode | "local" 或 "cloud" | 连接模式 |
baseUrl | string | 本地默认 http://127.0.0.1:8188，Cloud 默认 https://cloud.comfy.org |
apiKey | string | 可选内联 key |
每个能力（image/video/music）的字段：
| 字段 | 必填 | 说明 |
|---|---|---|
workflowPath 或 workflow | 是 | workflow JSON 文件路径 |
promptNodeId | 是 | 接收文本提示的节点 ID |
outputNodeId | 否 | 读取输出的节点 ID |
inputImageNodeId | 条件必填 | 接收参考图的节点 ID |
支持的功能
- 图像生成（文字转图片）
- 图像编辑（1 张参考图）
- 视频生成（文字转视频、图片转视频）
- 音乐/音频生成（通过
music_generate工具）
注意：OpenClaw 不向 Comfy workflow 传入视频输入，仅支持文本提示和单张参考图。
相关链接
- provider-fal — 另一个图像/视频生成提供商
- provider-runway — Runway 视频生成
- providers — 所有 provider 总览