English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

Hosting

Docker-VM-Laufzeit

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

Erforderliche Binärdateien in das Image einbauen

Binärdateien in einem laufenden Container zu installieren, ist eine Falle. Alles, was zur Laufzeit installiert wird, geht beim Neustart verloren.

Alle externen Binärdateien, die von Skills benötigt werden, müssen beim Image-Build 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 mit 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. Das 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"]

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 genug Arbeitsspeicher. Verwenden Sie eine größere Maschinenklasse, bevor Sie es erneut versuchen.

Binärdateien prü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 prü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 Quelle der Wahrheit. Alle langlebigen Zustandsdaten müssen Neustarts, Neubuilds und Reboots überstehen.

Komponente Speicherort Persistenzmechanismus Hinweise
Gateway-Konfiguration /home/node/.openclaw/ Host-Volume-Mount Enthält openclaw.json, .env
Modell-Auth-Profile /home/node/.openclaw/agents/ Host-Volume-Mount agents/<agentId>/agent/auth-profiles.json (OAuth, API-Schlüssel)
Skill-Konfigurationen /home/node/.openclaw/skills/ Host-Volume-Mount Zustand auf Skill-Ebene
Agent-Arbeitsbereich /home/node/.openclaw/workspace/ Host-Volume-Mount Code- und Agent-Artefakte
WhatsApp-Sitzung /home/node/.openclaw/ Host-Volume-Mount Bewahrt den QR-Login
Gmail-Keyring /home/node/.openclaw/ Host-Volume + Passwort Erfordert GOG_KEYRING_PASSWORD
Plugin-Pakete /home/node/.openclaw/npm, /home/node/.openclaw/git Host-Volume-Mount Paket-Roots für herunterladbare Plugins
Externe Binärdateien /usr/local/bin/ Docker-Image Müssen beim Build eingebaut werden
Node-Laufzeit Container-Dateisystem Docker-Image Wird bei jedem Image-Build neu gebaut
Betriebssystempakete Container-Dateisystem Docker-Image Nicht zur Laufzeit installieren
Docker-Container Flüchtig Neustartbar Kann gefahrlos zerstört werden

Updates

So aktualisieren Sie OpenClaw auf der VM:

git pull
docker compose build
docker compose up -d

Verwandte Themen