Automatice la creación de interfaces de línea de comandos a partir de especificaciones OpenAPI y Swagger para simplificar las interacciones de los agentes de IA.
Instalar y Descargar
1. ClawHub CLI
La forma más rápida de instalar una habilidad directamente desde el registro.
npx clawhub@latest install openapi2cli
2. Instalación manual
Copia la carpeta de la habilidad a una de estas ubicaciones
~/.openclaw/skills/ <project>/skills/ Prioridad: Espacio de trabajo > Local > Integrado
3. Instalación del prompt
Copia este prompt en OpenClaw para instalarlo automáticamente.
Ayúdame a instalar openapi2cli usando Clawhub. Si Clawhub no está instalado, instálalo primero (npm i -g clawhub).
¿Prefieres descargar?
Obtén los archivos originales de la habilidad en un archivo ZIP.
¿Qué es openapi2cli?
openapi2cli es una utilidad especializada diseñada para cerrar la brecha entre las API web complejas y la accesibilidad de la línea de comandos. Al consumir especificaciones OpenAPI 3.x, genera un CLI nativo de Python que abstrae las complejidades de los comandos curl y la construcción manual de cargas útiles JSON. Este enfoque es altamente efectivo para los desarrolladores que integran nuevas capacidades en sus Openclaw Skills.
Las herramientas generadas están optimizadas tanto para el uso humano como para el consumo de agentes de IA, ofreciendo salidas JSON estructuradas y jerarquías de comandos detectables. Ya sea que trabaje con archivos locales o URL remotas, esta herramienta garantiza que su flujo de trabajo de desarrollo siga siendo ágil y eficiente.
Casos de uso de openapi2cli
- Convertir una API REST compleja en un CLI ejecutable para que lo use un agente de IA.
- Prototipado rápido de interacciones de API sin escribir código de red redundante.
- Integración de documentación de servicios externos en Openclaw Skills para la ejecución automatizada de tareas.
- Prueba de endpoints de API con modos dry-run antes de la implementación en producción.
Cómo funciona openapi2cli
- El usuario proporciona una URL de especificación OpenAPI 3.x o una ruta de archivo local al generador.
- openapi2cli analiza la especificación, identificando endpoints, métodos, parámetros y requisitos de autenticación.
- Se genera un script de Python portátil, mapeando cada ruta de API a un verbo de línea de comandos específico.
- El CLI resultante se puede invocar con variables de entorno o flags para la autenticación.
- Los agentes de IA interactúan con el CLI para realizar operaciones GET, POST u otras operaciones HTTP con respuestas estructuradas.
Configuración de openapi2cli
Primero, asegúrese de tener uv instalado para ejecutar el generador:
# Instalar el gestor de paquetes uv
pip install uv
Genere su primer CLI desde una especificación para mejorar sus Openclaw Skills:
# Generar CLI desde una URL remota
uvx openapi2cli generate https://api.example.com/openapi.json --output mi-api-cli
# Usar el script generado
python mi-api-cli.py --help
Esquema de datos y taxonomía de openapi2cli
El CLI generado mantiene una estructura clara para garantizar la compatibilidad dentro del ecosistema de Openclaw Skills:
| Componente | Descripción |
|---|---|
| Script CLI | Un archivo Python independiente que representa la superficie de la API. |
| Estructura de comandos | Sigue la sintaxis python |
| Manejo de autenticación | Soporta API_KEY, BEARER_TOKEN y BASIC_AUTH a través de variables de entorno. |
| Formato de salida | Respuestas JSON predeterminadas para facilitar el redireccionamiento y análisis. |
Funciones avanzadas de openapi2cli
- Soporte para especificaciones OpenAPI 3.x en formatos JSON y YAML.
- Modo dry-run integrado para inspeccionar estructuras de solicitudes sin ejecutarlas.
- Generación automática de documentación de ayuda para cada comando y parámetro para ayudar al descubrimiento.
- Integración perfecta con secretos basados en el entorno para el despliegue seguro de Openclaw Skills.
- Capacidad para anular las URL base dinámicamente durante la generación para diferentes entornos.
SKILL.md
Cargando
Habilidades relacionadas de Openclaw
Búsqueda de Vuelos
Una herramienta de línea de comandos para obtener precios, horarios y datos de aerolíneas de Google Flights en tiempo real sin necesidad de una clave API.
Búsqueda en Airbnb
Una potente utilidad CLI para buscar listados de Airbnb, comparar precios y recuperar enlaces de reserva directa sin necesidad de una clave API privada.
Agent Chat
Una herramienta ligera para crear salas de chat temporales y seguras para una interacción fluida entre agentes de IA y usuarios humanos.
Señal de Trading
Una herramienta avanzada de monitoreo on-chain que recupera señales de compra y venta de Smart Money en tiempo real para tokens en BSC y Solana.
Secret Portal
Una interfaz web segura de un solo uso para introducir variables de entorno y claves API sin exponerlas a registros o al historial del chat.
Sprite Animator
Transforma imágenes estáticas en GIFs animados de pixel art de 16 fotogramas utilizando la IA de Gemini y un proceso de generación de hojas de sprites en una sola solicitud.
Presentado*
