ComfyUI Skills for OpenClaw

ComfyUI Skills for OpenClaw

▶ Demo Video (Bilibili)

This project is a ComfyUI skill integration layer for OpenClaw, Codex, and Claude Code. It turns the workflows you build and export from ComfyUI in API format into callable skills that these agents can trigger with natural language.

It converts natural language requests into structured skill arguments, maps them to ComfyUI workflow inputs, submits jobs to ComfyUI, waits for completion, then pulls generated images back to local disk.

For the upstream ComfyUI local server routes that back this skill, see docs/comfyui-native-routes.md.

Features

Workflow-to-Skill Conversion

• Turn your ComfyUI workflows into skills that OpenClaw, Codex, or Claude Code can call directly
• Set up parameters in three steps: upload a workflow, pick the nodes to expose, then name and describe each parameter
• Input nodes are detected automatically from the workflow — no need to hunt through the JSON by hand
• When you update a workflow, preview the parameter changes first and carry over existing mappings
• Supports bulk workflow import from a ComfyUI server or local JSON files

Multi-Server Management

• Manage multiple ComfyUI servers and route jobs to different machines as needed
• Servers and workflows each have their own toggle — agents only see a workflow when both are enabled
• Workflows with the same name on different servers stay separate, identified by server/workflow composite IDs
• Set a per-server output directory and choose a default server

Web UI

• Frontend source lives in a separate repository; run scripts/update_frontend.sh to pull the latest build
• Runtime update checks prefer pulling the main repo via git, and fall back to refreshing ui/static/ from the frontend release when git update is unavailable
• A local web interface for managing all servers and workflows in one place
• Reorder workflows by dragging, or sort by name, status, or custom order
• Search and filter workflows across all servers
• Available in English, Simplified Chinese, and Traditional Chinese — switch languages from the UI

Configuration Transfer

• Export your current configuration and workflows into a single portable JSON file
• Choose exactly which workflows to include before exporting
• Preview what will change on the target machine before applying an import
• Control whether to overwrite existing workflows or sync environment settings from the source machine

Workflow Execution

• Submit a job, wait for it to finish, and download the generated images to local storage automatically
• Supports multi-image output in a single run
• Agents can query all available workflows and their parameters from the command line for automated use

CLI Tools

• A full set of command-line tools for headless environments and scripting
• Covers server management, workflow listing, job execution, and configuration import/export

ComfyUI Native API Scope

This repository should be understood as two layers:

• Native ComfyUI server routes on the target generation server, such as /prompt, /history/{prompt_id}, /view, /ws, and /queue
• This project's own manager API under /api/*, used by the local UI to manage saved servers, workflows, and transfer bundles

The current skill implementation is centered on the native execution flow:

1. POST /prompt
2. GET /history/{prompt_id}
3. GET /view

That route-level reference is documented in docs/comfyui-native-routes.md.

---

Installation

Manual install:

cd ~/.openclaw/workspace/skills
git clone https://github.com/HuangYuChuh/ComfyUI_Skills_OpenClaw.git comfyui-skill-openclaw
cd comfyui-skill-openclaw
python3 -m venv .venv
source .venv/bin/activate
python3 -m pip install -r requirements.txt
cp config.example.json config.json

If python3 --version is below 3.10, create the virtual environment with any installed python3.10+ interpreter, for example python3.12 -m venv .venv.

Let OpenClaw install it for you:

Send this prompt to OpenClaw:

Please install this ComfyUI skill into my OpenClaw workspace.

Target path:
~/.openclaw/workspace/skills/comfyui-skill-openclaw/

Requirements:
1. Run `cd ~/.openclaw/workspace/skills` first.
2. Clone this repository into `comfyui-skill-openclaw`.
3. Keep SKILL.md at the project root.
4. Install Python dependencies from requirements.txt.
5. Run `cp config.example.json config.json`.
6. Set the default ComfyUI server URL to http://127.0.0.1:8188 unless I specify another one.
7. Make sure OpenClaw can discover and call this skill after installation.

Manual install:

cd ~/.claude/skills
git clone https://github.com/HuangYuChuh/ComfyUI_Skills_OpenClaw.git comfyui-skill
cd comfyui-skill
python3 -m venv .venv
source .venv/bin/activate
python3 -m pip install -r requirements.txt
cp config.example.json config.json

If python3 --version is below 3.10, create the virtual environment with any installed python3.10+ interpreter, for example python3.12 -m venv .venv.

Let Claude Code install it for you:

Send this prompt to Claude Code:

Please install this ComfyUI skill into my Claude Code skills directory.

Target path:
~/.claude/skills/comfyui-skill/

Requirements:
1. Run `cd ~/.claude/skills` first (create the directory if it doesn't exist).
2. Clone this repository into `comfyui-skill`.
3. Keep SKILL.md at the project root.
4. Install Python dependencies from requirements.txt.
5. Run `cp config.example.json config.json`.
6. Set the default ComfyUI server URL to http://127.0.0.1:8188 unless I specify another one.
7. Make sure Claude Code can discover and call this skill after installation.

Manual install:

cd ~/.codex/skills
git clone https://github.com/HuangYuChuh/ComfyUI_Skills_OpenClaw.git comfyui-skill
cd comfyui-skill
python3 -m venv .venv
source .venv/bin/activate
python3 -m pip install -r requirements.txt
cp config.example.json config.json

If python3 --version is below 3.10, create the virtual environment with any installed python3.10+ interpreter, for example python3.12 -m venv .venv.

Let Codex install it for you:

Send this prompt to Codex:

Please install this ComfyUI skill into my Codex skills directory.

Target path:
~/.codex/skills/comfyui-skill/

Requirements:
1. Run `cd ~/.codex/skills` first (create the directory if it doesn't exist).
2. Clone this repository into `comfyui-skill`.
3. Keep SKILL.md at the project root.
4. Install Python dependencies from requirements.txt.
5. Run `cp config.example.json config.json`.
6. Set the default ComfyUI server URL to http://127.0.0.1:8188 unless I specify another one.
7. Make sure Codex can discover and call this skill after installation.

Updating

To update the skill, pull the repository and restart the UI or your agent runtime:

git pull --ff-only

This updates the backend code, docs, and the bundled frontend files in ui/static/ together.

If you use the update prompt in the Web UI, it follows the same repository-first update flow.

ComfyUI Workflow Setup

Before you start, make sure your ComfyUI server is already running. The default local address is http://127.0.0.1:8188.

UI Setup (Recommended)

• macOS/Linux: ./ui/run_ui.sh, or double-click ui/run_ui.command
• Windows: ui\run_ui.bat
• Visit: `