Saltar al contenido principal
Implementa OpenClaw en Render usando infraestructura como código. El Blueprint render.yaml 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

​
Implementar con un Render Blueprint

Deploy to Render Al hacer clic en este enlace se hará lo siguiente:
  1. Crear un nuevo servicio de Render a partir del Blueprint render.yaml en la raíz de este repositorio.
  2. Compilar la imagen Docker e implementar
Una vez implementado, la URL de tu servicio seguirá el patrón https://<service-name>.onrender.com.

​
Comprender el Blueprint

Los Render Blueprints 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: 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
Funciones clave del Blueprint que se usan:
FunciónPropósito
runtime: dockerCompila desde el Dockerfile del repositorio
healthCheckPathRender supervisa /health y reinicia instancias no saludables
generateValue: trueGenera automáticamente un valor criptográficamente seguro
diskAlmacenamiento persistente que sobrevive a nuevas implementaciones

​
Elegir un plan

PlanSuspensiónDiscoIdeal para
FreeTras 15 min inactivoNo disponiblePruebas, demostraciones
StarterNunca1GB+Uso personal, equipos pequeños
Standard+Nunca1GB+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 reinicia en cada implementación).

​
Después de la implementación

​
Acceder a la UI de 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 → tu servicio → Environment); si lo sustituyes por autenticación con contraseña, usa esa contraseña en su lugar.

​
Funciones del panel de Render

​
Registros

Ve los registros en tiempo real en Dashboard → tu servicio → Logs. Filtra por:
  • Registros de compilación (creación de la imagen Docker)
  • Registros de implementación (inicio del servicio)
  • Registros de ejecución (salida de la aplicación)

​
Acceso shell

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

​
Variables de entorno

Modifica variables en Dashboard → tu servicio → Environment. Los cambios desencadenan una nueva implementación automática.

​
Implementación automática

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

​
Dominio personalizado

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

​
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 basta con escalado vertical. El escalado horizontal requiere sesiones persistentes o administració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 shell del 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 comunes:
  • Falta OPENCLAW_GATEWAY_TOKEN: verifica que esté definido en Dashboard → Environment
  • Desajuste de puerto: asegúrate de que OPENCLAW_GATEWAY_PORT=8080 esté definido para que el gateway se enlace 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. Cambia al plan Starter para tenerlo siempre activo.

​
Pérdida de datos tras una nueva implementación

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

​
Fallos de comprobación de estado

Render espera una respuesta 200 de /health en 30 segundos. Si las compilaciones se completan pero las implementaciones fallan, puede que el servicio esté tardando demasiado en arrancar. Comprueba:
  • Registros de compilación para ver errores
  • Si el contenedor se ejecuta localmente con docker build && docker run

​
Siguientes pasos