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.
| Ideal para | Lo que obtienes |
|---|
| Usuarios de OpenClaw, Hermes Agent, Codex y Claude Code | Una capa de flujo de trabajo ComfyUI que los agentes pueden llamar de forma segura |
| Propietarios de flujos de trabajo ComfyUI existentes | Una forma limpia de reutilizar flujos de trabajo exportados sin exponer el grafo completo |
| Configuraciones multi-máquina | Un namespace unificado para servidores ComfyUI locales y remotos |
| Usuarios que desean configuración y pruebas visuales | Una Web UI opcional para configurar, previsualizar y validar flujos de trabajo antes de que los agentes los usen |
Características
| Capacidad | Por qué importa |
|---|
| CLI amigable para agentes | Diseñada para agentes, no solo para humanos. Proporciona una interfaz más limpia y confiable que trabajar directamente con grafos crudos de ComfyUI o patrones de interacción de nivel inferior. |
| Mapeo de parámetros basado en esquemas | Expone solo los campos que deseas que el agente controle, con alias, tipos y descripciones claras. |
| Importación de flujos de trabajo ComfyUI | Importa archivos JSON de flujos de trabajo, detecta formatos automáticamente y genera la capa de mapeo necesaria para el uso del agente. |
| Enrutamiento multi-servidor | Gestiona servidores ComfyUI locales y remotos bajo un namespace y enruta trabajos a la máquina correcta. |
| Gestión de dependencias | Verifica nodos y modelos faltantes antes de la ejecución e instala dependencias soportadas a través de la CLI. |
| Web UI opcional | Una capa visual para configuración y pruebas. No reemplaza la CLI; las acciones orientadas al agente siguen mapeándose al mismo flujo de trabajo CLI. |
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.
Para OpenClaw
cd ~/.openclaw/workspace/skills
git clone https://github.com/HuangYuChuh/ComfyUI_Skills_OpenClaw.git comfyui-skill-openclaw
cd comfyui-skill-openclaw
Para Claude Code
cd ~/.claude/skills
git clone https://github.com/HuangYuChuh/ComfyUI_Skills_OpenClaw.git comfyui-skill
cd comfyui-skill
Para Codex
cd ~/.codex/skills
git clone https://github.com/HuangYuChuh/ComfyUI_Skills_OpenClaw.git comfyui-skill
cd comfyui-skill
Para 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. 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.
Expandir para configuración manual de archivos
1) Editar config.json
{
"servers": [
{
"id": "local",
"name": "Local",
"url": "http://127.0.0.1:8188",
"enabled": true,
"output_dir": "./outputs"
}
],
"default_server": "local"
}
2) Colocar archivos de flujo de trabajo
data/local/my-workflow/
workflow.json # Exportación en formato API de ComfyUI
schema.json # Mapeo de parámetros
3) Escribir schema.json
{
"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
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
