# Render

Implementa OpenClaw en Render con infraestructura como código. El render.yaml Blueprint incluido define toda tu pila de forma declarativa, servicio, disco, variables de entorno, para que puedas implementar con un solo clic y versionar tu infraestructura junto con tu código.

# Requisitos previos

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

# Implementar con un Blueprint de Render

Implementar en Render

Al hacer clic en este enlace:

1. Se creará un nuevo servicio de Render a partir del Blueprint render.yaml en la raíz de este repositorio.
2. Se compilará la imagen de Docker y se implementará

Una vez implementado, la URL de tu servicio seguirá el patrón https://<service-name>.onrender.com.

# Comprender el 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: 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 principales del Blueprint utilizadas:

Característica	Propósito
runtime: docker	Compila a partir del Dockerfile del repositorio
healthCheckPath	Render supervisa /health y reinicia instancias no saludables
generateValue: true	Genera automáticamente un valor criptográficamente seguro
disk	Almacenamiento persistente que sobrevive a las reimplementaciones

# Elegir un plan

Plan	Suspensión	Disco	Ideal para
Free	Después de 15 min inactivo	No disponible	Pruebas, demostraciones
Starter	Nunca	1GB+	Uso personal, equipos pequeños
Standard+	Nunca	1GB+	Producción, varios canales

El Blueprint usa starter de forma predeterminada. Para usar el nivel gratuito, cambia plan: free en el render.yaml de tu fork (pero ten en cuenta que: sin disco persistente, el estado de OpenClaw se restablece en cada implementación).

# Después de la implementación

# Acceder a la interfaz Control

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

Conéctate usando el secreto compartido configurado. Esta plantilla de implementación genera automáticamente OPENCLAW_GATEWAY_TOKEN (encuéntralo en Dashboard → your service → Environment); si lo sustituyes por autenticación con contraseña, usa esa contraseña en su lugar.

# Funciones del panel de Render

# Registros

Consulta registros en tiempo real en Dashboard → your service → Logs. Filtra por:

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

# Acceso al shell

Para depuración, abre una sesión de shell mediante Dashboard → your service → Shell. El disco persistente está montado en /data.

# Variables de entorno

Modifica variables en Dashboard → your service → Environment. Los cambios activan una reimplementación automática.

# Implementación automática

Si usas el repositorio original de OpenClaw, Render no volverá a implementar automáticamente tu OpenClaw. Para actualizarlo, ejecuta una sincronización manual del Blueprint desde el panel.

# Dominio personalizado

1. Ve a Dashboard → your service → Settings → Custom Domains
2. Añade tu dominio
3. Configura el DNS según se indique (CNAME a *.onrender.com)
4. Render aprovisiona automáticamente un certificado TLS

# Escalado

Render admite escalado horizontal y vertical:

• Vertical: cambia el plan para obtener más CPU/RAM
• Horizontal: aumenta el número de instancias (plan Standard o superior)

Para OpenClaw, normalmente el escalado vertical es suficiente. El escalado horizontal requiere sesiones persistentes o gestión de estado externa.

# Copias de seguridad y migración

Exporta tu estado, configuración, perfiles de autenticación y espacio de trabajo en cualquier momento usando el acceso al shell en el panel de Render:

openclaw backup create

Esto crea un archivo de copia de seguridad portable con el estado de OpenClaw más cualquier espacio de trabajo configurado. Consulta Backup para más detalles.

# Solución de problemas

# El servicio no se inicia

Consulta los registros de implementación en el panel de Render. Problemas habituales:

• Falta OPENCLAW_GATEWAY_TOKEN: verifica que esté establecido en Dashboard → Environment
• Incompatibilidad de puerto: asegúrate de que OPENCLAW_GATEWAY_PORT=8080 esté establecido para que el gateway se vincule al puerto que Render espera

# Arranques en frío lentos (nivel gratuito)

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

# Pérdida de datos tras reimplementación

Esto ocurre en el nivel gratuito (sin disco persistente). Actualiza a un plan de pago o exporta regularmente una copia de seguridad completa con openclaw backup create en el shell de Render.

# Fallos de la comprobación de estado

Render espera una respuesta 200 de /health en un plazo de 30 segundos. Si las compilaciones tienen éxito pero las implementaciones fallan, es posible que el servicio esté tardando demasiado en iniciarse. Comprueba:

• Los registros de compilación para ver errores
• Si el contenedor se ejecuta localmente con docker build && docker run

# Próximos pasos

• Configura canales de mensajería: Channels
• Configura el Gateway: Gateway configuration
• Mantén OpenClaw actualizado: Updating