安装托管
在 Debian 计算引擎 VM 上运行持久 OpenClaw 网关。本页面涵盖 GCP 配置、网络访问和机器操作;共享的 Docker VM 运行时 页面拥有容器设置、持久性、自定义二进制文件、验证和更新。
定价因机器类型和地区而异。至少使用 6 个 GB RAM 来构建源映像。在较小的计算机上,使用 Docker VM 运行时 中描述的官方预构建映像。
准备工作
- A GCP 启用计费的项目
gcloud CLI 或 云 Console
- 从你的笔记本电脑进行 SSH 访问
- 模型和可选通道凭证
- 大约 20 分钟。
提供VM
初始化 gcloud
从 cloud.google.com/sdk/docs/install 安装 CLI,然后进行身份验证:
bashgcloud initgcloud auth login
您可以在 Cloud Console 中执行相同的步骤。
创建项目
bashgcloud projects create my-openclaw-project --name="OpenClaw Gateway"gcloud config set project my-openclaw-projectgcloud services enable compute.googleapis.com
在计费控制台中启用计费。如果没有它,Compute Engine 将无法启动。
选择机器
| 类型 |
配置 |
笔记 |
| e2-标准-2 |
2 个 vCPU、8 个 GB RAM |
推荐用于源镜像构建 |
| e2-介质 |
2 个 vCPU、4 个 GB RAM |
使用官方预建镜像 |
| e2-小号 |
2 个 vCPU、2 个 GB RAM |
使用官方预建镜像 |
创建一个Debian 12 VM:
bashgcloud compute instances create openclaw-gateway \ --zone=us-central1-a \ --machine-type=e2-standard-2 \ --boot-disk-size=20GB \ --image-family=debian-12 \ --image-project=debian-cloud
检查防火墙访问
保持 TCP 18789 对公共互联网关闭。下面的SSH隧道只需要SSH访问VM:
bashgcloud compute firewall-rules list \ --format='table(name,network,direction,sourceRanges.list():label=SOURCE_RANGES,allowed[].map().firewall_rule().list():label=ALLOW)'
尽可能将 SSH 源范围限制在您的管理网络内。如果您有意通过反向代理或尾网公开网关,请遵循 Gateway security,而不是为端口 18789 添加广泛的 0.0.0.0/0 规则。
通过 SSH 连接
bashgcloud compute ssh openclaw-gateway --zone=us-central1-a
创建 VM 后,SSH 密钥传播可能需要一两分钟。如果第一次连接被拒绝,请等待并重试。
安装Docker
在 VM 上:
bashsudo apt-get updatesudo apt-get install -y git curl ca-certificatescurl -fsSL https://get.docker.com | sudo shsudo usermod -aG docker "$USER"exit
重新连接以使组更改生效,然后验证安装:
bashgcloud compute ssh openclaw-gateway --zone=us-central1-adocker --versiondocker compose version
配置Docker运行时
在 VM 上,按照 Docker VM 运行时 从 开始之前 到 验证并管理网关。维护的安装脚本默认使用这些 GCP 主机路径:
bashexport OPENCLAW_CONFIG_DIR="$HOME/.openclaw"export OPENCLAW_WORKSPACE_DIR="$HOME/.openclaw/workspace"export OPENCLAW_AUTH_PROFILE_SECRET_DIR="$HOME/.openclaw-auth-profile-secrets"
如果源构建以 Killed、ResourceExhausted 或退出代码 137 结束,请在重试之前调整 VM 的大小。
访问Control UI
从您的笔记本电脑中,打开 SSH 隧道并使其保持运行:
bashgcloud compute ssh openclaw-gateway --zone=us-central1-a -- -L 18789:127.0.0.1:18789
打开http://127.0.0.1:18789/。出现提示时,粘贴 VM 的 .env 中的网关令牌。要重新打印仪表板 URL 或批准浏览器设备,请在 VM 上运行:
bashcd openclawdocker compose run --rm openclaw-cli dashboard --no-opendocker compose run --rm openclaw-cli devices listdocker compose run --rm openclaw-cli devices approve <requestId>
故障排查
SSH 连接被拒绝
等待一两分钟以进行 SSH 密钥传播,然后重试。检查 VM 是否正在运行,以及入口防火墙规则是否允许来自当前网络的 TCP 22。
OS 登录问题
bashgcloud compute os-login describe-profile
检查您的帐户是否具有计算 OS 登录或计算 OS 管理员登录权限。
内存不足构建后调整大小
bashgcloud compute instances stop openclaw-gateway --zone=us-central1-agcloud compute instances set-machine-type openclaw-gateway \ --zone=us-central1-a \ --machine-type=e2-mediumgcloud compute instances start openclaw-gateway --zone=us-central1-a
使用部署服务帐号
对于个人设置,您的用户帐户就足够了。自动化应使用具有最窄角色的专用服务帐户:
bashgcloud iam service-accounts create openclaw-deploy \ --display-name="OpenClaw Deployment" gcloud projects add-iam-policy-binding my-openclaw-project \ --member="serviceAccount:[email protected]" \ --role="roles/compute.instanceAdmin.v1"
避免所有者角色。请参阅 了解角色。
下一步
相关内容