diff --git a/docs/zh-CN/install/docker-vm-runtime.md b/docs/zh-CN/install/docker-vm-runtime.md
index 22edddf25..dfa2092f3 100644
--- a/docs/zh-CN/install/docker-vm-runtime.md
+++ b/docs/zh-CN/install/docker-vm-runtime.md
@@ -1,37 +1,37 @@
---
read_when:
- 你正在使用 Docker 在云 VM 上部署 OpenClaw
- - 你需要共享二进制文件的构建、持久化和更新流程
+ - 你需要共享二进制文件构建、持久化和更新流程
summary: 长期运行的 OpenClaw Gateway 网关主机的共享 Docker VM 运行时步骤
-title: Docker 虚拟机运行时
+title: Docker VM 运行时
x-i18n:
- generated_at: "2026-04-28T11:56:00Z"
+ generated_at: "2026-04-29T02:46:06Z"
model: gpt-5.5
provider: openai
- source_hash: c1561022cea1e8534f55942186def31d2cb11ab554351b0bf1d9b5940ad6458b
+ source_hash: 01ce5a7e58619da9c9ec97eb1e4f88323ab26f42f40e0a3d655b18019de798dd
source_path: install/docker-vm-runtime.md
workflow: 16
---
-基于 VM 的 Docker 安装(例如 GCP、Hetzner 和类似 VPS 提供商)的共享运行时步骤。
+基于 VM 的 Docker 安装(如 GCP、Hetzner 和类似 VPS 提供商)的共享运行时步骤。
-## 将必需二进制文件烘焙到镜像中
+## 将所需二进制文件烘焙进镜像
在运行中的容器内安装二进制文件是一个陷阱。
-任何在运行时安装的内容都会在重启后丢失。
+任何在运行时安装的内容都会在重启时丢失。
Skills 所需的所有外部二进制文件都必须在镜像构建时安装。
下面的示例仅展示三个常见二进制文件:
-- 用于 Gmail 访问的 `gog`
+- 用于 Gmail 访问的 `gog`(来自 `gogcli`)
- 用于 Google Places 的 `goplaces`
- 用于 WhatsApp 的 `wacli`
-这些只是示例,不是完整列表。
-你可以用相同模式安装所需的任意数量二进制文件。
+这些只是示例,并不是完整列表。
+你可以使用相同模式按需安装任意数量的二进制文件。
-如果之后添加依赖其他二进制文件的新 Skills,你必须:
+如果你之后添加了依赖其他二进制文件的新 Skills,必须:
1. 更新 Dockerfile
2. 重新构建镜像
@@ -44,17 +44,23 @@ 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 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
-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
+# 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
-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
+# 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
@@ -77,7 +83,7 @@ CMD ["node","dist/index.js"]
```
-上面的下载 URL 适用于 x86_64 (amd64)。对于基于 ARM 的 VM(例如 Hetzner ARM、GCP Tau T2A),请将下载 URL 替换为每个工具发布页面中的相应 ARM64 变体。
+上面的 URL 是示例。对于基于 ARM 的 VM,请选择 `arm64` 资源。为了构建可复现,请固定带版本的发布 URL。
## 构建并启动
@@ -88,7 +94,7 @@ docker compose up -d openclaw-gateway
```
如果构建在 `pnpm install --frozen-lockfile` 期间因 `Killed` 或 `exit code 137` 失败,说明 VM 内存不足。
-请先使用更大的机器规格,再重试。
+请先使用更大的机器规格再重试。
验证二进制文件:
@@ -118,23 +124,23 @@ docker compose logs -f openclaw-gateway
[gateway] listening on ws://0.0.0.0:18789
```
-## 持久化内容的位置
+## 哪些内容持久化在哪里
-OpenClaw 在 Docker 中运行,但 Docker 不是事实来源。
-所有长期状态都必须能在重启、重建和重新开机后保留下来。
+OpenClaw 在 Docker 中运行,但 Docker 不是真实数据源。
+所有长期状态都必须在重启、重建和重新开机后保留。
| 组件 | 位置 | 持久化机制 | 备注 |
| ------------------- | ---------------------------------------- | ---------------------- | ------------------------------------------------------------- |
| Gateway 网关配置 | `/home/node/.openclaw/` | 主机卷挂载 | 包含 `openclaw.json`、`.env` |
| 模型认证配置文件 | `/home/node/.openclaw/agents/` | 主机卷挂载 | `agents//agent/auth-profiles.json`(OAuth、API 密钥) |
-| Skills 配置 | `/home/node/.openclaw/skills/` | 主机卷挂载 | Skill 级状态 |
-| Agent 工作区 | `/home/node/.openclaw/workspace/` | 主机卷挂载 | 代码和智能体制品 |
+| Skill 配置 | `/home/node/.openclaw/skills/` | 主机卷挂载 | Skill 级状态 |
+| Agent 工作区 | `/home/node/.openclaw/workspace/` | 主机卷挂载 | 代码和 agent 工件 |
| WhatsApp 会话 | `/home/node/.openclaw/` | 主机卷挂载 | 保留二维码登录 |
| Gmail 密钥环 | `/home/node/.openclaw/` | 主机卷 + 密码 | 需要 `GOG_KEYRING_PASSWORD` |
| 插件运行时依赖 | `/var/lib/openclaw/plugin-runtime-deps/` | Docker 命名卷 | 生成的内置插件依赖和运行时镜像 |
-| 外部二进制文件 | `/usr/local/bin/` | Docker 镜像 | 必须在构建时烘焙 |
+| 外部二进制文件 | `/usr/local/bin/` | Docker 镜像 | 必须在构建时烘焙进去 |
| Node 运行时 | 容器文件系统 | Docker 镜像 | 每次镜像构建都会重建 |
-| OS 包 | 容器文件系统 | Docker 镜像 | 不要在运行时安装 |
+| OS 软件包 | 容器文件系统 | Docker 镜像 | 不要在运行时安装 |
| Docker 容器 | 临时 | 可重启 | 可以安全销毁 |
## 更新
@@ -147,7 +153,7 @@ docker compose build
docker compose up -d
```
-## 相关
+## 相关内容
- [Docker](/zh-CN/install/docker)
- [Podman](/zh-CN/install/podman)