Render

Implementa OpenClaw en Render utilizando 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 (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 render.yaml Blueprint en la raíz de este repositorio.
2. Compilar la imagen de Docker y desplegar

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

Entender el Blueprint

Los Blueprints de Render 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	Compila desde el Dockerfile del repositorio
healthCheckPath	Render supervisa /health y reinicia las instancias no saludables
generateValue: true	Genera automáticamente un valor criptográficamente seguro
disk	Almacenamiento persistente que sobrevive a los re-despliegues

Elegir un plan

Plan	Suspensión	Disco	Lo mejor para
Gratis	Después de 15 min de inactividad	No disponible	Pruebas, demostraciones
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: sin disco persistente significa que la configuración 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 valor OPENCLAW_GATEWAY_TOKEN que se generó automáticamente durante el despliegue (encuéntrelo en Dashboard → su servicio → Environment).

Características del panel de Render

Registros

Vea los registros en tiempo real en Dashboard → su servicio → Logs. Filtre 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 depurar, abra una sesión de shell a través de Dashboard → su servicio → Shell. El disco persistente está montado en /data.

Variables de entorno

Modifique las variables en Dashboard → su servicio → Environment. Los cambios activan un re-despliegue automático.

Despliegue automático

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

Dominio personalizado

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

Escalado

Render admite el escalado horizontal y vertical:

• Vertical: Cambia el plan para obtener más CPU/RAM
• Horizontal: Aumenta el recuento de instancias (plan Standard y superior)

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

Copias de seguridad y migración

Exporta tu configuración y espacio de trabajo en cualquier momento utilizando el acceso a shell en el panel de Render:

openclaw backup create

Esto crea un archivo de copia de seguridad portable que puedes restaurar en cualquier host de OpenClaw. Consulta Backup para obtener más detalles.

Solución de problemas

El servicio no se inicia

Comprueba los registros de despliegue en el panel de Render. Problemas comunes:

• Falta OPENCLAW_GATEWAY_TOKEN — verifica que esté configurado en Dashboard → Environment
• Discrepancia de puerto — asegúrate de que OPENCLAW_GATEWAY_PORT=8080 esté configurado para que la puerta de enlace se enlace al puerto que Render espera

Inicios en frío lentos (nivel gratuito)

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

Pérdida de datos tras el redespliegue

Esto sucede en el nivel gratuito (sin disco persistente). Actualiza a un plan de pago, o exporta regularmente tu configuración a través de openclaw backup create en el shell de Render.

Fallos de comprobación de estado

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

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

Próximos pasos

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