13.10 GCP部署 - OpenClaw中文社区

通过 Docker 在 Google Cloud Platform (GCP) Compute Engine 上部署 OpenClaw Gateway——持久化状态、预装二进制文件、SSH 隧道访问 UI，月费用约 $5-12。

目标

在 GCP Compute Engine 虚拟机上使用 Docker 运行 OpenClaw Gateway，实现持久化状态存储、预装必需的二进制文件，并通过 SSH 隧道安全访问控制界面。适合需要 24/7 运行且成本可控的场景。

所需准备

GCP 账户（有免费额度可用）
基本的 SSH 和命令行操作经验
大约 20-30 分钟时间
Docker 和 Docker Compose 知识
模型 API 密钥（Anthropic、OpenAI 等）
可选：频道凭证（WhatsApp、Telegram 等）

快速路径（有经验的用户）

通过 CLI 或控制台创建 GCP VM
配置 VM（推荐 e2-small 类型）
安装 Docker
挂载卷用于 ~/.openclaw 目录
配置 .env 和 docker-compose.yml
将所需二进制文件（如 gog、goplaces、wacli）预装到镜像中
构建并运行：docker compose up -d
验证持久化和 Gateway 访问

1) 创建 VM 实例

通过 gcloud CLI 或 GCP 控制台创建虚拟机：

# 使用 gcloud CLI 创建 VM
gcloud compute instances create openclaw-gateway \
  --zone=us-central1-a \
  --machine-type=e2-small \
  --image-family=debian-11 \
  --image-project=debian-cloud \
  --boot-disk-size=20GB \
  --tags=openclaw

提示

推荐机器类型：e2-small（2 vCPU，2GB 内存）。e2-micro 内存可能不足导致 OOM 错误。

2) 连接到 VM

# 通过 SSH 连接
gcloud compute ssh openclaw-gateway --zone=us-central1-a

3) 安装 Docker

# 在 VM 上安装 Docker
sudo apt-get update
sudo apt-get install -y git curl ca-certificates
curl -fsSL https://get.docker.com | sudo sh

# 验证安装
docker --version
docker compose version

4) 创建持久化存储目录

Docker 容器是临时的，所有长期状态必须存储在主机上：

# 创建目录
sudo mkdir -p /var/openclaw
sudo mkdir -p /var/openclaw/workspace

# 设置权限（容器用户 uid 1000）
sudo chown -R 1000:1000 /var/openclaw
sudo chown -R 1000:1000 /var/openclaw/workspace

5) 克隆仓库并配置

# 克隆 OpenClaw 仓库
git clone https://github.com/openclaw/openclaw.git
cd openclaw

创建 .env 文件

# 创建环境变量配置文件
cat > .env <<'EOF'
OPENCLAW_IMAGE=openclaw:latest
OPENCLAW_GATEWAY_TOKEN=your-secure-token-here
OPENCLAW_GATEWAY_BIND=lan
OPENCLAW_GATEWAY_PORT=18789
OPENCLAW_CONFIG_DIR=/var/openclaw
OPENCLAW_WORKSPACE_DIR=/var/openclaw/workspace
GOG_KEYRING_PASSWORD=your-keyring-password-here
XDG_CONFIG_HOME=/home/node/.openclaw
EOF

# 生成安全的令牌
openssl rand -hex 32

安全警告

不要提交 .env 文件到版本控制！使用强密码和令牌。

6) 配置 docker-compose.yml

