Docker VM 运行时

基于 VM 的 Docker 安装（如 GCP、Hetzner 及类似 VPS 提供商）的共享运行时步骤。

将所需二进制文件写入镜像

在运行中的容器里安装二进制文件是个坑——重启后一切都会丢失。

所有技能依赖的外部二进制文件必须在镜像构建时安装。

以下示例只展示三个常见二进制文件：

• gog 用于访问 Gmail
• goplaces 用于 Google Places
• wacli 用于 WhatsApp

这些只是示例，不是完整列表。你可以用同样的模式安装任意数量的二进制文件。

如果后续添加了依赖额外二进制文件的新技能，你需要：

1. 更新 Dockerfile
2. 重建镜像
3. 重启容器

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
RUN curl -L https://github.com/steipete/gog/releases/latest/download/gog_Linux_x86_64.tar.gz \
  | tar -xz -C /usr/local/bin && chmod +x /usr/local/bin/gog

# Example binary 2: Google Places CLI
RUN curl -L https://github.com/steipete/goplaces/releases/latest/download/goplaces_Linux_x86_64.tar.gz \
  | tar -xz -C /usr/local/bin && chmod +x /usr/local/bin/goplaces

# Example binary 3: WhatsApp CLI
RUN curl -L https://github.com/steipete/wacli/releases/latest/download/wacli_Linux_x86_64.tar.gz \
  | tar -xz -C /usr/local/bin && 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"]

构建并启动

docker compose build
docker compose up -d openclaw-gateway

如果构建过程中 pnpm install --frozen-lockfile 出现 Killed 或 exit code 137，说明 VM 内存不足。请换用更大的机型后重试。

验证二进制文件：

docker compose exec openclaw-gateway which gog
docker compose exec openclaw-gateway which goplaces
docker compose exec openclaw-gateway which wacli

预期输出：

/usr/local/bin/gog
/usr/local/bin/goplaces
/usr/local/bin/wacli

验证网关：

docker compose logs -f openclaw-gateway

预期输出：

[gateway] listening on ws://0.0.0.0:18789

持久化存储说明

OpenClaw 运行在 Docker 中，但 Docker 不是数据的权威来源。所有长期状态都必须能扛住重启、重建和重启动。

更新

在 VM 上更新 OpenClaw：

git pull
docker compose build
docker compose up -d