Skill Vercel para OpenClaw
Desplegar y gestionar proyectos en la plataforma Vercel.
Última actualización: 2026-03-06
Instalación Rápida
$ npx clawhub@latest install vercelFunciones Clave
Descripción General del Skill Vercel de OpenClaw
El skill Vercel conecta OpenClaw con la plataforma Vercel a través del CLI oficial de Vercel. Una vez instalado, tu agente OpenClaw puede desplegar aplicaciones, gestionar variables de entorno, configurar dominios e inspeccionar registros de compilación — todo mediante comandos en español simple.
Vercel es la plataforma cloud frontend líder, que impulsa millones de sitios web construidos con Next.js, React, Svelte y otros frameworks modernos. Con el skill Vercel de OpenClaw, eliminas el cambio de contexto entre tu editor, terminal y el panel de Vercel. Simplemente describe lo que necesitas y OpenClaw se encarga del resto.
Flujo de trabajo típico:
- Pide a OpenClaw que despliegue tu proyecto actual en Vercel.
- El agente ejecuta
vercel deployinternamente, gestionando la vinculación del proyecto y la configuración de compilación. - Se devuelve una URL de preview al instante — sin necesidad de abrir el panel de control.
Requisitos Previos del Skill Vercel
Antes de instalar el skill Vercel, asegúrate de tener:
- OpenClaw instalado y en ejecución (v1.0+)
- Vercel CLI instalado — guía de instalación oficial
- Una cuenta de Vercel (el plan gratuito funciona) con al menos un proyecto
- Node.js 18+ (requerido por el Vercel CLI)
- clawhub CLI instalado para la gestión de skills
Verifica tu configuración:
# Verificar la versión de OpenClaw openclaw --version # Verificar la versión del Vercel CLI vercel --version # Verificar la autenticación de Vercel vercel whoami
Cómo Instalar el Skill Vercel
Instala el skill Vercel con un solo comando:
npx clawhub@latest install vercel
Para verificar la instalación:
clawhub list
Deberías ver vercel en la lista de skills instalados. Si aún no has vinculado un proyecto de Vercel, el skill te pedirá que lo hagas en el primer uso.
Configuración del Skill Vercel
El skill Vercel requiere autenticación mediante un Token de Acceso de Vercel o el flujo de inicio de sesión del Vercel CLI. Recomendamos usar vercel login para la configuración más sencilla.
Autenticación Basada en Token
Si prefieres usar un token, crea uno en vercel.com/account/tokens:
| Configuración | Recomendación |
|---------------|---------------|
| Alcance | Cuenta completa o equipo específico |
| Expiración | 90 días (rotar regularmente) |
| Nombre | Usa un nombre descriptivo como openclaw-agent |
Configuración del Entorno
# Opción 1: Usar inicio de sesión del Vercel CLI (recomendado) vercel login # Opción 2: Establecer un Token de Acceso de Vercel export VERCEL_TOKEN=tu_token_de_vercel_aquí # Opcional: Establecer equipo/alcance predeterminado export VERCEL_ORG_ID=team_tu_id_de_equipo export VERCEL_PROJECT_ID=prj_tu_id_de_proyecto
Importante: Nunca escribas tokens directamente en archivos de configuración. Usa variables de entorno o un gestor de secretos como 1Password o Bitwarden.
Vinculación de Proyecto
Antes de desplegar, vincula tu directorio local a un proyecto de Vercel:
vercel link
Esto crea un directorio .vercel con la configuración del proyecto. El skill usa esta vinculación para determinar qué proyecto desplegar.
Ejemplos de Uso del Skill Vercel
1. Desplegar en Preview
Tú: "Despliega el proyecto actual en Vercel como preview."
El agente ejecuta vercel deploy y devuelve la URL de preview. Puedes compartir esta URL con tus compañeros de equipo para revisión antes de promover a producción.
2. Promover a Producción
Tú: "Promueve el último despliegue de preview a producción."
El agente identifica el despliegue de preview más reciente y ejecuta vercel promote, convirtiéndolo en la versión de producción en vivo. OpenClaw confirma la acción antes de proceder.
3. Gestionar Variables de Entorno
Tú: "Agrega una nueva variable de entorno DATABASE_URL para producción con el valor postgres://..."
El agente ejecuta vercel env add DATABASE_URL production y almacena el valor de forma segura. También puedes pedir listar, actualizar o eliminar variables de entorno en los entornos de preview, desarrollo y producción.
4. Inspeccionar Registros de Compilación
Tú: "Muéstrame los registros de compilación del último despliegue fallido."
El agente obtiene los despliegues recientes con vercel ls, identifica el que falló y recupera la salida de compilación con vercel inspect. Luego resume el error y sugiere una solución.
5. Configurar Dominios Personalizados
Tú: "Agrega el dominio app.example.com a mi proyecto de Vercel."
El agente ejecuta vercel domains add app.example.com y proporciona los registros DNS que necesitas configurar en tu registrador. También puede verificar el estado de configuración del dominio.
Seguridad y Mejores Prácticas
El skill Vercel puede realizar operaciones de escritura en tus despliegues y configuraciones de proyecto. Sigue estas pautas para mantenerte seguro:
- Usa el mínimo privilegio. Si trabajas en un equipo, limita los tokens a proyectos específicos en lugar de acceso completo a la cuenta.
- Revisa antes de desplegar a producción. Siempre usa despliegues de preview primero. OpenClaw solicita confirmación antes de las promociones a producción.
- Protege las variables de entorno. Los valores sensibles como URLs de bases de datos y claves API deben establecerse mediante
vercel env— nunca los incluyas en el código fuente. - Rota los tokens regularmente. Establece una expiración de 90 días en tu Token de Acceso de Vercel y rótalo proactivamente.
- Audita los despliegues. Revisa la pestaña Actividad del panel de Vercel periódicamente para verificar los despliegues realizados a través del CLI.
- Usa el alcance de equipo. En configuraciones con múltiples equipos, establece explícitamente
VERCEL_ORG_IDpara evitar desplegar en el equipo incorrecto.
Solución de Errores Comunes
"Error: No Project linked"
No has vinculado tu directorio local a un proyecto de Vercel todavía.
# Vincular a un proyecto existente vercel link # O desplegar y crear un nuevo proyecto vercel deploy
El skill te guiará en la selección del proyecto si existen múltiples proyectos en tu cuenta.
"Error: Invalid token"
Tu Token de Acceso de Vercel falta, ha expirado o fue revocado.
- Verifica tu token en vercel.com/account/tokens.
- Si ha expirado, genera un nuevo token y actualiza tu variable de entorno.
- Alternativamente, vuelve a autenticarte con
vercel login.
# Volver a autenticarse vercel login # O actualizar tu token export VERCEL_TOKEN=tu_nuevo_token_aquí
"Build Failed: Command 'npm run build' exited with 1"
El comando de compilación falló durante el despliegue. Esto suele ser un problema del código, no del skill.
- Ejecuta la compilación localmente primero:
npm run build - Verifica si faltan variables de entorno — el skill puede listarlas con
vercel env ls - Revisa el registro completo de compilación con
vercel inspect <deployment-url> - Asegúrate de que los scripts de tu
package.jsony la configuración del framework coincidan con la configuración de compilación de Vercel
Preguntas Frecuentes
Sí, cuando se configura correctamente. El skill sigue el modelo de confirmación de OpenClaw — los despliegues a producción y las acciones destructivas requieren tu aprobación explícita. Recomendamos comenzar con despliegues de preview y promover a producción solo después de revisarlos. También puedes limitar el alcance de tu token a proyectos específicos para reducir el radio de impacto.
Sí. Establece la variable de entorno `VERCEL_ORG_ID` con el ID de tu equipo, y el skill limitará todas las operaciones a ese equipo. Para cuentas empresariales con múltiples equipos, puedes cambiar entre equipos actualizando esta variable. El skill es compatible con todos los planes de Vercel, incluyendo Hobby, Pro y Enterprise.
El [skill Vercel](/skills/vercel) está diseñado para la plataforma gestionada de Vercel — despliegues sin configuración, funciones edge e infraestructura serverless. El [skill Coolify](/skills/coolify) está orientado a despliegues autoalojados en tus propios servidores. Elige Vercel por conveniencia y red edge global; elige Coolify para control total y sin dependencia de proveedor. Ambos skills se complementan bien con el [skill Docker Essentials](/skills/docker-essentials) para flujos de trabajo basados en contenedores.