Saltar al contenido principal

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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:
  1. Actualizar el Dockerfile
  2. Recompilar la imagen
  3. Reiniciar los contenedores
Dockerfile de ejemplo 
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/releases
RUN 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/releases
RUN 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/releases
RUN 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 /app
COPY package.json pnpm-lock.yaml pnpm-workspace.yaml .npmrc ./
COPY ui/package.json ./ui/package.json
COPY scripts ./scripts

RUN corepack enable
RUN pnpm install --frozen-lockfile

COPY . .
RUN pnpm build
RUN pnpm ui:install
RUN pnpm ui:build

ENV NODE_ENV=production

CMD ["node","dist/index.js"]
Las URL anteriores son ejemplos. Para VM basadas en ARM, elige los recursos arm64. Para compilaciones reproducibles, fija URL de versiones publicadas específicas.

​
Compilar e iniciar

docker compose build
docker 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: 
docker compose exec openclaw-gateway which gog
docker compose exec openclaw-gateway which goplaces
docker compose exec openclaw-gateway which wacli
Salida esperada: 
/usr/local/bin/gog
/usr/local/bin/goplaces
/usr/local/bin/wacli
Verifica el Gateway: 
docker compose logs -f openclaw-gateway
Salida esperada: 
[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.
ComponenteUbicaciónMecanismo de persistenciaNotas
Configuración del Gateway/home/node/.openclaw/Montaje de volumen del hostIncluye openclaw.json, .env
Perfiles de autenticación de modelos/home/node/.openclaw/agents/Montaje de volumen del hostagents/<agentId>/agent/auth-profiles.json (OAuth, claves de API)
Clave del perfil de autenticación/home/node/.config/openclaw/Montaje de volumen del hostClave de cifrado local para material de tokens del perfil de autenticación OAuth
Configuraciones de Skills/home/node/.openclaw/skills/Montaje de volumen del hostEstado a nivel de Skill
Espacio de trabajo del agente/home/node/.openclaw/workspace/Montaje de volumen del hostCódigo y artefactos del agente
Sesión de WhatsApp/home/node/.openclaw/Montaje de volumen del hostConserva el inicio de sesión por QR
Llavero de Gmail/home/node/.openclaw/Volumen del host + contraseñaRequiere GOG_KEYRING_PASSWORD
Paquetes de Plugin/home/node/.openclaw/npm, /home/node/.openclaw/gitMontaje de volumen del hostRaíces de paquetes de Plugin descargables
Binarios externos/usr/local/bin/Imagen de DockerDeben incorporarse en tiempo de compilación
Runtime de NodeSistema de archivos del contenedorImagen de DockerSe reconstruye en cada compilación de imagen
Paquetes del SOSistema de archivos del contenedorImagen de DockerNo los instales en runtime
Contenedor DockerEfímeroReiniciableSeguro de destruir

​
Actualizaciones

Para actualizar OpenClaw en la VM: 
git pull
docker compose build
docker compose up -d

​
Relacionado