在 GCP Compute Engine 上部署 OpenClaw（Docker，正式環境 VPS 指南）

目標

在 GCP Compute Engine VM 上以 Docker 執行持久的 OpenClaw Gateway，具備持久狀態、寫入映像的二進位檔，以及安全的重啟行為。

若你想要「OpenClaw 全天候執行，每月約 $5-12」，這是 Google Cloud 上可靠的方案。費用依機器類型和區域而異；選擇符合工作負載的最小 VM，有需要再擴充。

我們要做什麼（白話版）？

建立 GCP 專案並啟用計費
建立 Compute Engine VM
安裝 Docker（隔離的應用程式執行環境）
在 Docker 中啟動 OpenClaw Gateway
將 ~/.openclaw + ~/.openclaw/workspace 持久化在主機上（重啟/重建後仍保留）
從筆電透過 SSH 通道存取 Control UI

Gateway 可透過以下方式存取：

從筆電進行 SSH port forwarding
若你自行管理防火牆和 token，也可直接暴露連接埠

本指南使用 GCP Compute Engine 上的 Debian。 Ubuntu 也可以；請對應調整套件。通用 Docker 流程參閱 Docker。

快速路徑（有經驗的管理者）

建立 GCP 專案 + 啟用 Compute Engine API
建立 Compute Engine VM（e2-small、Debian 12、20GB）
SSH 進入 VM
安裝 Docker
Clone OpenClaw 儲存庫
建立持久主機目錄
設定 .env 和 docker-compose.yml
將必要二進位檔寫入映像、建置並啟動

你需要什麼

GCP 帳號（e2-micro 可使用免費方案）
已安裝 gcloud CLI（或使用 Cloud Console）
從筆電 SSH 存取
基本的 SSH + 複製貼上能力
約 20-30 分鐘
Docker 和 Docker Compose
模型認證憑證
選用的供應商憑證
- WhatsApp QR
- Telegram bot token
- Gmail OAuth

1) 安裝 gcloud CLI（或使用 Console）

方法 A：gcloud CLI（建議用於自動化）

從 https://cloud.google.com/sdk/docs/install 安裝

初始化並認證：

gcloud init
gcloud auth login

方法 B：Cloud Console

所有步驟都可在 https://console.cloud.google.com 的網頁 UI 完成

2) 建立 GCP 專案

CLI：

gcloud projects create my-openclaw-project --name="OpenClaw Gateway"
gcloud config set project my-openclaw-project

在 https://console.cloud.google.com/billing 啟用計費（Compute Engine 必須）。

啟用 Compute Engine API：

gcloud services enable compute.googleapis.com

Console：

前往 IAM & Admin > Create Project
命名並建立
為專案啟用計費
前往 APIs & Services > Enable APIs > 搜尋「Compute Engine API」> Enable

3) 建立 VM

機器類型：

類型	規格	費用	備註
e2-medium	2 vCPU、4GB RAM	約 $25/月	本機 Docker 建置最穩定
e2-small	2 vCPU、2GB RAM	約 $12/月	Docker 建置的最低建議
e2-micro	2 vCPU（共享）、1GB RAM	可使用免費方案	Docker 建置常因 OOM 失敗（exit 137）

CLI：

gcloud compute instances create openclaw-gateway \
  --zone=us-central1-a \
  --machine-type=e2-small \
  --boot-disk-size=20GB \
  --image-family=debian-12 \
  --image-project=debian-cloud

Console：

前往 Compute Engine > VM instances > Create instance
名稱：openclaw-gateway
區域：us-central1、Zone：us-central1-a
機器類型：e2-small
開機磁碟：Debian 12、20GB
建立

4) SSH 進入 VM

CLI：

gcloud compute ssh openclaw-gateway --zone=us-central1-a

Console：

在 Compute Engine 儀表板中，點擊 VM 旁的「SSH」按鈕。

注意：VM 建立後 SSH 金鑰傳播可能需要 1-2 分鐘。若連線被拒，等待後重試。

5) 在 VM 上安裝 Docker

sudo apt-get update
sudo apt-get install -y git curl ca-certificates
curl -fsSL https://get.docker.com | sudo sh
sudo usermod -aG docker $USER

登出並重新登入讓群組變更生效：

exit

然後重新 SSH 進入：

gcloud compute ssh openclaw-gateway --zone=us-central1-a

驗證：

docker --version
docker compose version

6) Clone OpenClaw 儲存庫

git clone https://github.com/openclaw/openclaw.git
cd openclaw

本指南假設你會建置自訂映像以確保二進位檔持久保留。

7) 建立持久主機目錄

Docker 容器是暫時性的。所有長期狀態必須存放在主機上。

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

8) 設定環境變數

在儲存庫根目錄建立 .env。

