ComfyUI

OpenClaw 內建隨附 comfy Plugin，用於以工作流程驅動的 ComfyUI 執行。此 Plugin 完全以工作流程驅動，因此 OpenClaw 不會嘗試將通用的 size、aspectRatio、resolution、durationSeconds 或 TTS 風格控制項對應到你的圖形。

屬性	詳細資訊
提供者	`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/*`

支援內容

從工作流程 JSON 產生圖片
使用 1 張已上傳參考圖片編輯圖片
從工作流程 JSON 產生影片
使用 1 張已上傳參考圖片產生影片
透過共用的 music_generate 工具產生音樂或音訊
從已設定的節點或所有相符的輸出節點下載輸出

開始使用

選擇在自己的機器上執行 ComfyUI，或使用 Comfy Cloud。

本機
Comfy Cloud

最適合： 在你的機器或 LAN 上執行自己的 ComfyUI 執行個體。

在本機啟動 ComfyUI

確認你的本機 ComfyUI 執行個體正在執行（預設為 http://127.0.0.1:8188）。

準備你的工作流程 JSON

匯出或建立 ComfyUI 工作流程 JSON 檔案。記下提示輸入節點和你希望 OpenClaw 讀取的輸出節點的節點 ID。

設定提供者

設定 mode: "local" 並指向你的工作流程檔案。以下是最小圖片範例：

{
  plugins: {
    entries: {
      comfy: {
        config: {
          mode: "local",
          baseUrl: "http://127.0.0.1:8188",
          image: {
            workflowPath: "./workflows/flux-api.json",
            promptNodeId: "6",
            outputNodeId: "9",
          },
        },
      },
    },
  },
}

設定預設模型

將 OpenClaw 指向你已設定能力的 comfy/workflow 模型：

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

驗證

openclaw models list --provider comfy

最適合： 不管理本機 GPU 資源，直接在 Comfy Cloud 上執行工作流程。

取得 API 金鑰

在 comfy.org 註冊，並從你的帳戶儀表板產生 API 金鑰。

設定 API 金鑰

透過以下其中一種方法提供你的金鑰：

# Environment variable (preferred)
export COMFY_API_KEY="your-key"

# Alternative environment variable
export COMFY_CLOUD_API_KEY="your-key"

# Or inline in config
openclaw config set plugins.entries.comfy.config.apiKey "your-key"

準備你的工作流程 JSON

匯出或建立 ComfyUI 工作流程 JSON 檔案。記下提示輸入節點和輸出節點的節點 ID。

設定提供者

設定 mode: "cloud" 並指向你的工作流程檔案：

{
  plugins: {
    entries: {
      comfy: {
        config: {
          mode: "cloud",
          image: {
            workflowPath: "./workflows/flux-api.json",
            promptNodeId: "6",
            outputNodeId: "9",
          },
        },
      },
    },
  },
}

雲端模式會將 baseUrl 預設為 https://cloud.comfy.org。只有在你使用自訂雲端端點時，才需要設定 baseUrl。

設定預設模型

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

驗證

openclaw models list --provider comfy

設定

Comfy 支援共用頂層連線設定，以及依能力區分的工作流程區段（image、video、music）：

{
  plugins: {
    entries: {
      comfy: {
        config: {
          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`	字串	選用的行內金鑰，可替代 `COMFY_API_KEY` / `COMFY_CLOUD_API_KEY` 環境變數。
`allowPrivateNetwork`	布林值	允許在雲端模式中使用私人/LAN `baseUrl`。

各能力鍵

這些鍵適用於 image、video 或 music 區段內：

鍵	必填	預設	說明
`workflow` 或 `workflowPath`	是	—	ComfyUI 工作流程 JSON 檔案的路徑。
`promptNodeId`	是	—	接收文字提示的節點 ID。
`promptInputName`	否	`"text"`	提示節點上的輸入名稱。
`outputNodeId`	否	—	要讀取輸出的節點 ID。若省略，會使用所有相符的輸出節點。
`pollIntervalMs`	否	—	作業完成的輪詢間隔，單位為毫秒。
`timeoutMs`	否	—	工作流程執行的逾時時間，單位為毫秒。

image 和 video 區段也支援：

鍵	必填	預設	說明
`inputImageNodeId`	是（傳入參考圖片時）	—	接收已上傳參考圖片的節點 ID。
`inputImageInputName`	否	`"image"`	圖片節點上的輸入名稱。

工作流程詳細資訊

圖片工作流程

將預設圖片模型設定為 comfy/workflow：

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

參考圖片編輯範例：若要啟用使用已上傳參考圖片的圖片編輯，請將 inputImageNodeId 加入你的圖片設定：

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

影片工作流程

將預設影片模型設定為 comfy/workflow：

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

Comfy 影片工作流程透過已設定的圖形支援文字轉影片和圖片轉影片。

OpenClaw 不會將輸入影片傳入 Comfy 工作流程。輸入僅支援文字提示和單一參考圖片。

音樂工作流程

內建 Plugin 會為工作流程定義的音訊或音樂輸出註冊音樂產生提供者，並透過共用的 music_generate 工具公開：

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

使用 music 設定區段指向你的音訊工作流程 JSON 和輸出節點。

向後相容性

現有的頂層圖片設定（沒有巢狀 image 區段）仍可使用：

{
  plugins: {
    entries: {
      comfy: {
        config: {
          workflowPath: "./workflows/flux-api.json",
          promptNodeId: "6",
          outputNodeId: "9",
        },
      },
    },
  },
}

OpenClaw 會將該舊版形狀視為圖片工作流程設定。你不需要立即遷移，但建議新設定使用巢狀 image / video / music 區段。

如果你只使用圖片產生，舊版扁平設定和新的巢狀 image 區段在功能上等效。

即時測試

內建 Plugin 有選擇加入的即時覆蓋範圍：

OPENCLAW_LIVE_TEST=1 COMFY_LIVE_TEST=1 pnpm test:live -- extensions/comfy/comfy.live.test.ts

除非已設定相符的 Comfy 工作流程區段，否則即時測試會略過個別圖片、影片或音樂案例。

圖像生成

圖像生成工具設定與用法。

影片生成

影片生成工具設定與用法。

音樂生成

音樂與音訊生成工具設定。

提供者目錄

所有提供者與模型參照的概覽。

設定參考

完整設定參考，包含代理預設值。

Overview

Concepts and configuration

Providers

支援內容

開始使用

設定

共用鍵

各能力鍵

工作流程詳細資訊

相關內容

圖像生成

影片生成

音樂生成

提供者目錄

設定參考

Overview

Concepts and configuration

Providers

Documentation Index

​支援內容

​開始使用

​設定

​共用鍵

​各能力鍵

​工作流程詳細資訊

​相關內容

圖像生成

影片生成

音樂生成

提供者目錄

設定參考

支援內容

開始使用

設定

共用鍵

各能力鍵

工作流程詳細資訊

相關內容