Skip to main content

Documentation Index

Fetch the complete documentation index at: https://openclaw.zhcndoc.com/llms.txt

Use this file to discover all available pages before exploring further.

适用于基于 VM 的 Docker 安装的共享运行时步骤，例如 GCP、Hetzner 以及类似的 VPS 提供商。

​
将所需二进制文件烘焙进镜像

在运行中的容器里安装二进制文件是一个陷阱。 任何在运行时安装的内容都会在重启后丢失。 技能所需的所有外部二进制文件都必须在镜像构建时安装。 下面的示例只展示了三个常见二进制文件：
  • gog（来自 gogcli），用于 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/*

# 示例二进制文件 1：Gmail CLI（gogcli — 安装后名为 `gog`）
# 从 https://github.com/steipete/gogcli/releases 复制当前 Linux 资源 URL
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

# 示例二进制文件 2：Google Places CLI
# 从 https://github.com/steipete/goplaces/releases 复制当前 Linux 资源 URL
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

# 示例二进制文件 3：WhatsApp CLI
# 从 https://github.com/steipete/wacli/releases 复制当前 Linux 资源 URL
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

# 在下面使用相同模式添加更多二进制文件

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"]
上面的 URL 只是示例。对于基于 ARM 的 VM，请选择 arm64 资源。为了可复现构建，请固定到带版本号的发布 URL。

​
构建和启动

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
验证 Gateway： 
docker compose logs -f openclaw-gateway
预期输出： 
[gateway] listening on ws://0.0.0.0:18789

​
哪些内容存放在哪里

OpenClaw 运行在 Docker 中，但 Docker 不是事实来源。 所有长期状态都必须能在重启、重新构建和重启系统后保留。
组件位置持久化机制说明
Gateway 配置/home/node/.openclaw/主机卷挂载包含 openclaw.json、.env
模型认证配置/home/node/.openclaw/agents/主机卷挂载agents/<agentId>/agent/auth-profiles.json（OAuth、API 密钥）
技能配置/home/node/.openclaw/skills/主机卷挂载技能级状态
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 镜像每次镜像构建时都会重新构建
OS 包容器文件系统Docker 镜像不要在运行时安装
Docker 容器临时可重启可安全销毁

​
更新

要在 VM 上更新 OpenClaw： 
git pull
docker compose build
docker compose up -d

​
相关