Issue Station
Sign In
Tools hereToolbox

openclaw - 💡(How to fix) Fix [Bug]: comfy provider setup does not work as described in the documentation [1 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
openclaw/openclaw#70345•Fetched 2026-04-23 07:25:59
View on GitHub
Comments
0
Participants
1
Timeline
2
Reactions
0
Author
ilker-aktunailker-aktuna
Participants
ilker-aktunailker-aktuna
Timeline (top)
labeled ×2

I am trying to add image generation to my agent by using local comfyUI installation. I followed the documentation here: https://docs.openclaw.ai/providers/comfy#configuration

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

but when I do this and check with suggested command , it first asks for a "models" array under comfy . I don't know what to write there. But I wrote "workflow" as a model name. Then it says:

  • models.providers.comfy: Unrecognized key: "image"
  • models.providers.comfy: Unrecognized key: "mode"

so , either the documentation ids wrong or there is a bug.

here's what I already tried: "models": { "mode": "merge", "providers": { "comfy": { "baseUrl": "http://127.0.0.1:8188", "image": { workflowPath: "./workflows/image.json", promptNodeId: "6", outputNodeId: "9", }, "models": [ { "id": "workflow", "name": "workflow", } ] },

Root Cause

I am trying to add image generation to my agent by using local comfyUI installation. I followed the documentation here: https://docs.openclaw.ai/providers/comfy#configuration

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

but when I do this and check with suggested command , it first asks for a "models" array under comfy . I don't know what to write there. But I wrote "workflow" as a model name. Then it says:

  • models.providers.comfy: Unrecognized key: "image"
  • models.providers.comfy: Unrecognized key: "mode"

so , either the documentation ids wrong or there is a bug.

here's what I already tried: "models": { "mode": "merge", "providers": { "comfy": { "baseUrl": "http://127.0.0.1:8188", "image": { workflowPath: "./workflows/image.json", promptNodeId: "6", outputNodeId: "9", }, "models": [ { "id": "workflow", "name": "workflow", } ] },

RAW_BUFFERClick to expand / collapse

Bug type

Behavior bug (incorrect output/state without crash)

Beta release blocker

No

Summary

I am trying to add image generation to my agent by using local comfyUI installation. I followed the documentation here: https://docs.openclaw.ai/providers/comfy#configuration

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

but when I do this and check with suggested command , it first asks for a "models" array under comfy . I don't know what to write there. But I wrote "workflow" as a model name. Then it says:

  • models.providers.comfy: Unrecognized key: "image"
  • models.providers.comfy: Unrecognized key: "mode"

so , either the documentation ids wrong or there is a bug.

here's what I already tried: "models": { "mode": "merge", "providers": { "comfy": { "baseUrl": "http://127.0.0.1:8188", "image": { workflowPath: "./workflows/image.json", promptNodeId: "6", outputNodeId: "9", }, "models": [ { "id": "workflow", "name": "workflow", } ] },

Steps to reproduce

follow the documentation to add comfy provider.

Expected behavior

see comfy provider added

Actual behavior

config is not accepted

OpenClaw version

v2026.4.21

Operating system

macos 26.4

Install method

npm

Model

comfy

Provider / routing chain

comfy

Additional provider/model setup details

No response

Logs, screenshots, and evidence

Impact and severity

No response

Additional information

No response

extent analysis

TL;DR

  • Verify the configuration keys and values against the Comfy UI provider documentation to ensure accuracy and correct any unrecognized keys.

Guidance

  • Check the Comfy UI provider documentation for the correct configuration structure, focusing on the "models" array and the "comfy" provider settings.
  • Ensure that the "image" key is a recognized configuration option for the Comfy UI provider in the OpenClaw version being used (v2026.4.21).
  • Review the example configuration provided in the issue and compare it with the documentation to identify any discrepancies.
  • Attempt to remove or correct the unrecognized keys ("image" and "mode") to see if the configuration is accepted.

Example

  • No code snippet is provided as the issue is related to configuration and documentation accuracy.

Notes

  • The issue may be due to outdated or incorrect documentation, or a bug in the OpenClaw version being used.
  • Further investigation is needed to determine the root cause of the unrecognized keys.

Recommendation

  • Apply workaround: Try removing the unrecognized keys and reconfiguring the Comfy UI provider settings to match the expected configuration structure, as this may allow the configuration to be accepted and the issue to be mitigated.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

FAQ

Expected behavior

see comfy provider added

#api#installation#memory leak#API versioning#request timeout

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING

openclaw - 💡(How to fix) Fix [Bug]: comfy provider setup does not work as described in the documentation [1 participants]