Hosting

Entorno de ejecución de máquina virtual de Docker

Pasos de runtime compartidos para instalaciones de Docker basadas en VM, como GCP, Hetzner y proveedores VPS similares.

Incorpora los binarios requeridos en la imagen

Instalar binarios dentro de un contenedor en ejecución es una trampa. Todo lo que se instale en runtime se perderá al reiniciar.

Todos los binarios externos requeridos por Skills deben instalarse en tiempo de compilación de la imagen.

Los ejemplos siguientes muestran solo tres binarios comunes:

gog (de gogcli) para acceso a Gmail
goplaces para Google Places
wacli para WhatsApp

Estos son ejemplos, no una lista completa. Puedes instalar tantos binarios como necesites usando el mismo patrón.

Si más adelante agregas nuevas Skills que dependen de binarios adicionales, debes:

Actualizar el Dockerfile
Recompilar la imagen
Reiniciar los contenedores

Dockerfile de ejemplo

dockerfile

FROM node:24-bookworm RUN apt-get update && apt-get install -y socat && rm -rf /var/lib/apt/lists/* # Example binary 1: Gmail CLI (gogcli — installs as `gog`)# Copy the current Linux asset URL from https://github.com/steipete/gogcli/releasesRUN curl -L https://github.com/steipete/gogcli/releases/latest/download/gogcli_linux_amd64.tar.gz \  | tar -xzO gog > /usr/local/bin/gog; \  chmod +x /usr/local/bin/gog # Example binary 2: Google Places CLI# Copy the current Linux asset URL from https://github.com/steipete/goplaces/releasesRUN curl -L https://github.com/steipete/goplaces/releases/latest/download/goplaces_linux_amd64.tar.gz \  | tar -xzO goplaces > /usr/local/bin/goplaces; \  chmod +x /usr/local/bin/goplaces # Example binary 3: WhatsApp CLI# Copy the current Linux asset URL from https://github.com/steipete/wacli/releasesRUN curl -L https://github.com/steipete/wacli/releases/latest/download/wacli-linux-amd64.tar.gz \  | tar -xzO wacli > /usr/local/bin/wacli; \  chmod +x /usr/local/bin/wacli # Add more binaries below using the same pattern WORKDIR /appCOPY package.json pnpm-lock.yaml pnpm-workspace.yaml .npmrc ./COPY ui/package.json ./ui/package.jsonCOPY scripts ./scripts RUN corepack enableRUN pnpm install --frozen-lockfile COPY . .RUN pnpm buildRUN pnpm ui:installRUN pnpm ui:build ENV NODE_ENV=production CMD ["node","dist/index.js"]

Compilar e iniciar

bash

docker compose builddocker compose up -d openclaw-gateway

Si la compilación falla con Killed o exit code 137 durante pnpm install --frozen-lockfile, la VM no tiene memoria suficiente. Usa una clase de máquina más grande antes de reintentarlo.

Verifica los binarios:

bash

docker compose exec openclaw-gateway which gogdocker compose exec openclaw-gateway which goplacesdocker compose exec openclaw-gateway which wacli

Salida esperada:

Code

/usr/local/bin/gog/usr/local/bin/goplaces/usr/local/bin/wacli

Verifica el Gateway:

bash

docker compose logs -f openclaw-gateway

Salida esperada:

Code

[gateway] listening on ws://0.0.0.0:18789

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 de la máquina.

Componente	Ubicación	Mecanismo de persistencia	Notas
Configuración del Gateway	`/home/node/.openclaw/`	Montaje de volumen del host	Incluye `openclaw.json`, `.env`
Perfiles de autenticación de modelos	`/home/node/.openclaw/agents/`	Montaje de volumen del host	`agents/<agentId>/agent/auth-profiles.json` (OAuth, claves de API)
Clave del perfil de autenticación	`/home/node/.config/openclaw/`	Montaje de volumen del host	Clave de cifrado local para material de tokens del perfil de autenticación OAuth
Configuraciones de Skills	`/home/node/.openclaw/skills/`	Montaje de volumen del host	Estado a nivel de Skill
Espacio de trabajo del agente	`/home/node/.openclaw/workspace/`	Montaje de volumen del host	Código y artefactos del agente
Sesión de WhatsApp	`/home/node/.openclaw/`	Montaje de volumen del host	Conserva el inicio de sesión por QR
Llavero de Gmail	`/home/node/.openclaw/`	Volumen del host + contraseña	Requiere `GOG_KEYRING_PASSWORD`
Paquetes de Plugin	`/home/node/.openclaw/npm`, `/home/node/.openclaw/git`	Montaje de volumen del host	Raíces de paquetes de Plugin descargables
Binarios externos	`/usr/local/bin/`	Imagen de Docker	Deben incorporarse en tiempo de compilación
Runtime de Node	Sistema de archivos del contenedor	Imagen de Docker	Se reconstruye en cada compilación de imagen
Paquetes del SO	Sistema de archivos del contenedor	Imagen de Docker	No los instales en runtime
Contenedor Docker	Efímero	Reiniciable	Seguro de destruir

Actualizaciones

Para actualizar OpenClaw en la VM:

bash

git pulldocker compose builddocker compose up -d

Relacionado

Was this useful?