Despliegue en Render | Docs

Despliega OpenClaw en Render usando infraestructura como código. El archivo render.yaml incluido define tu stack completo de forma declarativa — servicio, disco, variables de entorno — para que puedas desplegar con un solo clic y versionar tu infraestructura junto con tu código.

Requisitos previos

Una cuenta en Render (hay plan gratuito)
Una clave API de tu proveedor de modelos preferido

Despliegue con un Blueprint de Render

Deploy to Render

Al hacer clic en ese enlace:

Se creará un nuevo servicio en Render a partir del Blueprint render.yaml en la raíz del repositorio.
Se te pedirá que definas SETUP_PASSWORD.
Se construirá la imagen Docker y se desplegará.

Una vez desplegado, la URL de tu servicio seguirá el patrón https://<nombre-del-servicio>.onrender.com.

Entendiendo el Blueprint

Los Blueprints de Render son archivos YAML que definen tu infraestructura. El 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 # prompts during deploy
      - key: OPENCLAW_STATE_DIR
        value: /data/.openclaw
      - key: OPENCLAW_WORKSPACE_DIR
        value: /data/workspace
      - key: OPENCLAW_GATEWAY_TOKEN
        generateValue: true # auto-generates a secure token
    disk:
      name: openclaw-data
      mountPath: /data
      sizeGB: 1

Funcionalidades clave del Blueprint:

Funcionalidad	Para qué sirve
`runtime: docker`	Construye a partir del Dockerfile del repositorio
`healthCheckPath`	Render monitorea `/health` y reinicia instancias caídas
`sync: false`	Solicita el valor durante el despliegue (secretos)
`generateValue: true`	Genera automáticamente un valor criptográficamente seguro
`disk`	Almacenamiento persistente que sobrevive a los redespliegues

Elegir un plan

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

El Blueprint usa starter por defecto. Para usar el plan gratuito, cambia plan: free en el render.yaml de tu fork (ten en cuenta que sin disco persistente la configuración se pierde en cada despliegue).

Después del despliegue

Completar el asistente de configuración

Ve a https://<tu-servicio>.onrender.com/setup
Introduce tu SETUP_PASSWORD
Selecciona un proveedor de modelos y pega tu clave API
Opcionalmente, configura canales de mensajería (Telegram, Discord, Slack)
Haz clic en Run setup

Acceder a la interfaz de control

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

Funciones del panel de Render

Logs

Consulta los logs en tiempo real en Dashboard → tu servicio → Logs. Puedes filtrar por:

Logs de construcción (creación de la imagen Docker)
Logs de despliegue (arranque del servicio)
Logs de ejecución (salida de la aplicación)

Acceso por terminal

Para depuración, abre una sesión de terminal en Dashboard → tu servicio → Shell. El disco persistente está montado en /data.

Variables de entorno

Modifica las variables en Dashboard → tu servicio → Environment. Los cambios disparan un redespliegue automático.

Despliegue automático

Si usas el repositorio original de OpenClaw, Render no desplegará automáticamente las actualizaciones. Para actualizar, ejecuta una sincronización manual del Blueprint desde el panel.

Dominio personalizado

Ve a Dashboard → tu servicio → Settings → Custom Domains
Añade tu dominio
Configura el DNS como se indica (CNAME apuntando a *.onrender.com)
Render aprovisiona un certificado TLS automáticamente

Escalado

Render soporta escalado horizontal y vertical:

Vertical: Cambia de plan para obtener más CPU/RAM
Horizontal: Aumenta el número de instancias (plan Standard en adelante)

Para OpenClaw, el escalado vertical suele ser suficiente. El escalado horizontal requiere sesiones sticky o gestión de estado externa.

Respaldos y migración

Exporta tu configuración y workspace en cualquier momento:

https://<tu-servicio>.onrender.com/setup/export

Esto descarga un respaldo portable que puedes restaurar en cualquier host con OpenClaw.

Solución de problemas

El servicio no arranca

Revisa los logs de despliegue en el panel de Render. Problemas comunes:

Falta SETUP_PASSWORD — el Blueprint lo solicita, pero verifica que esté configurado
Puerto incorrecto — asegúrate de que PORT=8080 coincida con el puerto expuesto en el Dockerfile

Arranques lentos en frío (plan gratuito)

Los servicios del plan gratuito se suspenden tras 15 minutos de inactividad. La primera petición después de la suspensión tarda unos segundos mientras el contenedor arranca. Actualiza al plan Starter para tenerlo siempre activo.

Pérdida de datos tras redespliegue

Esto ocurre en el plan gratuito (sin disco persistente). Actualiza a un plan de pago o exporta tu configuración regularmente a través de /setup/export.

Fallos en el health check

Render espera una respuesta 200 de /health en un máximo de 30 segundos. Si la construcción tiene éxito pero el despliegue falla, es posible que el servicio tarde demasiado en arrancar. Verifica:

Los logs de construcción en busca de errores
Que el contenedor funcione localmente con docker build && docker run