快速开始
Docker 虚拟机运行时
适用于基于虚拟机的 Docker 安装（例如 GCP、Hetzner 和类似 VPS 提供商）的共享运行时步骤。
将所需二进制文件内置到镜像中
在运行中的容器内安装二进制文件是个陷阱：运行时安装的任何内容都会在重启后丢失。请在构建时将 Skills 所需的每个外部二进制文件都内置到镜像中。
以下示例仅涵盖三个二进制文件，按字母顺序排列：
gog（来自gogcli），用于访问 Gmailgoplaces，用于 Google Placeswacli，用于 WhatsApp
这些只是示例，并非完整列表。请使用相同模式安装你的 Skills 所需的所有二进制文件。如果你以后添加的 Skill 需要新的二进制文件：
- 更新 Dockerfile。
- 重新构建镜像。
- 重启容器。
Dockerfile 示例
FROM node:24-bookworm RUN apt-get update && apt-get install -y socat && rm -rf /var/lib/apt/lists/* # 示例二进制文件 1：Gmail CLI（gogcli — 安装为 `gog`）# 从 https://github.com/steipete/gogcli/releases 复制当前 Linux 资源 URLRUN 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 # 示例二进制文件 2：Google Places CLI# 从 https://github.com/steipete/goplaces/releases 复制当前 Linux 资源 URLRUN 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 # 示例二进制文件 3：WhatsApp CLI# 从 https://github.com/steipete/wacli/releases 复制当前 Linux 资源 URLRUN 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 # 使用相同模式在下方添加更多二进制文件 WORKDIR /appCOPY package.json pnpm-lock.yaml pnpm-workspace.yaml .npmrc ./COPY ui/package.json ./ui/package.jsonCOPY scripts ./scripts RUN corepack enableRUN pnpm install --frozen-lockfile COPY . .RUN pnpm buildRUN pnpm ui:installRUN pnpm ui:build ENV NODE_ENV=production CMD ["node","dist/index.js"]构建并启动
docker compose builddocker compose up -d openclaw-gateway如果在执行 pnpm install --frozen-lockfile 期间构建因 Killed 或退出代码 137 而失败，说明虚拟机内存不足。请改用更大的机器类型后再重试。
验证二进制文件：
docker compose exec openclaw-gateway which gogdocker compose exec openclaw-gateway which goplacesdocker compose exec openclaw-gateway which wacli预期输出：
/usr/local/bin/gog/usr/local/bin/goplaces/usr/local/bin/wacli验证 Gateway 网关已启动：
docker compose logs -f openclaw-gatewaycurl -fsS http://127.0.0.1:18789/healthz/healthz 返回 200 响应即表示 Gateway 网关进程正在监听且运行状况良好；镜像内置的 HEALTHCHECK 会轮询同一端点。
各类数据的持久化位置
OpenClaw 在 Docker 中运行，但 Docker 并非数据的权威来源。所有长期状态都必须能够在重启、重新构建和系统重启后保留。
| 组件 | 位置 | 持久化机制 | 说明 |
|---|---|---|---|
| Gateway 配置 | /home/node/.openclaw/ |
主机卷挂载 | 包含 openclaw.json |
| 渠道/提供商凭据 | /home/node/.openclaw/credentials/ |
主机卷挂载 | 渠道和提供商凭据材料 |
| 模型身份验证配置文件 | /home/node/.openclaw/agents/ |
主机卷挂载 | agents/<agentId>/agent/auth-profiles.json（OAuth、API 密钥） |
| 旧版 OAuth 密钥文件 | /home/node/.config/openclaw/ |
主机卷挂载 | 为迁移前的 OAuth 辅助文件提供只读兼容；openclaw doctor --fix 会将其迁移到 auth-profiles.json |
| Skill 配置 | /home/node/.openclaw/skills/ |
主机卷挂载 | Skill 级状态 |
| Agent 工作区 | /home/node/.openclaw/workspace/ |
主机卷挂载 | 代码和 Agent 产物 |
| WhatsApp 会话 | /home/node/.openclaw/ |
主机卷挂载 | 保留二维码登录状态 |
| Gmail 密钥环 | /home/node/.openclaw/ |
主机卷 + 密码 | 需要 GOG_KEYRING_PASSWORD |
| 插件包 | /home/node/.openclaw/npm, /home/node/.openclaw/git |
主机卷挂载 | 可下载插件包的根目录 |
| 外部二进制文件 | /usr/local/bin/ |
Docker 镜像 | 必须在构建时内置 |
| Node 运行时 | 容器文件系统 | Docker 镜像 | 每次构建镜像时重新构建 |
| 操作系统软件包 | 容器文件系统 | Docker 镜像 | 不要在运行时安装 |
| Docker 容器 | 临时 | 可重启 | 可安全销毁 |
更新
要更新虚拟机上的 OpenClaw：
git pulldocker compose builddocker compose up -d相关内容
Was this useful?
