英文 Docker VM Runtime
约 2 分钟
- 原始链接：https://docs.openclaw.ai/install/docker-vm-runtime
- 来源章节：3. 官方文档：安装、升级与部署
- 来源小节：无
- 抓取方式：jina:https://r.jina.ai/http://docs.openclaw.ai/install/docker-vm-runtime
- 抓取时间：2026-04-05 13:47:10
- 状态：ok
中文内容
基于 VM 的 Docker 安装（例如 GCP、Hetzner 和类似的 VPS 提供商）的共享运行时步骤。
将所需的二进制文件烘焙到镜像中
在正在运行的容器内安装二进制文件是一个陷阱。在运行时安装的任何内容都将在重新启动时丢失。技能所需的所有外部二进制文件都必须在映像构建时安装。下面的示例仅显示三个常见的二进制文件：
gog用于 Gmail 访问 *“goplaces”用于 Google 地方信息- WhatsApp 的“wacli”
这些只是示例，并非完整列表。您可以使用相同的模式根据需要安装任意数量的二进制文件。如果您稍后添加依赖于其他二进制文件的新技能，您必须：
1.更新Dockerfile 2. 重建镜像 3. 重启容器
示例 Dockerfile
来自节点：24-书虫
运行 apt-get update && apt-get install -y socat && rm -rf /var/lib/apt/lists/*
# 二进制示例 1：Gmail CLI
运行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
# 二进制示例 2：Google Places CLI
运行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
# 二进制示例 3：WhatsApp CLI
运行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
# 使用相同的模式在下面添加更多二进制文件
工作目录/应用程序
复制 package.json pnpm-lock.yaml pnpm-workspace.yaml .npmrc ./
复制 ui/package.json ./ui/package.json
复制脚本./scripts
RUN 核心包启用
运行 pnpm install --frozen-lockfile
复制。 。
运行 pnpm 构建
运行 pnpm ui：安装
运行 pnpm ui:build
ENV NODE_ENV=生产
CMD ["节点","dist/index.js"]构建并启动
docker 撰写构建
docker compose up -d openclaw-gateway如果在“pnpm install --frozen-lockfile”期间构建失败并显示“Killed”或“退出代码 137”，则 VM 内存不足。在重试之前使用更大的机器类。验证二进制文件：
docker compose exec openclaw-gateway which gog
docker compose exec openclaw-gateway 其中 goplaces
docker compose exec openclaw-gateway which wacli预期输出：
/usr/local/bin/gog
/usr/local/bin/goplaces
/usr/local/bin/wacli验证网关：
docker compose 日志 -f openclaw-gateway预期输出：
[网关] 监听 ws://0.0.0.0:18789哪里仍然存在
OpenClaw 在 Docker 中运行，但 Docker 并不是事实的来源。所有长期存在的状态都必须在重新启动、重建和重新引导后继续存在。
| 组件 | 地点 | 持久化机制 | 笔记 |
|---|---|---|---|
| 网关配置 | /home/node/.openclaw/ | 主机卷挂载 | 包括 openclaw.json、.env |
| 模型授权配置文件 | /home/node/.openclaw/agents/ | 主机卷挂载 | agents/<agentId>/agent/auth-profiles.json（OAuth、API 密钥） |
| 技能配置 | /home/node/.openclaw/skills/ | 主机卷挂载 | 技能水平状态 |
| 代理工作区 | /home/node/.openclaw/workspace/ | 主机卷挂载 | 代码和代理工件 |
| WhatsApp 会话 | /home/node/.openclaw/ | 主机卷挂载 | 保留二维码登录 |
| Gmail 钥匙圈 | /home/node/.openclaw/ | 主机音量+密码 | 需要GOG_KEYRING_PASSWORD |
| 外部二进制文件 | /usr/local/bin/ | Docker 镜像 | 必须在构建时烘烤 |
| 节点运行时 | 容器文件系统 | Docker 镜像 | 重建每个镜像构建 |
| 操作系统包 | 容器文件系统 | Docker 镜像 | 不要在运行时安装 |
| Docker 容器 | 短暂的 | 可重新启动 | 安全销毁 |
更新
要在虚拟机上更新 OpenClaw：
git拉
docker 撰写构建
docker 组成-d