Skip to main content
Pasos de ejecución compartidos para instalaciones de Docker basadas en máquinas virtuales, como GCP, Hetzner y proveedores de VPS similares.

Incorporar los binarios necesarios en la imagen

Instalar binarios dentro de un contenedor en ejecución es una trampa: todo lo instalado durante la ejecución se pierde al reiniciar. Incorpore en la imagen, durante la compilación, todos los binarios externos que necesite una skill. Los siguientes ejemplos abarcan solo tres binarios, en orden alfabético:
  • gog (de gogcli) para acceder a Gmail
  • goplaces para Google Places
  • wacli para WhatsApp
Son ejemplos, no una lista completa. Instale tantos binarios como necesiten sus skills siguiendo el mismo patrón. Cuando posteriormente añada una skill que necesite un binario nuevo:
  1. Actualice el Dockerfile.
  2. Vuelva a compilar la imagen.
  3. Reinicie los contenedores.
Dockerfile de ejemplo
Las URL anteriores son ejemplos. Para máquinas virtuales basadas en ARM, elija los recursos arm64. Para obtener compilaciones reproducibles, fije URL de versiones específicas.

Compilar e iniciar

Si la compilación falla con Killed o con el código de salida 137 durante pnpm install --frozen-lockfile, la máquina virtual se ha quedado sin memoria. Use una clase de máquina más grande antes de volver a intentarlo. Verifique los binarios:
Salida esperada:
Verifique que el Gateway esté activo:
Que /healthz devuelva una respuesta 200 confirma que el proceso del Gateway está escuchando y funciona correctamente; el HEALTHCHECK integrado en la imagen consulta el mismo endpoint.

Qué persiste y dónde

OpenClaw se ejecuta en Docker, pero Docker no es la fuente de verdad. Todo el estado de larga duración debe sobrevivir a reinicios, recompilaciones y reinicios del sistema.

Actualizaciones

Para actualizar OpenClaw en la máquina virtual:

Contenido relacionado