GCP

Cài đặt CLI gcloud (hoặc sử dụng Console)

Cài đặt từ cloud.google.com/sdk/docs/install, sau đó:

gcloud initgcloud auth login

Hoặc thay vào đó, thực hiện mọi bước bên dưới qua giao diện web Cloud Console.

Tạo một dự án GCP

gcloud projects create my-openclaw-project --name="OpenClaw Gateway"gcloud config set project my-openclaw-projectgcloud services enable compute.googleapis.com

Bật tính năng thanh toán tại console.cloud.google.com/billing (bắt buộc đối với Compute Engine).

Thao tác tương đương trong Console: IAM & Admin > Create Project, bật tính năng thanh toán, sau đó chọn APIs & Services > Enable APIs > "Compute Engine API" > Enable.

Tạo máy ảo

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

SSH vào máy ảo

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

Console: nhấp vào "SSH" bên cạnh máy ảo trong bảng điều khiển Compute Engine.

Việc truyền khóa SSH có thể mất 1-2 phút sau khi tạo máy ảo; hãy chờ rồi thử lại nếu kết nối bị từ chối.

Cài đặt Docker (trên máy ảo)

sudo apt-get updatesudo apt-get install -y git curl ca-certificatescurl -fsSL https://get.docker.com | sudo shsudo usermod -aG docker $USER

Đăng xuất rồi đăng nhập lại để thay đổi nhóm có hiệu lực, sau đó SSH vào lại:

exit

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

Xác minh:

docker --versiondocker compose version

Sao chép kho lưu trữ OpenClaw

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

Hướng dẫn này xây dựng một image tùy chỉnh để mọi tệp nhị phân bạn tích hợp vào đều tồn tại sau khi khởi động lại.

Tạo các thư mục bền vững trên máy chủ

Các container Docker chỉ tồn tại tạm thời; mọi trạng thái dài hạn phải nằm trên máy chủ.

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

Cấu hình biến môi trường

Tạo .env tại thư mục gốc của kho lưu trữ:

OPENCLAW_IMAGE=openclaw:latestOPENCLAW_GATEWAY_TOKEN=OPENCLAW_GATEWAY_BIND=lanOPENCLAW_GATEWAY_PORT=18789 OPENCLAW_CONFIG_DIR=/home/$USER/.openclawOPENCLAW_WORKSPACE_DIR=/home/$USER/.openclaw/workspace GOG_KEYRING_PASSWORD=XDG_CONFIG_HOME=/home/node/.openclaw

Đặt OPENCLAW_GATEWAY_TOKEN để quản lý token Gateway ổn định thông qua .env; nếu không, hãy cấu hình gateway.auth.token trước khi dựa vào các máy khách qua những lần khởi động lại. Nếu cả hai đều chưa được đặt, OpenClaw sử dụng một token chỉ dành cho thời gian chạy trong lần khởi động đó. Tạo mật khẩu chuỗi khóa cho GOG_KEYRING_PASSWORD:

openssl rand -hex 32

Không đưa tệp này vào commit. Tệp này chứa các biến môi trường của container/thời gian chạy như OPENCLAW_GATEWAY_TOKEN. Thông tin xác thực OAuth/khóa API của nhà cung cấp đã lưu nằm trong ~/.openclaw/agents/<agentId>/agent/auth-profiles.json được gắn kết.

Cấu hình Docker Compose

Tạo hoặc cập nhật 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:      # Khuyến nghị: chỉ cho phép truy cập Gateway qua loopback trên máy ảo; truy cập qua đường hầm SSH.      # Để mở công khai, hãy xóa tiền tố `127.0.0.1:` và cấu hình tường lửa phù hợp.      - "127.0.0.1:${OPENCLAW_GATEWAY_PORT}:18789"    command:      [        "node",        "dist/index.js",        "gateway",        "--bind",        "${OPENCLAW_GATEWAY_BIND}",        "--port",        "${OPENCLAW_GATEWAY_PORT}",        "--allow-unconfigured",      ]

--allow-unconfigured chỉ nhằm tạo thuận tiện khi khởi tạo, không thay thế cho cấu hình Gateway thực sự. Bạn vẫn phải thiết lập xác thực (gateway.auth.token hoặc mật khẩu) và chế độ liên kết an toàn cho môi trường triển khai.

Các bước thời gian chạy dùng chung cho máy ảo Docker

Làm theo hướng dẫn thời gian chạy dùng chung dành cho quy trình máy chủ Docker phổ biến:

• Tích hợp các tệp nhị phân cần thiết vào image
• Xây dựng và khởi chạy
• Dữ liệu nào được duy trì ở đâu
• Cập nhật

Lưu ý khởi chạy dành riêng cho GCP

Nếu quá trình xây dựng không thành công với Killed hoặc exit code 137 trong khi chạy pnpm install --frozen-lockfile, máy ảo đã hết bộ nhớ. Tối thiểu hãy sử dụng e2-small, hoặc dùng e2-medium để lần xây dựng đầu tiên đáng tin cậy hơn.

Khi liên kết với mạng LAN (OPENCLAW_GATEWAY_BIND=lan), hãy cấu hình một nguồn gốc trình duyệt đáng tin cậy trước khi tiếp tục:

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

Thay 18789 bằng cổng đã cấu hình nếu bạn đã thay đổi cổng đó.

Truy cập từ máy tính xách tay

Tạo một đường hầm SSH để chuyển tiếp cổng Gateway:

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

Mở http://127.0.0.1:18789/ trong trình duyệt của bạn.

In lại một liên kết bảng điều khiển sạch:

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

Nếu giao diện yêu cầu xác thực bằng bí mật dùng chung, hãy dán token hoặc mật khẩu đã cấu hình vào phần cài đặt Control UI (quy trình Docker này ghi token theo mặc định; nếu bạn đã chuyển sang xác thực bằng mật khẩu, hãy sử dụng mật khẩu đã cấu hình thay thế).

Nếu Control UI hiển thị unauthorized hoặc disconnected (1008): pairing required, hãy phê duyệt thiết bị trình duyệt:

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

Xem Thời gian chạy máy ảo Docker để biết sơ đồ lưu trữ bền vững dùng chung và quy trình cập nhật.