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)