Skip to content

Despliegue en servidor: ejecución 7×24 con Docker/VPS ​

Escenarios aplicables ​

Ya has ejecutado OpenClaw en tu máquina local y ahora quieres trasladarlo a un VPS para mantenerlo residente 7×24: los canales de mensajes accesibles en todo momento y las tareas continúan ejecutándose en segundo plano. O tu servidor no quiere instalar el entorno Node y necesita un Gateway contenedorizado, aislado y desechable.

Primero deja clara la postura oficial: Docker es una opción opcional. Si solo lo usas a diario en tu propia computadora, es más simple continuar con el flujo de instalación convencional; Docker está orientado a dos tipos de necesidades: «hosts sin instalación local» y «entornos aislados de un solo uso».

Preparación ​

Antes de empezar, confirma cuatro cosas:

  1. Entorno de contenedores: Docker Desktop o Docker Engine, además de Docker Compose v2.
  2. Memoria: construir la imagen localmente desde el código fuente requiere al menos 6 GB de RAM; usar la imagen preconstruida permite evitar este requisito.
  3. Disco: deja espacio suficiente para la imagen y los registros.
  4. Base de seguridad: en un VPS o host de red pública, lee primero la documentación oficial de endurecimiento de seguridad de red; lo clave es la cadena de firewall DOCKER-USER incluida con Docker: las reglas convencionales de iptables/ufw no necesariamente cubren el tráfico de contenedores.

Lectura previa: Formas alternativas de instalación: aplicación de escritorio, Docker y npm.

Sígueme paso a paso ​

Paso 1: obtener la imagen oficial ​

Ejecuta en la raíz del repositorio:

bash
./scripts/docker/setup.sh

Esto construirá localmente openclaw:local. Una opción que ahorra recursos es usar directamente la imagen preconstruida:

bash
export OPENCLAW_IMAGE="ghcr.io/openclaw/openclaw:latest"
./scripts/docker/setup.sh

GHCR es el registro principal oficial, encargado de la automatización de publicaciones, el despliegue con versión fija y la verificación de origen; la misma publicación también se sincroniza con la imagen de Docker Hub openclaw/openclaw. Reconoce solo estas dos fuentes y no uses imágenes de terceros: su ritmo de publicación y sus políticas de retención difieren de las oficiales.

En entornos de producción se recomienda fijar el tag de versión (por ejemplo 2026.9.3) y no perseguir ciegamente latest: las publicaciones de versiones estables mueven latest y main, y solo las versiones de mantenimiento del mes de cierre modifican extended-stable. También hay variantes como slim, main-slim y latest-browser disponibles.

Paso 2: iniciar el contenedor del Gateway ​

setup.sh completa automáticamente el onboarding: solicita la API key del modelo, genera un token de Gateway y lo escribe en .env, y finalmente inicia el Gateway mediante Docker Compose.

El flujo de onboarding es idéntico al de la instalación local: un proceso de Gateway constituye un límite de confianza, y tanto el modelo como los canales se configuran aquí.

Paso 3: endurecimiento para red pública y ejecución permanente ​

  • Firewall: restringe los puertos según las reglas oficiales de exposición de red y confirma que la cadena DOCKER-USER cubre el tráfico de contenedores.
  • Reinicio automático: configura una política de reinicio para el contenedor, de modo que el Gateway se recupere automáticamente tras reiniciar el VPS.
  • Aislamiento multiusuario: al servir a múltiples usuarios que no confían entre sí, no compartas un mismo Gateway: ejecuta un Gateway independiente por cada límite de confianza, preferiblemente bajo diferentes usuarios del sistema operativo o en diferentes hosts.
  • Sandbox: el backend de sandbox de Docker por defecto solo usa la CLI de docker; si quieres cambiar a Podman nativo, establece el backend en "podman"; el sandbox está desactivado por defecto y tampoco exige que el Gateway mismo se ejecute en un contenedor.

Puntos de control ​

  • El contenedor del Gateway aparece en ejecución en docker ps, y vuelve automáticamente tras reiniciar el VPS.
  • La imagen proviene de ghcr.io/openclaw/openclaw o openclaw/openclaw, con el tag de versión ya fijado.
  • Las reglas de la cadena DOCKER-USER están configuradas según la documentación de exposición a red pública.
  • Cada grupo de usuarios que no confían entre sí tiene su propio Gateway independiente, en lugar de un solo contenedor que sirva a todos.

Límites ​

  • Aceleración de extracción en China: oficialmente no se ofrece documentación de aceleración de imágenes para ghcr.io / Docker Hub, y esta página no especula sobre direcciones de espejo @@I18N_KEEP_000029@@; si la extracción falla, revisa primero la salida a internet y el DNS del servidor.
  • Configuración sin cambios: Docker solo cambia el soporte de ejecución; la forma de configurar modelos, canales y Skills es la misma que en el despliegue local.
  • Trampa de versiones: oficialmente se registró un error de número de versión: el 2026.9.1-beta.1 publicado en npm corresponde en realidad a 2026.8.1-beta.4; al fijar tags de versión preliminar, guíate por las notas de publicación.

Siguiente paso ​

gaodong.aiAboutPrivacyContact

Independent tutorials, not affiliated with any product mentioned. Product names and trademarks belong to their owners. Check official pages for prices and policies.