ComfyUI Skills for OpenClaw

Skills de flujo de trabajo ComfyUI amigables con agentes para OpenClaw, Hermes Agent, Codex, Claude Code y otros agentes.

Este proyecto convierte los flujos de trabajo de ComfyUI en skills invocables, con una CLI amigable para agentes como interfaz principal y una Web UI visual para facilitar la configuración y las pruebas.

🎬 Video de demostración · 📘 Documentación · 🧭 Inicio rápido · ⌨️ CLI · 🖥️ Web UI · 🛰️ Multi-servidor

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

Este documento fue traducido automáticamente. Las contribuciones para mejorar la traducción son bienvenidas.

Descripción general

ComfyUI Skills for OpenClaw es un puente amigable para agentes que convierte flujos de trabajo de ComfyUI en skills invocables por agentes.

En lugar de hacer que un agente manipule grafos crudos de ComfyUI, este proyecto proporciona a cada flujo de trabajo una interfaz limpia y controlada a través de una CLI y un mapeo de parámetros basado en esquemas. Funciona con OpenClaw, Hermes Agent, Codex, Claude Code y otros agentes que pueden ejecutar comandos de shell. Compatible con el estándar abierto agentskills.io.

Úsalo cuando quieras importar flujos de trabajo existentes de ComfyUI, exponer solo los parámetros importantes, ejecutarlos desde el chat o tareas de agentes, y gestionar todo a través de una capa de flujo de trabajo consistente.

Características

Inicio rápido

Pon en marcha ComfyUI Skills en unos minutos.

Antes de comenzar, asegúrate de tener:

• Python 3.10+
• Un servidor ComfyUI en ejecución
• Un flujo de trabajo exportado en formato API de ComfyUI si deseas probar la ejecución de inmediato

1. Clonar el proyecto

Elige el directorio que corresponda a tu entorno de agente.

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. Crear la configuración local

cp config.example.json config.json

3. Instalar la CLI

pipx install comfyui-skill-cli

O:

pip install comfyui-skill-cli

Si ya tienes la CLI instalada, actualízala con:

# Si la instalaste con pipx
pipx upgrade comfyui-skill-cli

# Si la instalaste con pip
python3 -m pip install -U comfyui-skill-cli

4. Verificar la configuración

comfyui-skill server status
comfyui-skill list

5. Importar y ejecutar tu primer flujo de trabajo

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

Para importaciones manuales por CLI, se recomienda pasar la ruta absoluta del JSON del flujo de trabajo. Esto evita ambigüedades de ruta y mantiene el modelo de almacenamiento simple.

Por ejemplo:

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

Después de la importación, la CLI almacena el flujo de trabajo normalizado y el esquema en data/<server_id>/<workflow_id>/, por ejemplo data/local/my-workflow/workflow.json y data/local/my-workflow/schema.json.

Este es también el layout formal usado por la Web UI y por las importaciones de Agent/OpenClaw:

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

En este punto, la CLI leerá tu config.json local, descubrirá los flujos de trabajo disponibles y los ejecutará a través de tu servidor ComfyUI.

Si prefieres un flujo de configuración y pruebas visual, consulta la sección Web UI a continuación.

Opciones de configuración

Elige la ruta que corresponda a cómo deseas usar el proyecto.

OpenClaw

Usa esta ruta si deseas que OpenClaw descubra y ejecute flujos de trabajo ComfyUI como skills.

• Clona el repositorio en ~/.openclaw/workspace/skills
• Instala comfyui-skill-cli
• Configura config.json
• Importa flujos de trabajo y expone parámetros seguros para el agente

Codex o Claude Code

Usa esta ruta si deseas que agentes de codificación llamen flujos de trabajo ComfyUI mediante comandos de shell.

• Clona el repositorio en el directorio de skills de tu agente
• Instala la CLI
• Verifica con comfyui-skill list
• Ejecuta flujos de trabajo con --args estructurados

Web UI

Usa esta ruta si deseas una interfaz visual para configuración, inspección y pruebas. Consulta la sección Web UI a continuación para instrucciones de lanzamiento y detalles.

Configuración manual

Usa esta ruta si deseas control directo sobre config.json, workflow.json y 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  # Exportación en formato API de ComfyUI
  schema.json    # Mapeo de parámetros

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

Comandos comunes

Además de los comandos mostrados en Inicio rápido, estas son operaciones adicionales que podrías necesitar:

Inspeccionar un flujo de trabajo

comfyui-skill info local/txt2img

Enviar un flujo de trabajo de forma asíncrona

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

