Skill Coolify para OpenClaw

Descripción General del Skill Coolify de OpenClaw

El skill Coolify conecta OpenClaw con tu instancia de Coolify a través de su API REST. Una vez instalado, tu agente OpenClaw puede desplegar aplicaciones, gestionar bases de datos, configurar variables de entorno y monitorear servicios — todo mediante comandos en lenguaje natural.

Coolify es una alternativa de código abierto y autoalojable a Vercel, Heroku y Netlify. Te permite desplegar sitios estáticos, aplicaciones full-stack, bases de datos y más de 280 servicios con un solo clic en tus propios servidores. Con el skill Coolify de OpenClaw, obtienes la comodidad de las plataformas gestionadas manteniendo el control total sobre tu infraestructura y datos.

Flujo de trabajo típico:

1. Pide a OpenClaw que despliegue tus últimos cambios en el servidor de staging.
2. El agente llama a la API de Coolify para activar un despliegue en tu proyecto vinculado.
3. El estado de la compilación y los logs se devuelven en un resumen legible — sin necesidad de abrir el panel de Coolify.

Requisitos Previos del Skill Coolify

Antes de instalar el skill Coolify, asegúrate de tener:

• OpenClaw instalado y en ejecución (v1.0+)
• Una instancia de Coolify ejecutándose en tu servidor — guía de instalación
• Token de API de Coolify generado desde tu panel de Coolify
• Al menos una aplicación o servicio configurado en Coolify
• clawhub CLI instalado para la gestión de skills

Verifica tu configuración:

# Verificar la versión de OpenClaw
openclaw --version

# Verificar que Coolify es accesible (reemplaza con la URL de tu instancia)
curl -s https://your-coolify-instance.com/api/v1/healthcheck

# Verificar clawhub CLI
clawhub --version

Cómo Instalar el Skill Coolify

Instala el skill Coolify con un solo comando:

npx clawhub@latest install coolify

Para verificar la instalación:

clawhub list

Deberías ver coolify en la lista de skills instalados. El skill te solicitará el endpoint de la API de Coolify y el token en el primer uso.

Configuración del Skill Coolify

El skill Coolify requiere un token de API y la URL de tu instancia. Genera un token desde el panel de Coolify en Settings → API Tokens.

Permisos del Token

Los tokens de API de Coolify proporcionan acceso completo a tu instancia. Sigue el principio de mínimo privilegio:

| Caso de Uso | Recomendación | |-------------|---------------| | Monitoreo de solo lectura | Crea un token en una cuenta de miembro del equipo con rol de visualizador | | Despliegue completo | Usa un token de administrador pero revisa todas las acciones antes de confirmar | | Multi-servidor | Crea tokens separados por servidor para aislamiento |

Configuración del Entorno

# Establecer la URL de tu instancia de Coolify
export COOLIFY_BASE_URL=https://your-coolify-instance.com

# Establecer tu token de API de Coolify
export COOLIFY_TOKEN=your_api_token_here

Importante: Nunca escribas tokens directamente en archivos de configuración. Usa variables de entorno o un gestor de secretos como 1Password o Bitwarden. Mantén tu instancia de Coolify actualizada a la última versión para recibir parches de seguridad.

Verificación de la Conexión

Después de configurar las variables de entorno, verifica la conexión:

# Probar acceso a la API
curl -H "Authorization: Bearer $COOLIFY_TOKEN" \
  "$COOLIFY_BASE_URL/api/v1/teams"

Ejemplos de Uso del Skill Coolify

1. Desplegar una Aplicación

Tú: "Despliega la última versión de mi aplicación web en Coolify."

El agente identifica tu aplicación por nombre, activa un despliegue a través de la API de Coolify y transmite el estado de la compilación. Recibes un resumen con la URL de despliegue y la duración de la compilación.

2. Gestionar Variables de Entorno

Tú: "Agrega DATABASE_URL al entorno de staging de mi servicio API."

El agente llama a la API de Coolify para crear la variable de entorno en tu aplicación especificada. También puedes pedir listar, actualizar o actualizar en lote variables entre entornos. El skill asegura que los valores sensibles se enmascaren en la salida.

3. Ver Logs de la Aplicación

Tú: "Muéstrame las últimas 100 líneas de logs del servicio de pagos."

El agente obtiene los logs del contenedor a través de la API de Coolify y los presenta en un formato legible. También puede resaltar errores y sugerir correcciones basadas en patrones comunes.

4. Reiniciar un Servicio

Tú: "Reinicia la base de datos PostgreSQL en mi servidor de producción."

El agente envía un comando de reinicio al servicio especificado. OpenClaw solicita confirmación antes de ejecutar cualquier operación de reinicio o detención en servicios de producción.

5. Verificar el Uso de Recursos

Tú: "¿Cuánta CPU y memoria está usando mi servidor de staging?"

El agente consulta la API de Coolify para obtener métricas del servidor y presenta un resumen del uso de CPU, memoria y disco. Puede alertarte si algún recurso se está acercando a su límite.

Seguridad y Mejores Prácticas

El skill Coolify puede realizar operaciones de escritura en tus servidores y aplicaciones. Sigue estas directrices para mantenerte seguro:

• Usa el mínimo privilegio. Crea tokens de API dedicados con permisos mínimos. Evita usar tu token principal de administrador para operaciones automatizadas.
• Revisa antes de desplegar en producción. Siempre prueba los despliegues en staging primero. OpenClaw solicita confirmación antes de los despliegues en producción.
• Mantén Coolify actualizado. Actualiza regularmente tu instancia de Coolify para obtener los últimos parches de seguridad — ejecuta la actualización desde el panel de Coolify o usa la guía oficial de actualización.
• Asegura tu instancia. Coloca Coolify detrás de un firewall o VPN. Usa contraseñas seguras y habilita la autenticación de dos factores.
• Rota los tokens de API. Regenera los tokens periódicamente y revoca los no utilizados desde el panel.
• Realiza copias de seguridad regularmente. Usa la función de respaldo S3 integrada de Coolify para proteger tu configuración y datos de bases de datos.

Solución de Errores Comunes

"Connection refused" o "ECONNREFUSED"

El skill no puede conectarse a tu instancia de Coolify.

1. Verifica que COOLIFY_BASE_URL sea correcto e incluya el protocolo (https://).
2. Comprueba que tu instancia de Coolify esté en ejecución: systemctl status coolify en tu servidor.
3. Asegúrate de que tu firewall permita el tráfico en el puerto de Coolify (por defecto: 8000).
4. Si usas una VPN o Tailscale, confirma que el túnel esté activo.

"Unauthorized" o "401 Error"

Tu token de API es inválido o ha expirado.

1. Verifica tu token en Coolify Dashboard → Settings → API Tokens.
2. Regenera el token si fue revocado.
3. Verifica que la variable de entorno COOLIFY_TOKEN esté configurada correctamente.

# Verificar que el token está establecido
echo $COOLIFY_TOKEN

# Probar autenticación
curl -H "Authorization: Bearer $COOLIFY_TOKEN" \
  "$COOLIFY_BASE_URL/api/v1/teams"

"Application not found"

El skill no puede encontrar la aplicación que referenciaste.

1. Lista todas las aplicaciones: pide a OpenClaw "Lista todas mis aplicaciones de Coolify."
2. Verifica que el nombre de la aplicación o UUID coincida con lo que aparece en tu panel de Coolify.
3. Asegúrate de que tu token de API tenga acceso al equipo propietario de la aplicación.