Providers
ComfyUI
OpenClaw cung cấp kèm Plugin comfy để chạy ComfyUI theo quy trình công việc. Plugin
hoàn toàn vận hành theo quy trình công việc: OpenClaw không ánh xạ các tùy chọn chung như size,
aspectRatio, resolution, durationSeconds hoặc các tùy chọn kiểu TTS vào
đồ thị của bạn.
| Thuộc tính | Chi tiết |
|---|---|
| Nhà cung cấp | comfy |
| Mô hình | comfy/workflow |
| Công cụ dùng chung | image_generate, video_generate, music_generate |
| Xác thực | Không cần cho ComfyUI cục bộ; COMFY_API_KEY hoặc COMFY_CLOUD_API_KEY cho Comfy Cloud |
| API | ComfyUI /prompt / /history / /view; Comfy Cloud /api/* |
Các tính năng được hỗ trợ
- Tạo và chỉnh sửa hình ảnh từ JSON quy trình công việc (chỉnh sửa nhận 1 hình ảnh tham chiếu đã tải lên)
- Tạo video từ JSON quy trình công việc, chuyển văn bản thành video hoặc hình ảnh thành video (1 hình ảnh tham chiếu)
- Tạo nhạc/âm thanh thông qua công cụ dùng chung
music_generate, với 1 hình ảnh tham chiếu tùy chọn - Tải xuống đầu ra từ Node đã cấu hình hoặc từ tất cả Node đầu ra phù hợp khi không có Node nào được cấu hình
Bắt đầu
Chọn chạy ComfyUI trên máy của riêng bạn hoặc sử dụng Comfy Cloud.
Local
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 mạng LAN.
Start ComfyUI locally
Đảm bảo phiên bản ComfyUI cục bộ của bạn đang chạy (mặc định tại http://127.0.0.1:8188).
Prepare your workflow JSON
Xuất hoặc tạo tệp JSON quy trình công việc ComfyUI. Ghi lại ID Node của Node đầu vào lời nhắc và Node đầu ra mà bạn muốn OpenClaw đọc.
Configure the provider
Đặt mode: "local" và trỏ đến tệp quy trình công việc của bạn. 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", }, }, }, }, },}Set the default model
Trỏ OpenClaw đến mô hình comfy/workflow cho khả năng bạn đã cấu hình:
{ agents: { defaults: { imageGenerationModel: { primary: "comfy/workflow", }, }, },}Verify
openclaw models list --provider comfyComfy Cloud
Phù hợp nhất cho: chạy quy trình công việc trên Comfy Cloud mà không cần quản lý tài nguyên GPU cục bộ.
Get an API key
Đăng ký tại comfy.org và tạo khóa API từ bảng điều khiển tài khoản của bạn.
Set the API key
Cung cấp khóa của bạn bằng bất kỳ phương thức nào sau đây:
# Onboarding flagopenclaw onboard --comfy-api-key "your-key" # Environment variable (preferred for daemons)export COMFY_API_KEY="your-key" # Alternative environment variableexport COMFY_CLOUD_API_KEY="your-key" # Or inline in configopenclaw config set plugins.entries.comfy.config.apiKey "your-key"Prepare your workflow JSON
Xuất hoặc tạo tệp JSON quy trình công việc ComfyUI. Ghi lại ID Node của Node đầu vào lời nhắc và Node đầu ra.
Configure the provider
Đặt mode: "cloud" và trỏ đến tệp quy trình công việc của bạn:
{ plugins: { entries: { comfy: { config: { mode: "cloud", image: { workflowPath: "./workflows/flux-api.json", promptNodeId: "6", outputNodeId: "9", }, }, }, }, },}Set the default model
{ agents: { defaults: { imageGenerationModel: { primary: "comfy/workflow", }, }, },}Verify
openclaw models list --provider comfyCấ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 công việc riêng cho từng khả năng (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", }, }, }, }, },}Các khóa dùng chung
| Khóa | Kiểu | Mô tả |
|---|---|---|
mode |
"local" hoặc "cloud" |
Chế độ kết nối. Mặc định là "local". |
baseUrl |
chuỗi | Mặc định là http://127.0.0.1:8188 cho cục bộ hoặc https://cloud.comfy.org cho đám mây. |
apiKey |
chuỗi | Khóa nội tuyến tùy chọn, thay thế cho các biến môi trường COMFY_API_KEY / COMFY_CLOUD_API_KEY. |
allowPrivateNetwork |
boolean | Cho phép baseUrl riêng tư/LAN trong chế độ đám mây hoặc FQDN DNS riêng cục bộ. |
Các khóa theo từng khả năng
Các khóa này áp dụng bên trong các phần image, video hoặc music:
| Khóa | Bắt buộc | Mặc định | Mô tả |
|---|---|---|---|
workflow hoặc workflowPath |
Có | -- | JSON quy trình công việc nội tuyến hoặc đường dẫn đến tệp JSON quy trình công việc ComfyUI. |
promptNodeId |
Có | -- | ID Node nhận lời nhắc văn bản. |
promptInputName |
Không | "text" |
Tên đầu vào trên Node lời nhắc. |
outputNodeId |
Không | -- | ID Node dùng để đọc đầu ra. Nếu bỏ qua, tất cả Node đầu ra phù hợp đều được sử dụng. |
pollIntervalMs |
Không | 1500 |
Khoảng thời gian thăm dò tính bằng mili giây để kiểm tra công việc hoàn tất. |
timeoutMs |
Không | 300000 |
Thời gian chờ tính bằng mili giây cho lần chạy quy trình công việc. |
Các phần image và video cũng hỗ trợ Node đầu vào hình ảnh tham chiếu:
| Khóa | Bắt buộc | Mặc định | Mô tả |
|---|---|---|---|
inputImageNodeId |
Có (khi truyền hình ảnh tham chiếu) | -- | ID Node nhận hình ảnh tham chiếu đã tải lên. |
inputImageInputName |
Không | "image" |
Tên đầu vào trên Node hình ảnh. |
apiKey chấp nhận chuỗi literal hoặc đối tượng tham chiếu bí mật.
Chi tiết quy trình công việc
Image workflows
Đặ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 bằng hình ảnh tham chiếu:
Để bật tính năng chỉnh sửa hình ảnh bằng 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", }, }, }, }, },}Video workflows
Đặt mô hình video mặc định thành comfy/workflow:
{ agents: { defaults: { videoGenerationModel: { primary: "comfy/workflow", }, }, },}Các quy trình công 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.
Music workflows
Plugin đi kèm đăng ký một nhà cung cấp tạo nhạc cho đầu ra âm thanh hoặc nhạc được xác định bởi quy trình công việc, được cung cấp thông qua công cụ dùng chung music_generate. Công cụ này chấp nhận một hình ảnh tham chiếu tùy chọn (tối đa 1):
/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 công việc âm thanh và Node đầu ra của bạn.
Backward compatibility
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 cấu trúc cũ đó là cấu hình quy trình công 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 các thiết lập mới. Nếu bạn chỉ sử dụng tính năng tạo hình ảnh, cấu hình phẳng cũ và phần image lồng nhau mới tương đương nhau về chức năng.
Live tests
Có phạm vi kiểm thử trực tiếp tùy chọn cho Plugin đi kèm:
OPENCLAW_LIVE_TEST=1 COMFY_LIVE_TEST=1 pnpm test:live -- extensions/comfy/comfy.live.test.tsBài kiểm thử trực tiếp sẽ bỏ qua từng trường hợp hình ảnh, video hoặc âm nhạc, trừ khi phần quy trình làm việc Comfy tương ứng đã được cấu hình.
Liên quan
Cấu hình và cách sử dụng công cụ tạo hình ảnh.
Cấu hình và cách sử dụng công cụ tạo video.
Thiết lập công cụ tạo âm nhạc và âm thanh.
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 đầy đủ, bao gồm các giá trị mặc định của tác tử.
