Render

Render

Implemente OpenClaw en Render usando Infraestructura como Código. El Blueprint render.yaml incluido define toda su pila de forma declarativa: servicio, disco, variables de entorno, por lo que puede implementar con un solo clic y versionar su infraestructura junto con su código.

Requisitos previos

• Una cuenta de Render (nivel gratuito disponible)
• Una clave API de su proveedor de modelos preferido

Implementar con un Render Blueprint

Desplegar en Render

Al hacer clic en este enlace:

1. Creará un nuevo servicio de Render desde el Blueprint render.yaml en la raíz de este repositorio.
2. Construirá la imagen de Docker y la desplegará

Una vez desplegado, la URL de su servicio sigue el patrón https://<service-name>.onrender.com.

Entendiendo el Blueprint

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

services:
  - type: web
    name: openclaw
    runtime: docker
    plan: starter
    healthCheckPath: /health
    envVars:
      - key: OPENCLAW_GATEWAY_PORT
        value: "8080"
      - 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

Características clave del Blueprint utilizadas:

Característica	Propósito
runtime: docker	Construye desde el Dockerfile del repositorio
healthCheckPath	Render monitorea /health y reinicia las instancias no saludables
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	Mejor para
Gratis	Después de 15 min de inactividad	No disponible	Pruebas, demos
Inicial	Nunca	1GB+	Uso personal, equipos pequeños
Estándar+	Nunca	1GB+	Producción, múltiples canales

El Blueprint por defecto es starter. Para usar el nivel gratuito, cambie plan: free en el render.yaml de su bifurcación (pero tenga en cuenta: la ausencia de disco persistente significa que el estado de OpenClaw se restablece en cada despliegue).

Después del despliegue

Acceder a la interfaz de control

El panel web está disponible en https://<your-service>.onrender.com/.

Conéctese usando el secreto compartido configurado. Esta plantilla de despliegue genera automáticamente OPENCLAW_GATEWAY_TOKEN (encuéntrelo en Panel → su servicio → Entorno); si lo reemplaza con autenticación por contraseña, use esa contraseña en su lugar.

Características del panel de Render

Registros

Ver los registros en tiempo real en Panel de control → su servicio → Registros. Filtrar por:

• Registros de compilación (creación de imagen Docker)
• Registros de despliegue (inicio del servicio)
• Registros de tiempo de ejecución (salida de la aplicación)

Acceso a Shell

Para la depuración, abra una sesión de shell a través de Panel de control → su servicio → Shell. El disco persistente está montado en /data.

Variables de entorno

Modifique las variables en Panel de control → su servicio → Entorno. Los cambios activan un redespliegue automático.

Despliegue automático

Si utiliza el repositorio original de OpenClaw, Render no desplegará automáticamente su OpenClaw. Para actualizarlo, ejecute una sincronización manual de Blueprint desde el panel de control.

Dominio personalizado

1. Vaya a Panel de control → su servicio → Configuración → Dominios personalizados
2. Añada su dominio
3. Configure el DNS como se indica (CNAME a *.onrender.com)
4. Render aprovisiona un certificado TLS automáticamente

Escalado

Render admite escalado horizontal y vertical:

• Vertical: Cambie el plan para obtener más CPU/RAM
• Horizontal: Aumente el recuento de instancias (plan Estándar y superior)

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

Copias de seguridad y migración

Exporte su estado, configuración, perfiles de autenticación y espacio de trabajo en cualquier momento utilizando el acceso a shell en el Panel de control de Render:

openclaw backup create

Esto crea un archivo de copia de seguridad portátil con el estado de OpenClaw más cualquier espacio de trabajo configurado. Consulte Copia de seguridad para obtener más detalles.

Solución de problemas

El servicio no se iniciará

Compruebe los registros de despliegue en el Panel de control de Render. Problemas comunes:

• Falta OPENCLAW_GATEWAY_TOKEN — verifique que esté configurado en Panel de control → Entorno
• Discrepancia de puerto — asegúrese de que OPENCLAW_GATEWAY_PORT=8080 esté configurado para que la puerta de enlace se enlace al puerto que Render espera

Inicios lentos en frío (nivel gratuito)

Los servicios de nivel gratuito se apagan después de 15 minutos de inactividad. La primera solicitud después del apagado tarda unos segundos mientras se inicia el contenedor. Actualice al plan Starter para mantenerlo siempre activo.

Pérdida de datos después del redespliegue

Esto ocurre en el nivel gratuito (sin disco persistente). Actualice a un plan de pago, o exporte regularmente una copia de seguridad completa a través de openclaw backup create en el shell de Render.

Fallos en las comprobaciones de estado

Render espera una respuesta 200 de /health dentro de los 30 segundos. Si las compilaciones tienen éxito pero las implementaciones fallan, el servicio puede estar tardando demasiado en iniciarse. Compruebe:

• Registros de compilación en busca de errores
• Si el contenedor se ejecuta localmente con docker build && docker run

Próximos pasos

• Configure los canales de mensajería: Canales
• Configure la pasarela (Gateway): Configuración de la pasarela
• Mantenga OpenClaw actualizado: Actualización