GCP

Zainstaluj gcloud CLI (albo użyj Console)

Opcja A: gcloud CLI (zalecane do automatyzacji)

Zainstaluj z https://cloud.google.com/sdk/docs/install

Zainicjuj i uwierzytelnij:

gcloud init
gcloud auth login

Opcja B: Cloud Console

Wszystkie kroki można wykonać w interfejsie webowym pod adresem https://console.cloud.google.com

Utwórz projekt GCP

CLI:

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

Włącz rozliczenia na https://console.cloud.google.com/billing (wymagane dla Compute Engine).

Włącz Compute Engine API:

gcloud services enable compute.googleapis.com

Console:

1. Przejdź do IAM & Admin > Create Project
2. Nadaj nazwę i utwórz
3. Włącz rozliczenia dla projektu
4. Przejdź do APIs & Services > Enable APIs > wyszukaj „Compute Engine API” > Enable

Utwórz maszynę wirtualną

Typy maszyn:

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:

1. Przejdź do Compute Engine > VM instances > Create instance
2. Nazwa: openclaw-gateway
3. Region: us-central1, strefa: us-central1-a
4. Typ maszyny: e2-small
5. Dysk rozruchowy: Debian 12, 20 GB
6. Utwórz

Połącz się z maszyną wirtualną przez SSH

CLI:

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

Console:

Kliknij przycisk „SSH” obok swojej maszyny wirtualnej w panelu Compute Engine.

Uwaga: propagacja klucza SSH może potrwać 1-2 minuty po utworzeniu maszyny wirtualnej. Jeśli połączenie zostanie odrzucone, poczekaj i spróbuj ponownie.

Zainstaluj Docker (na maszynie wirtualnej)

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

Wyloguj się i zaloguj ponownie, aby zmiana grupy zaczęła obowiązywać:

exit

Następnie ponownie połącz się przez SSH:

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

Zweryfikuj:

docker --version
docker compose version

Sklonuj repozytorium OpenClaw

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

Ten przewodnik zakłada, że zbudujesz niestandardowy obraz, aby zagwarantować trwałość plików binarnych.

Utwórz trwałe katalogi hosta

Kontenery Docker są efemeryczne. Cały długotrwały stan musi znajdować się na hoście.

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

Skonfiguruj zmienne środowiskowe

Utwórz .env w katalogu głównym repozytorium.

OPENCLAW_IMAGE=openclaw:latest
OPENCLAW_GATEWAY_TOKEN=
OPENCLAW_GATEWAY_BIND=lan
OPENCLAW_GATEWAY_PORT=18789

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

GOG_KEYRING_PASSWORD=
XDG_CONFIG_HOME=/home/node/.openclaw

Ustaw OPENCLAW_GATEWAY_TOKEN, gdy chcesz zarządzać stabilnym tokenem Gateway przez .env; w przeciwnym razie skonfiguruj gateway.auth.token przed poleganiem na klientach między ponownymi uruchomieniami. Jeśli żadne ze źródeł nie istnieje, OpenClaw używa tokenu tylko na czas działania dla tego uruchomienia. Wygeneruj hasło keyring i wklej je do GOG_KEYRING_PASSWORD:

openssl rand -hex 32

Nie commituj tego pliku.

Ten plik .env służy do zmiennych środowiskowych kontenera/środowiska uruchomieniowego, takich jak OPENCLAW_GATEWAY_TOKEN. Przechowywane uwierzytelnianie OAuth/kluczem API dostawcy znajduje się w zamontowanym ~/.openclaw/agents/<agentId>/agent/auth-profiles.json.

Konfiguracja Docker Compose

Utwórz lub zaktualizuj 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:
      # Zalecane: pozostaw Gateway dostępny tylko przez loopback na maszynie wirtualnej; uzyskuj dostęp przez tunel SSH.
      # Aby wystawić go publicznie, usuń prefiks `127.0.0.1:` i odpowiednio skonfiguruj zaporę.
      - "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 służy tylko wygodzie podczas bootstrapu; nie zastępuje właściwej konfiguracji Gateway. Nadal ustaw uwierzytelnianie (gateway.auth.token albo hasło) i używaj bezpiecznych ustawień bindowania dla swojego wdrożenia.

Wspólne kroki środowiska uruchomieniowego maszyny wirtualnej Docker

Użyj wspólnego przewodnika środowiska uruchomieniowego dla typowego przepływu hosta Docker:

• Wbuduj wymagane pliki binarne do obrazu
• Zbuduj i uruchom
• Co gdzie jest utrwalane
• Aktualizacje

Uwagi uruchomieniowe specyficzne dla GCP

W GCP, jeśli build kończy się niepowodzeniem z Killed albo exit code 137 podczas pnpm install --frozen-lockfile, maszynie wirtualnej zabrakło pamięci. Użyj co najmniej e2-small albo e2-medium dla bardziej niezawodnych pierwszych buildów.

Przy bindowaniu do sieci LAN (OPENCLAW_GATEWAY_BIND=lan) skonfiguruj zaufane źródło przeglądarki przed kontynuowaniem:

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

Jeśli zmieniono port Gateway, zastąp 18789 skonfigurowanym portem.

Dostęp z laptopa

Utwórz tunel SSH, aby przekierować port Gateway:

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

Otwórz w przeglądarce:

http://127.0.0.1:18789/

Ponownie wyświetl czysty link do panelu:

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

Jeśli UI poprosi o uwierzytelnianie wspólnym sekretem, wklej skonfigurowany token albo hasło w ustawieniach Control UI. Ten przepływ Docker domyślnie zapisuje token; jeśli przełączysz konfigurację kontenera na uwierzytelnianie hasłem, użyj zamiast tego tego hasła.

Jeśli Control UI pokazuje unauthorized albo disconnected (1008): pairing required, zatwierdź urządzenie przeglądarki:

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

Potrzebujesz ponownie odniesienia do wspólnej trwałości i aktualizacji? Zobacz Docker VM Runtime oraz aktualizacje Docker VM Runtime.