Desplegar OpenClaw en Render con Infrastructure as Code

Configurar la infraestructura manualmente suele ser un proceso lento y propenso a errores. Te olvidas de una variable de entorno, el disco no se monta correctamente o pierdes el rastro de los cambios que hiciste en el panel de control. Gestionar todo mediante código te permite tener un entorno predecible y fácil de replicar.

Desplegar OpenClaw en Render es sencillo gracias a Infrastructure as Code. El archivo render.yaml incluido define todo tu stack de forma declarativa: servicios, discos y variables de entorno. Así puedes desplegar con un solo clic y mantener tu infraestructura versionada junto a tu código.

What You’ll Need

• Una cuenta de Render (tienen un plan gratuito).
• Una API key de tu model provider preferido.

Quick Start

Sigue estos pasos para tener OpenClaw funcionando en menos de 5 minutos:

1. Haz clic en el botón de despliegue:
2. Configura lo básico: Render leerá el Blueprint render.yaml del repositorio. Se te pedirá que elijas un valor para SETUP_PASSWORD.
3. Espera al despliegue: Render construirá la imagen Docker y activará el servicio.

Una vez terminado, tu URL seguirá este patrón: https://<nombre-del-servicio>.onrender.com.

Understanding the Blueprint

Los Blueprints de Render son archivos YAML que definen tu infraestructura. El archivo render.yaml de este repositorio configura todo lo necesario para ejecutar OpenClaw:

services:
  - type: web
    name: openclaw
    runtime: docker
    plan: starter
    healthCheckPath: /health
    envVars:
      - key: PORT
        value: "8080"
      - key: SETUP_PASSWORD
        sync: false # te pedirá el valor durante el despliegue
      - key: OPENCLAW_STATE_DIR
        value: /data/.openclaw
      - key: OPENCLAW_WORKSPACE_DIR
        value: /data/workspace
      - key: OPENCLAW_GATEWAY_TOKEN
        generateValue: true # genera automáticamente un token seguro
    disk:
      name: openclaw-data
      mountPath: /data
      sizeGB: 1

Estas son las funciones clave que utiliza el Blueprint:

Feature	Propósito
runtime: docker	Construye la aplicación usando el Dockerfile del repo
healthCheckPath	Render monitorea /health y reinicia la instancia si falla
sync: false	Solicita valores durante el despliegue (ideal para secretos)
generateValue: true	Genera un valor criptográficamente seguro de forma automática
disk	Almacenamiento persistente que sobrevive a los reinicios

Choosing a plan

Plan	Spin-down	Disk	Ideal para
Free	Tras 15 min de inactividad	No disponible	Pruebas y demos
Starter	Nunca	1GB+	Uso personal y equipos pequeños
Standard+	Nunca	1GB+	Producción y múltiples canales

El Blueprint usa por defecto el plan starter. Si quieres usar el plan gratuito, cambia plan: free en el archivo render.yaml de tu fork. Ten en cuenta que sin un disk persistente, tu configuración se borrará en cada despliegue.

After deployment

Completa el asistente de configuración

1. Ve a https://<tu-servicio>.onrender.com/setup.
2. Introduce tu SETUP_PASSWORD.
3. Selecciona un model provider y pega tu API key.
4. Configura canales de mensajería (Telegram, Discord o Slack) si lo deseas.
5. Haz clic en Run setup.

Accede a la Control UI

El dashboard web está disponible en https://<tu-servicio>.onrender.com/openclaw.

Render Dashboard features

• Logs: Revisa los logs en tiempo real (Build, Deploy y Runtime) desde el panel de tu servicio.
• Shell access: Puedes abrir una terminal desde el dashboard para depurar. El disco persistente está en /data.
• Environment variables: Modifica las variables en la sección Environment. Esto activará un redespliegue automático.
• Custom domain: Añade tu dominio en Settings, configura el CNAME y Render gestionará el certificado TLS.

Backups and migration

Puedes exportar tu configuración y espacio de trabajo en cualquier momento visitando: https://<tu-servicio>.onrender.com/setup/export

Esto descarga un backup que puedes restaurar en cualquier otra instancia de OpenClaw.

Troubleshooting

El servicio no arranca

• Revisa que hayas configurado el SETUP_PASSWORD.
• Verifica que PORT=8080 coincida con el puerto expuesto en el Dockerfile.

Arranques lentos (plan Free)

En el plan gratuito, el servicio se apaga tras 15 minutos de inactividad. La primera petición tardará unos segundos mientras el contenedor arranca de nuevo.

Pérdida de datos tras redesplegar

Esto ocurre en el plan Free porque no soporta discos persistentes. Sube al plan Starter o exporta tu configuración regularmente mediante /setup/export.

Fallos en el Health check

Render espera una respuesta 200 de /health en menos de 30 segundos. Si el despliegue falla tras una construcción exitosa, el servicio podría estar tardando demasiado en iniciar. Revisa los logs de build o prueba a ejecutar el contenedor localmente con docker build y docker run.

¿Necesitas ayuda con la configuración? Prueba nuestro AI Setup Assistant.

What’s Next

• Configuración de Model Providers
• Conectar canales de mensajería