Zum Hauptinhalt springen

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.

Gemeinsame Laufzeitschritte für VM-basierte Docker-Installationen wie GCP, Hetzner und ähnliche VPS-Provider.

​
Erforderliche Binärdateien in das Image einbacken

Binärdateien in einem laufenden Container zu installieren, ist eine Falle. Alles, was zur Laufzeit installiert wird, geht bei einem Neustart verloren. Alle externen Binärdateien, die von Skills benötigt werden, müssen zur Image-Build-Zeit installiert werden. Die folgenden Beispiele zeigen nur drei gängige Binärdateien:
  • gog (aus gogcli) für Gmail-Zugriff
  • goplaces für Google Places
  • wacli für WhatsApp
Dies sind Beispiele, keine vollständige Liste. Sie können nach demselben Muster so viele Binärdateien installieren, wie nötig sind. Wenn Sie später neue Skills hinzufügen, die von zusätzlichen Binärdateien abhängen, müssen Sie:
  1. Die Dockerfile aktualisieren
  2. Das Image neu bauen
  3. Die Container neu starten
Beispiel-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"]
Die oben genannten URLs sind Beispiele. Wählen Sie für ARM-basierte VMs die arm64-Assets aus. Verwenden Sie für reproduzierbare Builds versionierte Release-URLs.

​
Bauen und starten

docker compose build
docker compose up -d openclaw-gateway
Wenn der Build während pnpm install --frozen-lockfile mit Killed oder exit code 137 fehlschlägt, hat die VM nicht genügend Arbeitsspeicher. Verwenden Sie eine größere Maschinenklasse, bevor Sie es erneut versuchen. Binärdateien überprüfen: 
docker compose exec openclaw-gateway which gog
docker compose exec openclaw-gateway which goplaces
docker compose exec openclaw-gateway which wacli
Erwartete Ausgabe: 
/usr/local/bin/gog
/usr/local/bin/goplaces
/usr/local/bin/wacli
Gateway überprüfen: 
docker compose logs -f openclaw-gateway
Erwartete Ausgabe: 
[gateway] listening on ws://0.0.0.0:18789

​
Was wo dauerhaft gespeichert wird

OpenClaw läuft in Docker, aber Docker ist nicht die Source of Truth. Alle langlebigen Zustände müssen Neustarts, Neubuilds und Reboots überstehen.
KomponenteSpeicherortPersistenzmechanismusHinweise
Gateway-Konfiguration/home/node/.openclaw/Host-Volume-MountEnthält openclaw.json, .env
Modellauthentifizierungsprofile/home/node/.openclaw/agents/Host-Volume-Mountagents/<agentId>/agent/auth-profiles.json (OAuth, API-Schlüssel)
Schlüssel für Authentifizierungsprofile/home/node/.config/openclaw/Host-Volume-MountLokaler Verschlüsselungsschlüssel für OAuth-Tokenmaterial von Authentifizierungsprofilen
Skill-Konfigurationen/home/node/.openclaw/skills/Host-Volume-MountZustand auf Skill-Ebene
Agent-Arbeitsbereich/home/node/.openclaw/workspace/Host-Volume-MountCode- und Agent-Artefakte
WhatsApp-Sitzung/home/node/.openclaw/Host-Volume-MountBewahrt die QR-Anmeldung auf
Gmail-Schlüsselbund/home/node/.openclaw/Host-Volume + PasswortErfordert GOG_KEYRING_PASSWORD
Plugin-Pakete/home/node/.openclaw/npm, /home/node/.openclaw/gitHost-Volume-MountStammverzeichnisse für herunterladbare Plugin-Pakete
Externe Binärdateien/usr/local/bin/Docker-ImageMüssen zur Build-Zeit eingebacken werden
Node-LaufzeitContainer-DateisystemDocker-ImageWird bei jedem Image-Build neu gebaut
BetriebssystempaketeContainer-DateisystemDocker-ImageNicht zur Laufzeit installieren
Docker-ContainerKurzlebigNeustartbarKann sicher gelöscht werden

​
Updates

So aktualisieren Sie OpenClaw auf der VM: 
git pull
docker compose build
docker compose up -d

​
Verwandte Themen