HuangYuChuh/ComfyUI_Skills_OpenClaw

OpenClaw, Hermes Agent, Codex, Claude Code 및 기타 에이전트를 위한 에이전트 친화적 ComfyUI 워크플로우 기술(workflow skills).

이 프로젝트를 사용하여 ComfyUI 워크플로우를 에이전트 친화적인 CLI(Command Line Interface)를 기본 인터페이스로 하는 호출 가능한 기술(callable skills)로 변환하고, 더 쉬운 설정 및 테스트를 위한 시각적 Web UI를 활용하세요.

🎬 데모 비디오 · 📘 문서 · 🧭 빠른 시작 · ⌨️ CLI · 🖥️ Web UI · 🛰️ 멀티 서버

ComfyUI Skills for OpenClaw는 ComfyUI 워크플로우를 AI 에이전트를 위한 호출 가능한 기술로 변환하는 에이전트 친화적인 브리지(bridge)입니다.

에이전트에게 가공되지 않은 ComfyUI 그래프를 조작하도록 요청하는 대신, 이 프로젝트는 CLI와 스키마 기반의 파라미터 매핑(parameter mapping)을 통해 각 워크플로우에 깨끗하고 제어된 인터페이스를 제공합니다. 이는 OpenClaw, Hermes Agent, Codex, Claude Code 및 셸 명령(shell commands)을 실행할 수 있는 모든 에이전트와 함께 작동합니다. agentskills.io 오픈 표준과 호환됩니다.

기존 ComfyUI 워크플로우를 가져오고, 중요한 파라미터만 노출하며, 채팅이나 에이전트 작업에서 이를 실행하고, 하나의 일관된 워크플로우 레이어를 통해 모든 것을 관리하고 싶을 때 이 프로젝트를 사용하세요.

적합한 대상	얻을 수 있는 것
OpenClaw, Codex, Claude Code, Hermes Agent 사용자	에이전트가 안전하게 호출할 수 있는 ComfyUI 워크플로우 (Workflow) 레이어
...
기능	중요성
---	---
에이전트 친화적 CLI (Command Line Interface)	단순히 인간이 아닌 에이전트를 위해 설계되었습니다. 가공되지 않은 ComfyUI 그래프나 하위 수준의 ComfyUI 상호작용 패턴을 직접 다루는 것보다 더 깔끔하고 신뢰할 수 있는 인터페이스를 제공합니다.
스키마 기반 파라미터 매핑 (Schema-based parameter mapping)	명확한 별칭(Alias), 타입(Type), 설명을 통해 에이전트가 제어하기를 원하는 필드만 노출합니다.
ComfyUI 워크플로우 가져오기 (Import)	워크플로우 JSON 파일을 가져오고, 형식을 자동 감지하며, 에이전트 사용에 필요한 매핑 레이어를 생성합니다.
멀티 서버 라우팅 (Multi-server routing)	로컬 및 원격 ComfyUI 서버를 하나의 네임스페이스 (Namespace) 아래에서 관리하고 작업을 적절한 머신으로 라우팅합니다.
의존성 관리 (Dependency management)	실행 전에 누락된 노드와 모델을 확인하고, CLI를 통해 지원되는 의존성을 설치합니다.
선택적 Web UI	구성 및 테스트를 위한 시각적 레이어입니다. 이는 CLI를 대체하지 않으며, 에이전트 대상 작업은 여전히 동일한 CLI 워크플로우로 매핑됩니다.

몇 분 안에 ComfyUI Skills를 실행해 보세요.

시작하기 전에 다음 사항이 준비되었는지 확인하세요:

• Python 3.10 이상
• 실행 중인 ComfyUI 서버
• 즉시 실행 테스트를 원하는 경우 ComfyUI API 형식으로 내보낸 (Exported) 워크플로우

에이전트 환경에 맞는 디렉토리를 선택하세요.

OpenClaw의 경우

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

Claude Code의 경우

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

Codex의 경우

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

Hermes Agent의 경우

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

또는 Hermes CLI를 통해 설치할 수 있습니다 (PR이 병합된 후):

hermes skills install comfyui-skill-openclaw

cp config.example.json config.json

pipx install comfyui-skill-cli

또는:

pip install comfyui-skill-cli

이미 CLI가 설치되어 있다면, 다음 명령어로 업그레이드하세요:

# pipx로 설치한 경우
pix upgrade comfyui-skill-cli
# pip로 설치한 경우
...

