ComfyUI Skills for OpenClaw

# ComfyUI Skills for OpenClaw  <p> <a href="./README.zh.md"> <img src="https://img.shields.io/badge/简体中文-README.zh.md-blue?style=flat-square" alt="简体中文" /> </a> </p> **[▶ Demo Video (Bilibili)](https://www.bilibili.com/video/BV1a6cUzVEE6/)** 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](./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](https://github.com/HuangYuChuh/ComfyUI_Skills_OpenClaw-frontend); 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](./docs/comfyui-native-routes.md). --- ## Installation <details> <summary><strong>ComfyUI Skills for OpenClaw</strong></summary> Manual install: ```bash 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: ```text 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. ``` </details> <details> <summary><strong>ComfyUI Skills for Claude Code</strong></summary> Manual install: ```bash 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: ```text 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. ``` </details> <details> <summary><strong>ComfyUI Skills for Codex</strong></summary> Manual install: ```bash 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: ```text 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. ``` </details> ## Updating To update the skill, pull the repository and restart the UI or your agent runtime: ```bash 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: `