Naar hoofdinhoud gaan

Documentation Index

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

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

Gedeelde runtime-stappen voor VM-gebaseerde Docker-installaties zoals GCP, Hetzner en vergelijkbare VPS-providers.

​
Neem vereiste binaire bestanden op in de image

Binaire bestanden installeren in een draaiende container is een valkuil. Alles wat tijdens runtime wordt geïnstalleerd, gaat verloren bij een herstart. Alle externe binaire bestanden die door Skills worden vereist, moeten tijdens het bouwen van de image worden geïnstalleerd. De onderstaande voorbeelden tonen slechts drie veelgebruikte binaire bestanden:
  • gog (van gogcli) voor Gmail-toegang
  • goplaces voor Google Places
  • wacli voor WhatsApp
Dit zijn voorbeelden, geen volledige lijst. Je kunt zoveel binaire bestanden installeren als nodig is met hetzelfde patroon. Als je later nieuwe Skills toevoegt die afhankelijk zijn van aanvullende binaire bestanden, moet je:
  1. Het Dockerfile bijwerken
  2. De image opnieuw bouwen
  3. De containers herstarten
Voorbeeld-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/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"]
De bovenstaande URL’s zijn voorbeelden. Kies voor ARM-gebaseerde VM’s de arm64-assets. Gebruik gepinde URL’s van gereleasete versies voor reproduceerbare builds.

​
Bouwen en starten

docker compose build
docker compose up -d openclaw-gateway
Als de build mislukt met Killed of exit code 137 tijdens pnpm install --frozen-lockfile, heeft de VM onvoldoende geheugen. Gebruik een grotere machineklasse voordat je het opnieuw probeert. Controleer binaire bestanden: 
docker compose exec openclaw-gateway which gog
docker compose exec openclaw-gateway which goplaces
docker compose exec openclaw-gateway which wacli
Verwachte uitvoer: 
/usr/local/bin/gog
/usr/local/bin/goplaces
/usr/local/bin/wacli
Controleer Gateway: 
docker compose logs -f openclaw-gateway
Verwachte uitvoer: 
[gateway] listening on ws://0.0.0.0:18789

​
Wat waar blijft bestaan

OpenClaw draait in Docker, maar Docker is niet de bron van waarheid. Alle duurzame state moet herstarts, rebuilds en reboots overleven.
ComponentLocatiePersistentiemethodeOpmerkingen
Gateway-config/home/node/.openclaw/Host-volumemountBevat openclaw.json, .env
Modelauth-profielen/home/node/.openclaw/agents/Host-volumemountagents/<agentId>/agent/auth-profiles.json (OAuth, API keys)
Auth-profielsleutel/home/node/.config/openclaw/Host-volumemountLokale encryptiesleutel voor tokenmateriaal van OAuth-auth-profielen
Skill-configuraties/home/node/.openclaw/skills/Host-volumemountState op Skill-niveau
Agentwerkruimte/home/node/.openclaw/workspace/Host-volumemountCode en agentartefacten
WhatsApp-sessie/home/node/.openclaw/Host-volumemountBehoudt QR-login
Gmail-keyring/home/node/.openclaw/Host-volume + wachtwoordVereist GOG_KEYRING_PASSWORD
Plugin-pakketten/home/node/.openclaw/npm, /home/node/.openclaw/gitHost-volumemountRoots van downloadbare Plugin-pakketten
Externe binaire bestanden/usr/local/bin/Docker-imageMoeten tijdens het bouwen worden ingebakken
Node-runtimeContainerbestandssysteemDocker-imageWordt bij elke image-build opnieuw gebouwd
OS-pakkettenContainerbestandssysteemDocker-imageNiet tijdens runtime installeren
Docker-containerVluchtigHerstartbaarVeilig om te vernietigen

​
Updates

Om OpenClaw op de VM bij te werken: 
git pull
docker compose build
docker compose up -d

​
Gerelateerd