Gestionar servidores

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

Para la referencia completa de la CLI, ejecuta comfyui-skill --help o consulta ComfyUI Skill CLI.

Requisitos de flujos de trabajo

Para funcionar de manera confiable con este proyecto, cada flujo de trabajo debe cumplir estos requisitos.

• El flujo de trabajo debe exportarse desde ComfyUI en formato API.
• El flujo de trabajo debe incluir un nodo de salida como Save Image.
• El flujo de trabajo necesita un mapeo schema.json para que el agente pueda trabajar con una interfaz de parámetros limpia.
• El servidor ComfyUI de destino debe tener instalados los nodos personalizados y modelos requeridos.

Si usas comfyui-skill workflow import, la CLI puede ayudar a generar el mapeo necesario y verificar dependencias antes de la ejecución.

Gestión multi-servidor

Este proyecto está diseñado para funcionar con más de un servidor ComfyUI.

Puedes mantener múltiples instancias locales o remotas de ComfyUI bajo una configuración y enrutar flujos de trabajo por namespace. Esto es útil cuando diferentes máquinas sirven para diferentes propósitos, como pruebas locales ligeras, trabajos con GPU grandes o entornos específicos de modelos.

Ejemplos:

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

Los flujos de trabajo se direccionan con el formato:

<server_id>/<workflow_id>

Por ejemplo:

local/txt2img
remote-a100/sdxl-base

Tanto servidores como flujos de trabajo admiten interruptores de activación y desactivación, para que los agentes solo vean los flujos de trabajo actualmente disponibles.

También puedes mover configuraciones entre máquinas con:

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

Web UI

Una interfaz web local está disponible para configuración y pruebas visuales. Es opcional y existe para facilitar la configuración, inspección y validación. El skill en sí está diseñado para que los agentes lo usen a través de la CLI.

Lanzamiento

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

Los scripts de lanzamiento crean un .venv del proyecto cuando es necesario e instalan las dependencias de la UI en ese entorno virtual. No se requiere instalación global de dependencias de la Web UI.

Visita http://localhost:18189.

Lo que puedes hacer en la Web UI

• Subir flujos de trabajo exportados desde ComfyUI
• Configurar mapeos de parámetros con un editor visual
• Gestionar múltiples servidores y flujos de trabajo en un solo lugar
• Buscar, reordenar e inspeccionar definiciones de flujos de trabajo
• Probar y validar la configuración de flujos de trabajo antes de pasarlos a los agentes
• Usar la interfaz en English, 简体中文 o 繁體中文

Todo lo que la Web UI configura se mapea al mismo flujo de trabajo CLI subyacente. Es un compañero visual para la configuración y las pruebas, no un modelo de ejecución separado.

El código fuente del frontend está en un repositorio separado.

Problemas comunes

HTTP 400 en /prompt

El payload del flujo de trabajo o uno de los valores de parámetros inyectados es inválido.

Verifica:

• Si el flujo de trabajo fue exportado en formato API
• Si el mapeo del esquema apunta al nodo y campo correctos
• Si los tipos de argumentos proporcionados coinciden con el esquema

No se devuelven imágenes

El flujo de trabajo puede estar faltando un nodo de salida válido como Save Image.

Fallo de conexión

Verifica que:

• El servidor ComfyUI está en ejecución
• La URL del servidor en config.json es correcta
• El servidor seleccionado está habilitado

Nodos o modelos faltantes

Ejecuta:

comfyui-skill deps check <workflow_id>

Luego instala las dependencias soportadas si es necesario.

Registro de cambios

Destacados recientes:

• v0.4.0: Migración a arquitectura CLI-first — todas las operaciones de flujo de trabajo (run, submit, status, import, deps) ahora pasan por una herramienta CLI independiente; los scripts legacy de Python han sido eliminados.
• v0.3.1: Soporte de API Key de ComfyUI para nodos de API en la nube como Kling, Sora y Nano Banana.
• v0.3.0: Verificación e instalación de dependencias, submit y status no bloqueantes, carga de imágenes, previsualización de importación e historial de ejecución.

Consulta CHANGELOG.md para el historial completo de versiones.

Contribuir

¡Las contribuciones son bienvenidas! Por favor lee CONTRIBUTING.md antes de enviar un PR.

Recursos

• English README
• 简体中文 README
• 繁體中文 README
• 日本語 README
• 한국어 README
• Español README
• ComfyUI Skill CLI
• Frontend Repository
• Hermes Agent — plataforma de agentes AI compatible
• agentskills.io — estándar abierto de formato de habilidades