comfyui-skill server status
comfyui-skill list

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"}'

수동 CLI 임포트(import)의 경우, 워크플로우 JSON을 절대 경로 (absolute path)로 전달하는 방식을 권장합니다. 이렇게 하면 경로의 모호함을 피하고 저장 모델을 단순하게 유지할 수 있습니다.

예시:

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

임포트 후, CLI는 정규화된 워크플로우와 스키마 (schema)를 data/<server_id>/<workflow_id>/ 아래에 저장합니다.

예를 들어 data/local/my-workflow/workflow.json 및 data/local/my-workflow/schema.json과 같이 저장됩니다.

이는 Web UI 및 Agent/OpenClaw 기반 임포트에서 사용하는 공식 레이아웃이기도 합니다:

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

이 시점에서 CLI는 사용자의 로컬 config.json을 읽고, 사용 가능한 워크플로우를 찾아 사용자의 ComfyUI 서버를 통해 실행합니다.

시각적인 설정 및 테스트 흐름을 선호한다면 아래의 Web UI 섹션을 참조하세요.

프로젝트를 사용하고자 하는 방식에 맞는 경로를 선택하세요.

OpenClaw가 ComfyUI 워크플로우를 스킬 (skills)로서 탐색하고 실행하기를 원한다면 이 경로를 사용하세요.

• 저장소를 ~/.openclaw/workspace/skills로 클론 (Clone)
• comfyui-skill-cli 설치
• config.json 설정
• 워크플로우 임포트 및 에이전트 안전 파라미터 (agent-safe parameters) 노출

코딩 에이전트 (coding agents)가 셸 명령 (shell commands)을 통해 ComfyUI 워크플로우를 호출하기를 원한다면 이 경로를 사용하세요.

• 에이전트 스킬 디렉토리에 저장소를 클론 (Clone)

• CLI 설치

• comfyui-skill list로 확인

• 구조화된 --args를 사용하여 워크플로 (Workflows) 실행

설정, 검사 및 테스트를 위한 시각적 인터페이스 (Visual interface)가 필요한 경우 이 경로를 사용하세요. 실행 방법 및 자세한 내용은 아래의 Web UI 섹션을 참조하세요.

config.json, workflow.json, schema.json을 직접 제어하고자 하는 경우 이 경로를 사용하세요.

수동 설정 파일 설정을 위해 확장

