Chuyển đến nội dung chính

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

OpenClaw đi kèm Plugin comfy được tích hợp sẵn cho các lần chạy ComfyUI theo quy trình làm việc. Plugin này hoàn toàn dựa trên quy trình làm việc, vì vậy OpenClaw không cố ánh xạ các điều khiển chung như size, aspectRatio, resolution, durationSeconds, hoặc kiểu TTS vào đồ thị của bạn.
Thuộc tínhChi tiết
Nhà cung cấpcomfy
Mô hìnhcomfy/workflow
Bề mặt dùng chungimage_generate, video_generate, music_generate
Xác thựcKhông cần cho ComfyUI cục bộ; COMFY_API_KEY hoặc COMFY_CLOUD_API_KEY cho Comfy Cloud
APIComfyUI /prompt / /history / /view và Comfy Cloud /api/*

​
Hỗ trợ những gì

  • Tạo hình ảnh từ JSON quy trình làm việc
  • Chỉnh sửa hình ảnh với 1 hình ảnh tham chiếu đã tải lên
  • Tạo video từ JSON quy trình làm việc
  • Tạo video với 1 hình ảnh tham chiếu đã tải lên
  • Tạo nhạc hoặc âm thanh thông qua công cụ dùng chung music_generate
  • Tải xuống đầu ra từ một node đã cấu hình hoặc tất cả các node đầu ra khớp

​
Bắt đầu

Chọn giữa việc chạy ComfyUI trên máy của bạn hoặc sử dụng Comfy Cloud.
Phù hợp nhất cho: chạy phiên bản ComfyUI của riêng bạn trên máy hoặc LAN.
1

Khởi động ComfyUI cục bộ

Đảm bảo phiên bản ComfyUI cục bộ của bạn đang chạy (mặc định là http://127.0.0.1:8188).
2

Chuẩn bị JSON quy trình làm việc của bạn

Xuất hoặc tạo tệp JSON quy trình làm việc ComfyUI. Ghi lại ID node cho node nhập lời nhắc và node đầu ra mà bạn muốn OpenClaw đọc từ đó.
3

Cấu hình nhà cung cấp

Đặt mode: "local" và trỏ đến tệp quy trình làm việc của bạn. Đây là ví dụ hình ảnh tối thiểu:
{
  plugins: {
    entries: {
      comfy: {
        config: {
          mode: "local",
          baseUrl: "http://127.0.0.1:8188",
          image: {
            workflowPath: "./workflows/flux-api.json",
            promptNodeId: "6",
            outputNodeId: "9",
          },
        },
      },
    },
  },
}
4

Đặt mô hình mặc định

Trỏ OpenClaw đến mô hình comfy/workflow cho năng lực bạn đã cấu hình:
{
  agents: {
    defaults: {
      imageGenerationModel: {
        primary: "comfy/workflow",
      },
    },
  },
}
5

Xác minh

openclaw models list --provider comfy

​
Cấu hình

Comfy hỗ trợ các thiết lập kết nối cấp cao nhất dùng chung cùng với các phần quy trình làm việc theo từng năng lực (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",
          },
        },
      },
    },
  },
}

​
Khóa dùng chung

KhóaKiểuMô tả
mode"local" hoặc "cloud"Chế độ kết nối.
baseUrlstringMặc định là http://127.0.0.1:8188 cho cục bộ hoặc https://cloud.comfy.org cho đám mây.
apiKeystringKhóa nội tuyến tùy chọn, thay thế cho biến môi trường COMFY_API_KEY / COMFY_CLOUD_API_KEY.
allowPrivateNetworkbooleanCho phép baseUrl riêng tư/LAN trong chế độ đám mây.

​
Khóa theo từng năng lực

Các khóa này áp dụng bên trong các phần image, video, hoặc music:
KhóaBắt buộcMặc địnhMô tả
workflow hoặc workflowPathCó—Đường dẫn đến tệp JSON quy trình làm việc ComfyUI.
promptNodeIdCó—ID node nhận lời nhắc văn bản.
promptInputNameKhông"text"Tên đầu vào trên node lời nhắc.
outputNodeIdKhông—ID node để đọc đầu ra từ đó. Nếu bỏ qua, tất cả node đầu ra khớp sẽ được dùng.
pollIntervalMsKhông—Khoảng thời gian thăm dò tính bằng mili giây để hoàn tất tác vụ.
timeoutMsKhông—Thời gian chờ tính bằng mili giây cho lần chạy quy trình làm việc.
Các phần image và video cũng hỗ trợ:
KhóaBắt buộcMặc địnhMô tả
inputImageNodeIdCó (khi truyền một hình ảnh tham chiếu)—ID node nhận hình ảnh tham chiếu đã tải lên.
inputImageInputNameKhông"image"Tên đầu vào trên node hình ảnh.

​
Chi tiết quy trình làm việc

Đặt mô hình hình ảnh mặc định thành comfy/workflow:
{
  agents: {
    defaults: {
      imageGenerationModel: {
        primary: "comfy/workflow",
      },
    },
  },
}
Ví dụ chỉnh sửa hình ảnh tham chiếu:Để bật chỉnh sửa hình ảnh với một hình ảnh tham chiếu đã tải lên, hãy thêm inputImageNodeId vào cấu hình hình ảnh của bạn:
{
  plugins: {
    entries: {
      comfy: {
        config: {
          image: {
            workflowPath: "./workflows/edit-api.json",
            promptNodeId: "6",
            inputImageNodeId: "7",
            inputImageInputName: "image",
            outputNodeId: "9",
          },
        },
      },
    },
  },
}
Đặt mô hình video mặc định thành comfy/workflow:
{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "comfy/workflow",
      },
    },
  },
}
Các quy trình làm việc video của Comfy hỗ trợ chuyển văn bản thành video và hình ảnh thành video thông qua đồ thị đã cấu hình.
OpenClaw không truyền video đầu vào vào quy trình làm việc Comfy. Chỉ hỗ trợ lời nhắc văn bản và một hình ảnh tham chiếu đơn lẻ làm đầu vào.
Plugin tích hợp sẵn đăng ký một nhà cung cấp tạo nhạc cho đầu ra âm thanh hoặc nhạc được định nghĩa bằng quy trình làm việc, được hiển thị thông qua công cụ dùng chung music_generate:
/tool music_generate prompt="Warm ambient synth loop with soft tape texture"
Sử dụng phần cấu hình music để trỏ đến JSON quy trình làm việc âm thanh và node đầu ra của bạn.
Cấu hình hình ảnh cấp cao nhất hiện có (không có phần image lồng nhau) vẫn hoạt động:
{
  plugins: {
    entries: {
      comfy: {
        config: {
          workflowPath: "./workflows/flux-api.json",
          promptNodeId: "6",
          outputNodeId: "9",
        },
      },
    },
  },
}
OpenClaw coi hình dạng kế thừa đó là cấu hình quy trình làm việc hình ảnh. Bạn không cần di chuyển ngay lập tức, nhưng các phần image / video / music lồng nhau được khuyến nghị cho thiết lập mới.
Nếu bạn chỉ sử dụng tạo hình ảnh, cấu hình phẳng kế thừa và phần image lồng nhau mới tương đương về mặt chức năng.
Phạm vi kiểm thử trực tiếp tùy chọn có sẵn cho Plugin tích hợp sẵn:
OPENCLAW_LIVE_TEST=1 COMFY_LIVE_TEST=1 pnpm test:live -- extensions/comfy/comfy.live.test.ts
Kiểm thử trực tiếp bỏ qua từng trường hợp hình ảnh, video, hoặc nhạc riêng lẻ trừ khi phần quy trình làm việc Comfy tương ứng được cấu hình.

​
Liên quan

Tạo hình ảnh

Cấu hình và cách sử dụng công cụ tạo hình ảnh.

Tạo video

Cấu hình và cách sử dụng công cụ tạo video.

Tạo nhạc

Thiết lập công cụ tạo nhạc và âm thanh.

Danh mục nhà cung cấp

Tổng quan về tất cả nhà cung cấp và tham chiếu mô hình.

Tham chiếu cấu hình

Tham chiếu cấu hình đầy đủ, bao gồm mặc định của tác tử.