services:
  openclaw-gateway:
    image: ${OPENCLAW_IMAGE}
    build: .
    restart: unless-stopped
    env_file:
      - .env
    environment:
      - HOME=/home/node
      - NODE_ENV=production
      - OPENCLAW_GATEWAY_BIND=${OPENCLAW_GATEWAY_BIND}
      - OPENCLAW_GATEWAY_PORT=${OPENCLAW_GATEWAY_PORT}
      - OPENCLAW_GATEWAY_TOKEN=${OPENCLAW_GATEWAY_TOKEN}
      - GOG_KEYRING_PASSWORD=${GOG_KEYRING_PASSWORD}
      - XDG_CONFIG_HOME=${XDG_CONFIG_HOME}
    volumes:
      - ${OPENCLAW_CONFIG_DIR}:/home/node/.openclaw
      - ${OPENCLAW_WORKSPACE_DIR}:/home/node/.openclaw/workspace
    ports:
      - "127.0.0.1:${OPENCLAW_GATEWAY_PORT}:18789"
    command: ["node", "dist/index.js", "gateway", "--bind", "${OPENCLAW_GATEWAY_BIND}", "--port", "${OPENCLAW_GATEWAY_PORT}"]

7) 预装二进制文件（关键步骤）

在运行中的容器内安装二进制文件会在重启后丢失。所有外部二进制文件必须在构建镜像时预装。

以下是三个常用二进制文件的示例：

gog - Gmail 访问
goplaces - Google Places API
wacli - WhatsApp CLI

示例 Dockerfile

FROM node:22-bookworm

# 安装系统依赖
RUN apt-get update && apt-get install -y socat && rm -rf /var/lib/apt/lists/*

# 示例二进制文件 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

# 示例二进制文件 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

# 示例二进制文件 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

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

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"]

8) 构建并启动

# 构建自定义镜像
docker compose build

# 启动 Gateway
docker compose up -d openclaw-gateway

# 验证二进制文件已安装
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

9) 验证 Gateway

# 查看日志
docker compose logs -f openclaw-gateway

成功启动的标志：

[gateway] listening on ws://0.0.0.0:18789

10) 通过 SSH 隧道访问控制界面

在本地计算机上运行：

# 创建 SSH 隧道
gcloud compute ssh openclaw-gateway \
  --zone=us-central1-a \
  -- -N -L 18789:127.0.0.1:18789

然后在浏览器中打开 http://127.0.0.1:18789/，使用您的 Gateway 令牌进行认证。

持久化数据说明

组件	位置	持久化机制	备注
Gateway 配置	/home/node/.openclaw/	主机卷挂载	包含 openclaw.json、令牌
模型认证配置	/home/node/.openclaw/	主机卷挂载	OAuth 令牌、API 密钥
技能配置	/home/node/.openclaw/skills/	主机卷挂载	技能级别状态
Agent 工作区	/home/node/.openclaw/workspace/	主机卷挂载	代码和 agent 产物
WhatsApp 会话	/home/node/.openclaw/	主机卷挂载	保留 QR 登录状态
外部二进制文件	/usr/local/bin/	Docker 镜像	必须在构建时预装
Docker 容器	临时	可重启	可以安全销毁

故障排查

OOM（内存不足）错误

如果容器不断重启或被杀死，可能是内存不足。升级到 e2-small 或更大的机器类型。

SSH 连接延迟

初次连接可能需要几秒钟。如果超时，请检查防火墙规则和 VM 状态。

二进制文件丢失

如果重启后二进制文件丢失，说明它们是在运行时安装的。必须更新 Dockerfile 并重新构建镜像。

更新

# 拉取最新代码
git pull

# 重新构建和重启
docker compose build
docker compose up -d openclaw-gateway

# 验证健康状态
docker compose logs -f openclaw-gateway

安全最佳实践

使用服务账户而非个人账户
限制防火墙规则仅允许必需的入站连接
定期轮换 Gateway 令牌和 API 密钥
启用 GCP 审计日志
使用 Secret Manager 存储敏感凭证
保持端口 18789 仅绑定到 localhost，通过 SSH 隧道访问

成本估算

使用推荐配置（e2-small，20GB 磁盘）：

计算：约 $12-15/月（全月运行）
存储：约 $0.40/月（20GB 标准持久化磁盘）
网络：根据使用量而定，通常 < $1/月
总计：约 $13-16/月

最佳实践