render.yaml del repositorio. Este declara el servicio, el disco y las variables de entorno en un solo archivo.
Requisitos previos
- Una cuenta de Render (nivel gratuito disponible)
- Una clave de API de su proveedor de modelos preferido
Implementación
Implementar en Render Esto crea un servicio de Render a partir derender.yaml, compila la imagen de Docker y la implementa. La URL del servicio sigue el patrón https://<service-name>.onrender.com.
El Blueprint
Elección de un plan
El Blueprint utiliza
starter de forma predeterminada. Para usar el nivel gratuito, cambie plan: free en el archivo render.yaml de su fork. Tenga en cuenta que, al no haber un disco persistente, el estado de OpenClaw se restablece en cada implementación.
Después de la implementación
Acceder a la interfaz de control
El panel web está disponible enhttps://<your-service>.onrender.com/. Conéctese mediante el secreto compartido: el valor OPENCLAW_GATEWAY_TOKEN generado automáticamente (se encuentra en Dashboard → your service → Environment), o mediante su contraseña si cambió a la autenticación por contraseña.
Registros
Dashboard → your service → Logs muestra los registros de compilación (creación de la imagen de Docker), los registros de implementación (inicio del servicio) y los registros de ejecución (salida de la aplicación).Acceso al shell
Dashboard → your service → Shell abre una sesión de shell. El disco persistente está montado en/data.
Variables de entorno
Edite las variables en Dashboard → your service → Environment. Los cambios activan una reimplementación automática.Implementación automática
Render vuelve a implementar automáticamente cuando la rama del repositorio conectado recibe un nuevo commit. Si realizó la implementación directamente desdeopenclaw/openclaw en lugar de desde su propio fork, no tendrá acceso de escritura para activarla; para actualizar, ejecute una sincronización manual del Blueprint desde Dashboard o dirija el servicio a su propio fork.
Dominio personalizado
- Dashboard → your service → Settings → Custom Domains
- Añada su dominio
- Configure el DNS según las instrucciones (CNAME a
*.onrender.com) - Render aprovisiona automáticamente un certificado TLS
Escalado
- Vertical: cambie el plan para obtener más CPU/RAM. Suele ser suficiente para OpenClaw.
- Horizontal: aumente el número de instancias (plan Standard o superior). Requiere sesiones persistentes o gestión externa del estado, ya que OpenClaw mantiene el estado de ejecución en el disco local.
Copias de seguridad y migración
Desde el shell de Render Dashboard, exporte en cualquier momento el estado, la configuración, los perfiles de autenticación y el espacio de trabajo:Solución de problemas
El servicio no se inicia
Revise los registros de implementación en Render Dashboard. Problemas habituales:- Falta
OPENCLAW_GATEWAY_TOKEN: compruebe que esté configurado en Dashboard → Environment - Discrepancia de puertos: asegúrese de que
OPENCLAW_GATEWAY_PORT=8080para que el Gateway se vincule al puerto que Render espera
Inicios 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. Cambie al plan Starter para mantener el servicio siempre activo.Pérdida de datos tras una reimplementación
Ocurre en el nivel gratuito (sin disco persistente). Cambie a un plan de pago o exporte periódicamente una copia de seguridad medianteopenclaw backup create desde el shell de Render.
Fallos de la comprobación de estado
Si las compilaciones se completan correctamente, pero las implementaciones fallan, es posible que el servicio tarde demasiado en iniciarse o que no se pueda acceder a/health. Compruebe:
- Los registros de compilación en busca de errores
- Si el contenedor se ejecuta localmente con
docker build && docker run
Siguientes pasos
- Configure los canales de mensajería: Canales
- Configure el Gateway: Configuración del Gateway
- Mantenga OpenClaw actualizado: Actualización