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

GCP 计算引擎（Docker）

适用范围

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

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

前置条件

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

最小可用流程

1) 准备持久化目录 

mkdir -p ~/.moltbot
mkdir -p ~/clawd

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

cat > .env <<'EOF'
MOLTBOT_IMAGE=moltbot:latest
MOLTBOT_GATEWAY_TOKEN=change-me-now
MOLTBOT_GATEWAY_BIND=lan
MOLTBOT_GATEWAY_PORT=18789

MOLTBOT_CONFIG_DIR=/home/$USER/.moltbot
MOLTBOT_WORKSPACE_DIR=/home/$USER/clawd

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

3) 启动网关 

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

4) 用 SSH 隧道访问控制台 

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

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

进一步阅读

  • Docker 说明（英文）：/en/docs/install/docker/
  • 网关安全：/zh-cn/docs/gateway/security/
Gateway on macOS (external launchd)Health Checks on macOS