comfyui-skills-openclaw

Use this project to turn ComfyUI workflows into callable skills with an agent-friendly CLI as the primary interface, plus a visual Web UI for easier configuration and testing.

🎬 Demo Video · 📘 Docs · 🧭 Quick Start · ⌨️ CLI · 🖥️ Web UI · 🛰️ Multi-Server

English · 简体中文 · 繁體中文 · 日本語 · 한국어 · Español

---

Overview

ComfyUI Skills for OpenClaw is an agent-friendly bridge that turns ComfyUI workflows into callable skills for AI agents.

Instead of asking an agent to manipulate raw ComfyUI graphs, this project gives each workflow a clean, controlled interface through a CLI and schema-based parameter mapping. It works with OpenClaw, Hermes Agent, Codex, Claude Code, and any agent that can run shell commands. Compatible with the agentskills.io open standard.

Use it when you want to import existing ComfyUI workflows, expose only the parameters that matter, run them from chat or agent tasks, and manage everything through one consistent workflow layer.

Best for	What you get
OpenClaw, Codex, Claude Code, and Hermes Agent users	A ComfyUI workflow layer that agents can call safely
Existing ComfyUI workflow owners	A clean way to reuse exported workflows without exposing the full graph
Multi-machine setups	One namespace for local and remote ComfyUI servers
Users who want visual setup and testing	An optional Web UI for configuring, previewing, and validating workflows before agents use them

Features

Capability	Why it matters
Agent-friendly CLI	Designed for agents, not just humans. It provides a cleaner and more reliable interface than working directly with raw ComfyUI graphs or lower-level ComfyUI interaction patterns.
Schema-based parameter mapping	Expose only the fields you want the agent to control, with clear aliases, types, and descriptions.
ComfyUI workflow import	Import workflow JSON files, auto-detect formats, and generate the mapping layer needed for agent use.
Multi-server routing	Manage local and remote ComfyUI servers under one namespace and route jobs to the right machine.
Dependency management	Check missing nodes and models before execution and install supported dependencies through the CLI.
Official local Comfy MCP	Use the official runtime interface for live template, node, and model discovery, raw-workflow validation, and advanced orchestration while keeping CLI execution fast.
Optional Web UI	A visual layer for configuration and testing. It does not replace the CLI, and agent-facing actions still map to the same CLI workflow.

CLI And Official Local Comfy MCP

This Skill treats CLI and MCP as two tools for different jobs, not as replacements for each other:

• Use comfyui-skill for registered workflows, repeated execution, batch jobs, uploads, and history.
• Use the official local Comfy MCP when the Agent needs to discover current templates, nodes, or models, validate a raw workflow, adapt a template, or manage the local ComfyUI lifecycle.

If the Agent host already exposes the official MCP tools, the Skill calls them directly. A shell-only host can use the included bridge:

python ./scripts/comfy_mcp.py probe
python ./scripts/comfy_mcp.py call search_templates --arguments '{"query":"upscale"}'

See Official Local Comfy MCP Integration for setup, routing, and safety boundaries.

Quick Start

Get ComfyUI Skills running in a few minutes.

Before you start, make sure you have:

• Python 3.10+
• A running ComfyUI server
• An exported workflow in ComfyUI API format if you want to test execution right away

1. Clone the project

Choose the directory that matches your agent environment.

For OpenClaw

cd ~/.openclaw/workspace/skills
git clone https://github.com/HuangYuChuh/ComfyUI_Skills_OpenClaw.git comfyui-skill-openclaw
cd comfyui-skill-openclaw

For Claude Code

cd ~/.claude/skills
git clone https://github.com/HuangYuChuh/ComfyUI_Skills_OpenClaw.git comfyui-skill
cd comfyui-skill

For Codex

cd ~/.codex/skills
git clone https://github.com/HuangYuChuh/ComfyUI_Skills_OpenClaw.git comfyui-skill
cd comfyui-skill

For Hermes Agent

cd ~/.hermes/skills/creative
git clone https://github.com/HuangYuChuh/ComfyUI_Skills_OpenClaw.git comfyui-skill-openclaw
cd comfyui-skill-openclaw

Or install via Hermes CLI (once the PR is merged):

hermes skills install comfyui-skill-openclaw

2. Create your local config

cp config.example.json config.json

3. Install the CLI

pipx install comfyui-skill-cli

Or:

pip install comfyui-skill-cli

If you already have the CLI installed, upgrade it with:

# If you installed it with pipx
pipx upgrade comfyui-skill-cli

# If you installed it with pip
python3 -m pip install -U comfyui-skill-cli

4. Verify the setup

comfyui-skill server status
comfyui-skill list

5. Import and run your first workflow

comfyui-skill workflow import /absolute/path/to/my-workflow.json
comfyui-skill deps check local/my-workflow
comfyui-skill run local/my-workflow --args '{"prompt": "a white cat"}'

For manual CLI imports, the recommended approach is to pass the workflow JSON as an absolute path. That avoids path ambiguity and keeps the storage model simple.

For example:

comfyui-skill workflow import /Users/yourname/Downloads/my-workflow.json

After import, the CLI stores the normalized workflow and schema under data/<server_id>/<workflow_id>/, for example data/local/my-workflow/workflow.json and data/local/my-workflow/schema.json.

This is also the formal layout used by the Web UI and by Agent/OpenClaw-driven imports:

data/<server_id>/<workflow_id>/
  workflow.json
  schema.json
  history/

At this point, the CLI will read your local config.json, discover available workflows, and execute them through your ComfyUI server.

If you prefer a visual setup and testing flow, see the Web UI section below.

Setup Options

Choose the path that matches how you want to use the project.

OpenClaw

Use this path if you want OpenClaw to discover and execute ComfyUI workflows as skills.

• Clone the repository into ~/.openclaw/workspace/skills
• Install comfyui-skill-cli
• Configure config.json
• Import workflows and expose agent-safe parameters

Codex or Claude Code

Use this path if you want coding agents to call ComfyUI workflows through shell commands.

• Clone the repository into your agent skills directory
• Install the CLI
• Verify with comfyui-skill list
• Execute workflows with structured --args

Web UI

Use this path if you want a visual interface for configuration, inspection, and testing. See the Web UI section below for launch instructions and details.

Manual Setup

Use this path if you want direct control over config.json, workflow.json, and schema.json.

Expand for manual config file setup

1) Edit config.json

{
  "servers": [
    {
      "id": "local",
      "name": "Local",
      "url": "http://127.0.0.1:8188",
      "enabled": true,
      "output_dir": "./outputs"
    }
  ],
  "default_server": "local"
}

2) Place workflow files

data/local/my-workflow/
  workflow.json  # ComfyUI API-format export
  schema.json    # Parameter mapping

3) Write schema.json

{
  "description": "My workflow",
  "enabled": true,
  "parameters": {
    "prompt": {
      "node_id": 10,
      "field": "prompt",
      "required": true,
      "type": "string",
      "description": "Prompt text"
    }
  }
}

Common Commands

Beyond the commands shown in Quick Start, here are additional operations you may need:

Inspect a workflow

comfyui-skill info local/txt2img

Submit a workflow asynchronously

comfyui-skill submit local/txt2img --args '{"prompt": "a white cat"}'
comfyui-skill status <prompt_id>

Manage servers

comfyui-skill server list
comfyui-skill server add --id remote --url http://10.0.0.1:8188

For the full CLI reference, run comfyui-skill --help or see ComfyUI Skill CLI.

Workflow Requirements

To work reliably with this project, each workflow should meet these requirements.

• The workflow must be exported from ComfyUI in API format.