Aprende a instalar y configurar Open Cloud en Dokploy paso a paso: desde la plantilla Docker hasta la autorización por SSH, configuración de dominio con SSL y primera prueba con el modelo GLM5 de ZAI.
En esta lección aprenderemos a instalar y configurar OpenClaw desde cero utilizando Dokploy como plataforma de despliegue. Veremos cómo usar la plantilla oficial, configurar las variables de entorno, asignar un dominio con SSL y superar el sistema de seguridad de autorización de dispositivos.
Un dominio propio con acceso a sus registros DNS.
Una API Key de un proveedor de modelos de IA (ZAI, OpenAI, Anthropic, etc.).
Un servidor con Dokploy instalado y acceso SSH al VPS.
Accede a tu panel de Dokploy y crea un nuevo proyecto (por ejemplo, con el nombre test). Dentro del proyecto, añade un nuevo servicio donde alojaremos Open Cloud.
En lugar de clonar el repositorio manualmente o usar la consola, utilizaremos la plantilla de Open Cloud disponible en Dokploy. Antes de hacer el primer despliegue:
Abre el archivo YAML (Docker Compose) de la plantilla.
Cambia la versión por defecto a latest para garantizar que se instala la última versión parcheada y actualizada.
Guarda los cambios y realiza el primer despliegue.
Una vez completado el primer despliegue, configura las variables de entorno del servicio:
Elimina las API Keys de servicios que no vayas a usar (por ejemplo, OpenRouter).
Añade tu API Key del modelo elegido. En esta lección se usa GLM5 de ZAI.
Establece un usuario y contraseña de acceso (por ejemplo: codeia / 12345).
Copia y guarda el Gateway Token generado, ya que lo necesitarás en pasos posteriores.
Tras configurar las variables, redespliega el contenedor para aplicar los cambios.
El acceso por defecto no incluye certificado SSL, por lo que necesitamos configurar un subdominio personalizado:
Crea un registro A en tu DNS apuntando el subdominio (ej. opencloud.codeia.dev) a la IP de tu servidor.
En Dokploy, añade el dominio al servicio.
Habilita la encriptación Edge Encrypt.
Ajusta el puerto correcto (puerto 3000).
Redespliega el contenedor después de cualquier cambio en el dominio o puerto.
Al entrar a la interfaz web con el dominio configurado:
Introduce el usuario y contraseña configurados.
El sistema solicitará el Gateway Token. Intróducelo.
El acceso será denegado automáticamente: Open Cloud bloquea la puerta de enlace por seguridad hasta que el dispositivo y la URL sean autorizados explícitamente.
Para resolver el bloqueo, accede al servidor por SSH y utiliza el asistente de IA nativo de la terminal, Claude. Con su ayuda, edita el archivo settings.json del contenedor realizando los siguientes cambios:
Añade el dominio a la lista de orígenes permitidos (AllowedOrigins).
Añade el proxy Traefik a la configuración de proxies de confianza (trusted_proxies) para que la conexión no sea rechazada.
Tras los ajustes en settings.json:
Vuelve al navegador y reintenta la conexión para generar una solicitud de acceso.
Desde la terminal, visualiza la solicitud pendiente y apuébala manualmente.
Asegúrate de que la opción auto_approve esté en false para mantener la seguridad ante futuras conexiones.
Con el acceso concedido, dentro de la Web UI de Open Cloud:
Verifica que el modelo asignado (GLM5) aparece activo.
Envía un mensaje de prueba: “hola”.
El bot responderá correctamente. Pídele que hable en español para confirmar que la instalación fue un éxito.
Has instalado y configurado correctamente Open Claw en tu servidor usando Dokploy. Ahora dispones de una instancia propia con tu dominio, certificado SSL y el modelo GLM5 de ZAI listo para usar. En próximas lecciones exploraremos las capacidades avanzadas de esta plataforma.
