ComfyUI Skills for OpenClaw

OpenClaw, Hermes Agent, Codex, Claude Code 및 기타 에이전트를 위한 Agent 친화적 ComfyUI 워크플로우 스킬입니다.

이 프로젝트는 ComfyUI 워크플로우를 호출 가능한 스킬로 변환합니다. Agent 친화적인 CLI를 주 인터페이스로 제공하며, 설정과 테스트를 위한 시각적 Web UI도 함께 제공합니다.

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

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

이 문서는 기계 번역으로 작성되었습니다. 번역 개선 기여를 환영합니다.

개요

ComfyUI Skills for OpenClaw는 ComfyUI 워크플로우를 에이전트가 호출할 수 있는 스킬로 변환하는 Agent 친화적 브릿지입니다.

에이전트가 원시 ComfyUI 그래프를 직접 조작하도록 하는 대신, CLI와 스키마 기반 파라미터 매핑을 통해 각 워크플로우에 깔끔하고 제어 가능한 인터페이스를 제공합니다. 셸 명령을 실행할 수 있는 OpenClaw, Hermes Agent, Codex, Claude Code 및 기타 에이전트와 함께 작동합니다. agentskills.io 오픈 표준 호환.

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

기능

빠른 시작

몇 분 만에 ComfyUI Skills를 실행하세요.

시작하기 전에 다음을 준비하세요:

• Python 3.10+
• 실행 중인 ComfyUI 서버
• 바로 실행을 테스트하려면 ComfyUI API 형식으로 내보낸 워크플로우

1. 프로젝트 클론

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

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

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

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

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

hermes skills install comfyui-skill-openclaw

2. 로컬 설정 생성

cp config.example.json config.json

3. CLI 설치

pipx install comfyui-skill-cli

또는:

pip install comfyui-skill-cli

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

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

# pip로 설치한 경우
python3 -m pip install -U comfyui-skill-cli

4. 설정 확인

comfyui-skill server status
comfyui-skill list

5. 첫 번째 워크플로우 가져오기 및 실행

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 가져오기 시 워크플로우 JSON의 절대 경로를 전달하는 것을 권장합니다. 경로 모호성을 피하고 스토리지 모델을 단순하게 유지할 수 있습니다.

예시:

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

가져오기 후 CLI는 정규화된 워크플로우와 스키마를 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
  history/

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

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

설정 옵션

사용 방식에 맞는 경로를 선택하세요.

OpenClaw

OpenClaw가 ComfyUI 워크플로우를 스킬로 검색하고 실행하도록 하려면 이 경로를 사용하세요.

• 리포지토리를 ~/.openclaw/workspace/skills에 클론
• comfyui-skill-cli 설치
• config.json 설정
• 워크플로우를 가져오고 에이전트가 안전하게 사용할 수 있는 파라미터 노출

Codex 또는 Claude Code

코딩 에이전트가 셸 명령을 통해 ComfyUI 워크플로우를 호출하도록 하려면 이 경로를 사용하세요.

• 리포지토리를 에이전트 스킬 디렉토리에 클론
• CLI 설치
• comfyui-skill list로 확인
• 구조화된 --args로 워크플로우 실행

Web UI

시각적 인터페이스로 설정, 검사, 테스트를 하고 싶다면 이 경로를 사용하세요. 자세한 내용은 아래의 Web UI 섹션을 참조하세요.

수동 설정

config.json, workflow.json, schema.json을 직접 제어하고 싶다면 이 경로를 사용하세요.

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

data/local/my-workflow/
  workflow.json  # ComfyUI API 형식 내보내기
  schema.json    # 파라미터 매핑

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

자주 사용하는 명령어

빠른 시작에서 보여준 명령어 외에 필요할 수 있는 추가 작업입니다:

워크플로우 검사

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 레퍼런스는 comfyui-skill --help를 실행하거나 ComfyUI Skill CLI를 참조하세요.

워크플로우 요구사항

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

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

comfyui-skill workflow import를 사용하면 CLI가 필요한 매핑을 생성하고 실행 전에 의존성을 확인할 수 있습니다.

멀티 서버 관리

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

여러 로컬 또는 원격 ComfyUI 인스턴스를 하나의 설정 아래에 두고 네임스페이스로 워크플로우를 라우팅할 수 있습니다. 경량 로컬 테스트, 대형 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

워크플로우는 다음 형식으로 주소 지정합니다:

<server_id>/<workflow_id>

예시:

local/txt2img
remote-a100/sdxl-base

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

다음 명령으로 머신 간 설정을 이동할 수도 있습니다:

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

Web UI

시각적 설정 및 테스트를 위한 로컬 웹 인터페이스가 제공됩니다. 선택 사항이며, 설정, 검사, 검증을 더 쉽게 하기 위해 존재합니다. 스킬 자체는 에이전트가 CLI를 통해 사용하도록 설계되었습니다.

실행

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

실행 스크립트는 필요 시 프로젝트 .venv를 생성하고 UI 의존성을 해당 가상 환경에 설치합니다. 글로벌 Web UI 의존성 설치는 필요 없습니다.

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

Web UI에서 할 수 있는 것

• ComfyUI에서 내보낸 워크플로우 업로드
• 시각적 편집기로 파라미터 매핑 설정
• 여러 서버와 워크플로우를 한 곳에서 관리
• 워크플로우 정의 검색, 정렬, 검사
• 에이전트에 전달하기 전에 워크플로우 설정 테스트 및 검증
• English, 简体中文, 繁體中文으로 인터페이스 언어 전환

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

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

자주 발생하는 문제

/prompt에서 HTTP 400

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

확인 사항:

• 워크플로우가 API 형식으로 내보내졌는지
• 스키마 매핑이 올바른 노드와 필드를 가리키는지
• 제공된 인수 타입이 스키마와 일치하는지

이미지가 반환되지 않음

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

연결 실패

확인 사항:

• ComfyUI 서버가 실행 중인지
• config.json의 서버 URL이 올바른지
• 선택한 서버가 활성화되어 있는지

누락된 노드 또는 모델

다음을 실행하세요:

comfyui-skill deps check <workflow_id>

그런 다음 필요한 의존성을 설치하세요.

변경 이력

최근 주요 변경사항:

• v0.4.0: CLI 우선 아키텍처로 마이그레이션 — 모든 워크플로우 작업(run, submit, status, import, deps)이 독립 CLI 도구를 통해 수행되며, 레거시 Python 스크립트는 제거되었습니다.
• v0.3.1: Kling, Sora, Nano Banana 등 클라우드 API 노드를 위한 ComfyUI API Key 지원 추가.
• v0.3.0: 의존성 확인 및 설치, 논블로킹 submit과 status, 이미지 업로드, 가져오기 미리보기, 실행 이력 추가.

전체 릴리스 이력은 CHANGELOG.md를 참조하세요.

기여

기여를 환영합니다! PR을 제출하기 전에 CONTRIBUTING.md를 읽어주세요.

관련 자료

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