Pular para o conteúdo 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.

Etapas de runtime compartilhadas para instalações Docker baseadas em VM, como GCP, Hetzner e provedores VPS semelhantes.

​
Incorpore os binários necessários à imagem

Instalar binários dentro de um contêiner em execução é uma armadilha. Qualquer coisa instalada em runtime será perdida na reinicialização. Todos os binários externos exigidos por skills devem ser instalados no momento de build da imagem. Os exemplos abaixo mostram apenas três binários comuns:
  • gog (de gogcli) para acesso ao Gmail
  • goplaces para Google Places
  • wacli para WhatsApp
Estes são exemplos, não uma lista completa. Você pode instalar quantos binários forem necessários usando o mesmo padrão. Se você adicionar novas skills depois que dependam de binários adicionais, deverá:
  1. Atualizar o Dockerfile
  2. Recriar a imagem
  3. Reiniciar os contêineres
Dockerfile de exemplo 
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"]
As URLs acima são exemplos. Para VMs baseadas em ARM, escolha os assets arm64. Para builds reproduzíveis, fixe URLs de releases versionadas.

​
Build e inicialização

docker compose build
docker compose up -d openclaw-gateway
Se o build falhar com Killed ou exit code 137 durante pnpm install --frozen-lockfile, a VM está sem memória. Use uma classe de máquina maior antes de tentar novamente. Verifique os binários: 
docker compose exec openclaw-gateway which gog
docker compose exec openclaw-gateway which goplaces
docker compose exec openclaw-gateway which wacli
Saída esperada: 
/usr/local/bin/gog
/usr/local/bin/goplaces
/usr/local/bin/wacli
Verifique o Gateway: 
docker compose logs -f openclaw-gateway
Saída esperada: 
[gateway] listening on ws://0.0.0.0:18789

​
O que persiste e onde

OpenClaw é executado no Docker, mas o Docker não é a fonte da verdade. Todo estado de longa duração deve sobreviver a reinicializações, rebuilds e reboots.
ComponenteLocalizaçãoMecanismo de persistênciaObservações
Configuração do Gateway/home/node/.openclaw/Montagem de volume do hostInclui openclaw.json, .env
Perfis de autenticação de modelo/home/node/.openclaw/agents/Montagem de volume do hostagents/<agentId>/agent/auth-profiles.json (OAuth, chaves de API)
Chave do perfil de autenticação/home/node/.config/openclaw/Montagem de volume do hostChave de criptografia local para material de tokens do perfil de autenticação OAuth
Configurações de Skills/home/node/.openclaw/skills/Montagem de volume do hostEstado no nível de Skill
Workspace do agente/home/node/.openclaw/workspace/Montagem de volume do hostCódigo e artefatos do agente
Sessão do WhatsApp/home/node/.openclaw/Montagem de volume do hostPreserva o login por QR
Keyring do Gmail/home/node/.openclaw/Volume do host + senhaExige GOG_KEYRING_PASSWORD
Pacotes de Plugin/home/node/.openclaw/npm, /home/node/.openclaw/gitMontagem de volume do hostRaízes de pacotes de Plugin baixáveis
Binários externos/usr/local/bin/Imagem DockerDevem ser incorporados no momento de build
Runtime do NodeSistema de arquivos do contêinerImagem DockerRecriado a cada build de imagem
Pacotes do SOSistema de arquivos do contêinerImagem DockerNão instale em runtime
Contêiner DockerEfêmeroReiniciávelSeguro para destruir

​
Atualizações

Para atualizar o OpenClaw na VM: 
git pull
docker compose build
docker compose up -d

​
Relacionado