OPENCLAW_IMAGE=openclaw:latest
OPENCLAW_GATEWAY_TOKEN=change-me-now
OPENCLAW_GATEWAY_BIND=lan
OPENCLAW_GATEWAY_PORT=18789

OPENCLAW_CONFIG_DIR=/home/$USER/.openclaw
OPENCLAW_WORKSPACE_DIR=/home/$USER/.openclaw/workspace

GOG_KEYRING_PASSWORD=change-me-now
XDG_CONFIG_HOME=/home/node/.openclaw

產生強密碼：

openssl rand -hex 32

請勿將此檔案 commit 到版本控制。

9) Docker Compose 設定

建立或更新 docker-compose.yml。

services:
  openclaw-gateway:
    image: ${OPENCLAW_IMAGE}
    build: .
    restart: unless-stopped
    env_file:
      - .env
    environment:
      - HOME=/home/node
      - NODE_ENV=production
      - TERM=xterm-256color
      - 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}
      - PATH=/home/linuxbrew/.linuxbrew/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
    volumes:
      - ${OPENCLAW_CONFIG_DIR}:/home/node/.openclaw
      - ${OPENCLAW_WORKSPACE_DIR}:/home/node/.openclaw/workspace
    ports:
      # 建議：在 VM 上保持 Gateway 僅限 loopback；透過 SSH 通道存取。
      # 若要公開暴露，移除 `127.0.0.1:` 前綴並相應設定防火牆。
      - "127.0.0.1:${OPENCLAW_GATEWAY_PORT}:18789"
    command:
      [
        "node",
        "dist/index.js",
        "gateway",
        "--bind",
        "${OPENCLAW_GATEWAY_BIND}",
        "--port",
        "${OPENCLAW_GATEWAY_PORT}",
      ]

10) 共用 Docker VM runtime 步驟

使用共用 runtime 指南進行通用 Docker 主機流程：

11) GCP 特定啟動注意事項

在 GCP 上，若建置時在 pnpm install --frozen-lockfile 期間出現 Killed 或 exit code 137，表示 VM 記憶體不足。最少使用 e2-small，或用 e2-medium 以確保首次建置更穩定。

綁定到 LAN（OPENCLAW_GATEWAY_BIND=lan）時，先設定信任的瀏覽器來源再繼續：

docker compose run --rm openclaw-cli config set gateway.controlUi.allowedOrigins '["http://127.0.0.1:18789"]' --strict-json

若你變更了閘道連接埠，將 18789 替換為你設定的連接埠。

12) 從筆電存取

建立 SSH 通道以轉發 Gateway 連接埠：

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

在瀏覽器中開啟：

http://127.0.0.1:18789/

取得新的帶 token dashboard 連結：

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

從 URL 中貼上 token。

若 Control UI 顯示 unauthorized 或 disconnected (1008): pairing required，核准瀏覽器裝置：

docker compose run --rm openclaw-cli devices list
docker compose run --rm openclaw-cli devices approve <requestId>

需要再次查看共用持久化和更新參考？參閱 Docker VM Runtime 和 Docker VM Runtime 更新。

疑難排解

SSH 連線被拒

VM 建立後 SSH 金鑰傳播可能需要 1-2 分鐘。等待後重試。

OS Login 問題

檢查你的 OS Login 設定檔：

gcloud compute os-login describe-profile

確認你的帳號具有必要的 IAM 權限（Compute OS Login 或 Compute OS Admin Login）。

記憶體不足（OOM）

若 Docker 建置出現 Killed 和 exit code 137，VM 被 OOM-killed。升級到 e2-small（最低）或 e2-medium（建議用於穩定的本機建置）：

# 先停止 VM
gcloud compute instances stop openclaw-gateway --zone=us-central1-a

# 變更機器類型
gcloud compute instances set-machine-type openclaw-gateway \
  --zone=us-central1-a \
  --machine-type=e2-small

# 啟動 VM
gcloud compute instances start openclaw-gateway --zone=us-central1-a

服務帳號（安全最佳實務）

個人使用時，你的預設使用者帳號就足夠了。

對於自動化或 CI/CD 管線，建立具有最小權限的專用服務帳號：

建立服務帳號：

gcloud iam service-accounts create openclaw-deploy \
  --display-name="OpenClaw Deployment"

授予 Compute Instance Admin 角色（或更窄的自訂角色）：

gcloud projects add-iam-policy-binding my-openclaw-project \
  --member="serviceAccount:[email protected]" \
  --role="roles/compute.instanceAdmin.v1"

避免對自動化使用 Owner 角色。遵循最小權限原則。

IAM 角色詳情參閱 https://cloud.google.com/iam/docs/understanding-roles。

後續步驟

設定訊息頻道：Channels
配對本機裝置為節點：Nodes
設定 Gateway：Gateway configuration