openclaw-comfyui-api-runner（OpenClaw comfyui API runner 文档）

ComfyUI Safe Connector

Small safe runner for ComfyUI.

What it does

• Connects to a remembered server profile or ad-hoc connection settings
• Accepts a workflow as a pasted JSON string, uploaded file, stdin, or built-in template
• Submits the workflow to ComfyUI
• Polls until done and downloads all output images
• Saves images under generated/
• Returns downloaded file paths and browser view URLs for each output

Workflow keywords

Saved workflows can include keywords in their .meta.json. Use the keyword, not the prompt, to pick the right template.

Examples:

• IL-Ikastrious → anime, cartoon, illustration, ikastrious
• use for anime/cartoon image requests

Main command

Run from the skill root:

./comfy.sh --health
./comfy.sh --list-profiles
./comfy.sh --save-profile home --base-url http://127.0.0.1 --port 8188
./comfy.sh --gen --workflow-file /path/to/workflow.json
./comfy.sh --gen --workflow-stdin < workflow.json
./comfy.sh --gen --workflow-json '{...json...}'
./comfy.sh --poll <prompt_id>
./comfy.sh --watch <prompt_id>

comfy.sh is the supported entrypoint (instead of calling the Python runner directly).

Server profiles

Profiles live in:

~/.config/openclaw/comfyui-runner.json

Supported fields:

• servers (list of server entries)
• base_url
• port
• api_key
• username
• password
• default_server
• default_workflow

Use:

• --profile NAME to use one for this run
• --save-profile NAME to remember the current connection
• --set-profile NAME to make a saved profile active
• --set-default-server NAME to set the default server
• --set-default-workflow NAME to set the default workflow
• --delete-profile NAME to remove one

Env vars override saved profiles:

• COMFYUI_PROFILE
• COMFYUI_BASE_URL
• COMFYUI_PORT
• COMFYUI_API_KEY
• COMFYUI_USERNAME
• COMFYUI_PASSWORD

Workflow input

Preferred for this skill:

• --workflow-file for uploaded JSON files
• --workflow-stdin for pasted JSON
• --workflow-json for direct JSON strings

Built-in templates still work via the positional template id, but raw JSON is the default safe path. If a keyword matches exactly one saved workflow, you can pass the keyword instead of the template id.

Output

• poll / watch write downloaded files to generated/
• return JSON includes view_url, local_path, and outputs[]
• image files can be sent directly into Discord or another channel if you want delivery there
• server profiles are remembered in ~/.config/openclaw/comfyui-runner.json

Safety

• No shell interpolation of workflow contents
• JSON is parsed, not executed
• API key support is optional
• Use only trusted ComfyUI servers