文档
平台与系统
GCP 计算引擎（Docker）

GCP 计算引擎（Docker）

适用范围

你希望把网关长期运行在云服务器上（可重启、可升级、可恢复），并用 Docker 保持运行环境一致。这里的建议是：

  • 网关容器化（Docker Compose）
  • ~/.clawdbot 与 ~/clawd 挂载到宿主机（重启/重建不丢）
  • VM 上保持 loopback-only，通过 SSH 隧道从本机访问控制台

前置条件

  • 已创建 GCP 项目并开通计费
  • 已创建 Compute Engine VM（Debian/Ubuntu 均可）
  • VM 上已安装 Docker + Docker Compose v2

最小可用流程

1) 准备持久化目录 

mkdir -p ~/.clawdbot
mkdir -p ~/clawd

2) 写 .env（不要提交到仓库） 

cat > .env <<'EOF'
CLAWDBOT_IMAGE=clawdbot:latest
CLAWDBOT_GATEWAY_TOKEN=change-me-now
CLAWDBOT_GATEWAY_BIND=lan
CLAWDBOT_GATEWAY_PORT=18789

CLAWDBOT_CONFIG_DIR=/home/$USER/.clawdbot
CLAWDBOT_WORKSPACE_DIR=/home/$USER/clawd

GOG_KEYRING_PASSWORD=change-me-now
XDG_CONFIG_HOME=/home/node/.clawdbot
EOF

3) 启动网关 

docker compose build
docker compose up -d clawdbot-gateway
docker compose logs -f clawdbot-gateway

4) 用 SSH 隧道访问控制台 

gcloud compute ssh clawdbot-gateway --zone=us-central1-a -- -L 18789:127.0.0.1:18789

浏览器打开：http://127.0.0.1:18789/

进一步阅读

  • Docker 说明：/docs/install/docker/
  • 网关安全：/docs/gateway/security/
Gateway 在 macOS 上的生命周期Hetzner 上的 Clawdbot（Docker，生产级 VPS 指南）