Desplegando un agente de IA paso a paso — desde el desarrollo local hasta un servicio de producción en funcionamiento. Sin abstracciones, sin “depende de”, solo los comandos y decisiones reales.
Paso 1: Consigue un Servidor
Necesitas un servidor Linux con al menos 2GB de RAM (se recomiendan 4GB), una dirección IP pública y acceso SSH. Un VPS de $10-20/mes de cualquier proveedor importante funciona bien. Yo uso Ubuntu 22.04 LTS porque es estable y está bien documentado.
Después de aprovisionar: actualiza el sistema (apt update && apt upgrade), crea un usuario no root, configura la autenticación por clave SSH y desactiva el acceso de contraseña. Esto toma 10 minutos y es el mínimo para la seguridad.
Paso 2: Instala Dependencias
Node.js (versión LTS), npm y Git. Eso es lo mínimo para OpenClaw. Si estás usando una base de datos, instálala también. Si estás usando Docker, instala Docker.
Instalo Node a través de nvm (Node Version Manager) porque facilita la gestión de versiones. Cuando OpenClaw requiere una nueva versión de Node, nvm install y nvm use lo manejan sin afectar nada más en el servidor.
Paso 3: Clona y Configura
Clona tu repositorio (o instala OpenClaw desde npm). Crea el archivo de configuración con tus claves API, preferencias de modelo y configuraciones de integración.
El archivo de configuración es el artefacto más importante en tu despliegue. Todo lo que hace el agente depende de él. Mantengo una plantilla de configuración en el repositorio con valores de marcador de posición y un archivo .env separado (no en el repositorio) con los secretos reales.
Paso 4: Prueba Localmente en el Servidor
Antes de configurar la gestión de procesos o proxies inversos, ejecuta el agente manualmente: node index.js (o el comando de inicio que sea). Envíale un mensaje de prueba. Verifica que responda correctamente. Esto captura problemas específicos del entorno (dependencias faltantes, rutas incorrectas, APIs inaccesibles) antes de que añadas capas de complejidad.
Si no funciona manualmente, tampoco funcionará detrás de PM2 o Docker. Depura aquí, no más tarde.
Paso 5: Gestión de Procesos
Instala PM2 (npm install -g pm2) y configura el agente como un proceso gestionado: pm2 start ecosystem.config.js.
PM2 te ofrece: reinicio automático en caso de fallo, gestión de registros con rotación, generación de scripts de inicio (para que el agente se inicie al arrancar) y comandos de monitoreo para verificar el estado.
Ejecuta pm2 startup para generar el script de inicio del sistema. Ejecuta pm2 save para guardar la lista actual de procesos. Ahora el agente sobrevive a los reinicios.
Paso 6: Proxy Inverso (Si Es Necesario)
Si el agente necesita recibir webhooks de servicios externos, configura un proxy inverso (Caddy o nginx) que maneje la terminación SSL y dirija el tráfico al agente.
Caddy es más simple: un Caddyfile de 4 líneas te proporciona HTTPS con renovación automática de certificados. Nginx es más configurable pero requiere gestión manual de certificados (usa Certbot).
Si el agente solo realiza conexiones salientes (plataformas de mensajería, llamadas API) y no recibe tráfico entrante, omite este paso.
Paso 7: Monitoreo
Como mínimo: configura el monitoreo de registros y una verificación básica de salud.
Registros: PM2 maneja la rotación de registros. Configura una forma de ver registros de forma remota (yo uso pm2 logs a través de SSH o un simple visor de registros).
Verificación de salud: Un trabajo cron que verifica si el proceso está en ejecución y te envía un aviso si no lo está. Cinco líneas de script bash. Configúralo para que se ejecute cada 5 minutos.
Para monitoreo más sofisticado (métricas, tableros, alertas), consulta mi artículo sobre Grafana. Pero la verificación básica de salud cubre el 90% de lo que necesitas.
Paso 8: Respaldo
Configura copias de seguridad diarias de tus archivos de configuración y datos. Consulta mi artículo sobre la estrategia de respaldo para el enfoque completo. Como mínimo: copia tu configuración y datos a una segunda ubicación a diario.
Paso 9: Documentación
Anota: la IP del servidor, cómo acceder por SSH, dónde se encuentra la configuración, cómo reiniciar el servicio, cómo ver registros y cómo hacer un rollback. Tu futuro yo te lo agradecerá.
Todo el Proceso Toma Aproximadamente 2 Horas
Pasos 1-4: 45 minutos. Pasos 5-6: 30 minutos. Pasos 7-9: 45 minutos.
Después de estas 2 horas, tienes un agente de IA listo para producción funcionando en un servidor confiable con gestión de procesos, monitoreo, respaldos y documentación. Ni sobredimensionado. Ni subdimensionado. Justo lo necesario como punto de partida que puedes mejorar de forma incremental.
🕒 Published: