ComfyUI

OpenClaw 内置 comfy 插件，支持工作流驱动的 ComfyUI 运行。

• Provider ID：comfy
• 模型：comfy/workflow
• 共享接口：image_generate、video_generate、music_generate
• 认证：本地 ComfyUI 无需认证；Comfy Cloud 使用 COMFY_API_KEY 或 COMFY_CLOUD_API_KEY
• API：ComfyUI /prompt / /history / /view 及 Comfy Cloud /api/*

支持的能力

• 从 workflow JSON 生成图片
• 图片编辑（最多传入 1 张参考图片）
• 从 workflow JSON 生成视频
• 带参考图片的视频生成
• 通过共享 music_generate 工具生成音乐或音频
• 从指定节点或所有匹配的输出节点下载结果

该插件完全由 workflow 驱动，OpenClaw 不会将通用的 size、aspectRatio、resolution、durationSeconds 等参数自动映射到你的 ComfyUI 图上。

配置结构

Comfy 支持共享顶层连接配置，加上各能力独立的 workflow 区块：

{
  models: {
    providers: {
      comfy: {
        mode: "local",
        baseUrl: "http://127.0.0.1:8188",
        image: {
          workflowPath: "./workflows/flux-api.json",
          promptNodeId: "6",
          outputNodeId: "9",
        },
        video: {
          workflowPath: "./workflows/video-api.json",
          promptNodeId: "12",
          outputNodeId: "21",
        },
        music: {
          workflowPath: "./workflows/music-api.json",
          promptNodeId: "3",
          outputNodeId: "18",
        },
      },
    },
  },
}

共享配置项：

• mode：local 或 cloud
• baseUrl：本地默认 http://127.0.0.1:8188，云端默认 https://cloud.comfy.org
• apiKey：可选，内联 Key（也可用环境变量代替）
• allowPrivateNetwork：cloud 模式下允许私有/LAN BaseURL

各能力区块（image、video、music）的配置项：

• workflow 或 workflowPath：必填
• promptNodeId：必填
• promptInputName：默认 text
• outputNodeId：可选
• pollIntervalMs：可选
• timeoutMs：可选

图片和视频区块还支持：

• inputImageNodeId：传入参考图片时必填
• inputImageInputName：默认 image

向后兼容

已有的顶层图片配置仍然有效：

{
  models: {
    providers: {
      comfy: {
        workflowPath: "./workflows/flux-api.json",
        promptNodeId: "6",
        outputNodeId: "9",
      },
    },
  },
}

OpenClaw 会将这种旧写法视为图片 workflow 配置。

图片生成

设置默认图片模型：

{
  agents: {
    defaults: {
      imageGenerationModel: {
        primary: "comfy/workflow",
      },
    },
  },
}

参考图片编辑示例：

{
  models: {
    providers: {
      comfy: {
        image: {
          workflowPath: "./workflows/edit-api.json",
          promptNodeId: "6",
          inputImageNodeId: "7",
          inputImageInputName: "image",
          outputNodeId: "9",
        },
      },
    },
  },
}

视频生成

设置默认视频模型：

{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "comfy/workflow",
      },
    },
  },
}

Comfy 视频 workflow 支持文生视频和图生视频，OpenClaw 目前不会将输入视频传入 Comfy workflow。

音乐生成

内置插件注册了音乐生成 Provider，通过共享 music_generate 工具对外暴露：

/tool music_generate prompt="Warm ambient synth loop with soft tape texture"

在 music 配置区块中指定你的音频 workflow JSON 和输出节点。

Comfy Cloud

使用 mode: "cloud" 加任意一种认证：

• COMFY_API_KEY
• COMFY_CLOUD_API_KEY
• models.providers.comfy.apiKey

Cloud 模式仍然使用相同的 image、video、music workflow 区块。

延伸阅读

• 图片生成
• 视频生成
• 音乐生成
• 配置参考