Install 导读

GCP 上跑 OpenClaw:持久化、低成本的 Docker 部署方案

本页带你从零在 GCP Compute Engine 上部署一个 24/7 运行的 OpenClaw 网关,核心是挂载宿主机的 `~/.openclaw` 目录来持久化配置和 workspace,确保重启或重建容器后状态不丢。新手先看“What are we doing”的步骤清单,老手直接跳“Quick path”。最容易翻车的是忘记挂载持久化目录,导致容器重启后所有配置丢失。

先讲这一页到底在解决什么

GCP 上跑 OpenClaw:持久化、低成本的 Docker 部署方案

本页带你从零在 GCP Compute Engine 上部署一个 24/7 运行的 OpenClaw 网关,核心是挂载宿主机的 `~/.openclaw` 目录来持久化配置和 workspace,确保重启或重建容器后状态不丢。新手先看“What are we doing”的步骤清单,老手直接跳“Quick path”。最容易翻车的是忘记挂载持久化目录,导致容器重启后所有配置丢失。

原文共 8 节,先看 Start Here 路径:/install/gcp 查看官方原文

第一站

🏗️ 这页的剧情很简单:建项目、建机器、装 Docker、再把 Gateway 搬进去

只要你把它想成搭一个长期值班机房,就不容易乱。

☁️

GCP project

像先拿下一块云地皮。

🖥️

Compute Engine VM

真正住 Docker 和 Gateway 的房间。

📦

Docker

OpenClaw 在这里被装成一个长期可重启的箱子。

🔌

SSH tunnel

控制台默认最好走私人电话线,不要急着敞公网门。

第二站

🧮 机型选择那一段,翻成人话就是“别给值班机房配太瘦的桌子”

官方把内存问题说得很实在。

🥇 e2-small

像最低能用的桌子,2GB 内存是 Docker 本地构建的起步线。

💪 e2-medium

更像稳妥办公桌,本地 build 更不容易 OOM。

🪑 e2-micro

像太瘦的小凳子,虽然便宜,但很容易在构建时被压垮。

🎈 一句话

想少看 exit 137,就别把 GCP 机型压得太狠。

第三站

📁 持久目录和 .env,其实是在告诉 Docker:“哪些家当必须留在屋外,别锁死在箱子里”

这是这页最关键的运维意识。

mkdir -p ~/.openclaw ~/.openclaw/workspace

像先在宿主机上腾出家和工作台,确保换箱子也不丢。

OPENCLAW_GATEWAY_TOKEN=...

像总控室门票,必须自己认真生成,不要随便写个 change-me 就算了。

OPENCLAW_GATEWAY_BIND=lan

像告诉箱子:“你要对外部代理开门,不只是对自己嘀咕。”

--allow-unconfigured

只是临时让机器先点亮,不等于你以后就可以一直不写正式配置。

第四站

🔌 最后那段访问流程,本质就是“用 SSH 隧道把云机控制台拖回自己电脑,再做设备批准”

这部分很值得照着做。

gcloud compute ssh ... -- -L 18789:127.0.0.1:18789

像从 GCP 机房拉一条私人电话线,把控制台门口牵回本地。

docker compose run --rm openclaw-cli dashboard --no-open

像让箱子里的管理员把带 token 的正式门票地址再报一遍。

devices list / devices approve

如果控制台说要 pairing,这两条命令就是去门卫登记簿里把浏览器设备批准进门。

🎈 收尾一句

GCP 这条路不是难在 Docker,而是难在你要把“容器会失忆、宿主机不该失忆”这件事想明白。