{
"servers": [
{
...

data/local/my-workflow/
workflow.json # ComfyUI API 형식 내보내기 (API-format export)
schema.json # 파라미터 매핑 (Parameter mapping)

{
"description": "My workflow",
"enabled": true,
...

Quick Start에 표시된 명령 외에 추가로 필요할 수 있는 작업은 다음과 같습니다:

comfyui-skill info local/txt2img

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

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

전체 CLI 레퍼런스(Reference)를 확인하려면 comfyui-skill --help를 실행하거나 ComfyUI Skill CLI를 참조하세요.

이 프로젝트에서 안정적으로 작동하려면 각 워크플로는 다음 요구 사항을 충족해야 합니다.

• 워크플로는 ComfyUI에서 API 형식으로 내보내기 (Export) 되어야 합니다.
• 워크플로에는 Save Image와 같은 출력 노드 (Output node)가 포함되어야 합니다.
• 에이전트 (Agent)가 깔끔한 파라미터 인터페이스로 작동할 수 있도록 워크플로에 schema.json 매핑이 필요합니다.
• 대상 ComfyUI 서버에는 필요한 커스텀 노드 (Custom nodes)와 모델 (Models)이 설치되어 있어야 합니다.

comfyui-skill workflow import를 사용하면, CLI가 실행 전에 필요한 매핑을 생성하고 의존성 (Dependencies)을 확인하는 데 도움을 줄 수 있습니다.

이 프로젝트는 하나 이상의 ComfyUI 서버와 함께 작동하도록 설계되었습니다.

하나의 설정 아래 여러 개의 로컬 또는 원격 ComfyUI 인스턴스 (Instances)를 유지할 수 있으며, 네임스페이스 (Namespace)별로 워크플로를 라우팅 (Route)할 수 있습니다. 이는 경량 로컬 테스트, 대규모 GPU 작업 또는 모델별 환경과 같이 서로 다른 목적을 가진 머신들이 있을 때 유용합니다.

예시:

comfyui-skill server add --id local --url http://127.0.0.1:8188
comfyui-skill server add --id remote-a100 --url http://10.0.0.20:8188
comfyui-skill server list

워크플로우 (Workflows)는 다음과 같은 형식으로 지정됩니다:

<server_id>/<workflow_id>

예시:

local/txt2img
remote-a100/sdxl-base

서버와 워크플로우 모두 활성화(enable) 및 비활성화(disable) 스위치를 지원하므로, 에이전트 (agents)는 현재 사용 가능한 워크플로우만 볼 수 있습니다.

또한 다음 명령어를 통해 머신 간에 설정을 이동할 수 있습니다:

comfyui-skill config export --output ./backup.json
comfyui-skill config import ./backup.json --dry-run
comfyui-skill config import ./backup.json

시각적 설정 및 테스트를 위한 로컬 웹 인터페이스 (Web interface)를 사용할 수 있습니다. 이는 선택 사항이며, 설정, 검사 및 검증을 더 쉽게 만들기 위해 존재합니다. 스킬 (skill) 자체는 여전히 에이전트가 CLI를 통해 사용하도록 설계되었습니다.

./ui/run_ui.sh # macOS/Linux
# 또는: ui\run_ui.bat # Windows

실행 스크립트는 필요할 때 프로젝트 .venv를 생성하고 해당 가상 환경 (virtual environment)에 UI 종속성 (dependencies)을 설치합니다. 글로벌 Web UI 종속성 설치는 필요하지 않습니다.

http://localhost:18189를 방문하세요.

• ComfyUI에서 내보낸 워크플로우 업로드
• 시각적 에디터 (visual editor)로 파라미터 매핑 (parameter mappings) 구성
• 여러 서버와 워크플로우를 한 곳에서 관리
• 워크플로우 정의 검색, 순서 변경 및 검사
• 에이전트에게 전달하기 전 워크플로우 구성 테스트 및 검증
• 인터페이스를 영어, 중국어 간체 또는 중국어 번체로 사용

Web UI가 구성하는 모든 것은 동일한 기반의 CLI 기반 워크플로우로 매핑됩니다. 이는 별도의 실행 모델이 아니라 설정 및 테스트를 위한 시각적 동반자입니다.

프론트엔드 (Frontend) 소스는 별도의 리포지토리 (repository)에 있습니다.

워크플로우 페이로드 (payload) 또는 주입된 파라미터 값 중 하나가 유효하지 않습니다.

다음 사항을 확인하세요:

• 워크플로우가 API 형식으로 내보내졌는지 여부
• 스키마 매핑 (schema mapping)이 올바른 노드 (node) 및 필드 (field)를 가리키는지 여부
• 제공된 인자 타입 (argument types)이 스키마와 일치하는지 여부

워크플로우에 Save Image와 같은 유효한 출력 노드 (output node)가 없을 수 있습니다.

다음 사항을 확인하십시오:

• ComfyUI 서버가 실행 중인지 여부
• config.json에 기재된 서버 URL이 올바른지 여부
• 선택된 서버가 활성화되어 있는지 여부

다음 명령어를 실행하십시오:

comfyui-skill deps check <workflow_id>

그 후 필요한 경우 지원되는 종속성 (dependencies)을 설치하십시오.

최근 주요 업데이트 사항:

v0.4.0: CLI 우선 아키텍처 (CLI-first architecture)로 마이그레이션되었습니다. 이제 모든 워크플로우 작업 (run, submit, status, import, deps)은 독립형 CLI 도구를 통해 수행되며, 기존의 Python 스크립트는 제거되었습니다.
v0.3.1: Kling, Sora, Nano Banana와 같은 클라우드 API 노드를 위한 ComfyUI API 키 지원이 추가되었습니다.
v0.3.0: 종속성 (dependency) 확인 및 설치, 비차단형 (non-blocking) submit 및 status, 이미지 업로드, 미리보기 가져오기 (import preview), 실행 기록 (execution history) 기능이 추가되었습니다.

전체 릴리스 기록은 CHANGELOG.md를 참조하십시오.

기여를 환영합니다! PR (Pull Request)을 제출하기 전에 CONTRIBUTING.md를 읽어주시기 바랍니다.

• English README
• 简体中文 README
• 繁體中文 README
• 日本語 README
• 한국어 README
• Español README
• ComfyUI Skill CLI
• Frontend Repository
• Hermes Agent — 호환 가능한 AI 에이전트 플랫폼
• agentskills.io — 오픈 스킬 포맷 표준