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:

bash

./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