GCP

gcloud CLI kurun (veya Console kullanın)

Seçenek A: gcloud CLI (otomasyon için önerilir)

https://cloud.google.com/sdk/docs/install adresinden kurun

Başlatın ve kimlik doğrulaması yapın:

gcloud init
gcloud auth login

Seçenek B: Cloud Console

Tüm adımlar https://console.cloud.google.com adresindeki web UI üzerinden yapılabilir

Bir GCP projesi oluşturun

CLI:

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

Faturalandırmayı https://console.cloud.google.com/billing adresinden etkinleştirin (Compute Engine için gereklidir).

Compute Engine API'yi etkinleştirin:

gcloud services enable compute.googleapis.com

Console:

1. IAM & Admin > Create Project'e gidin
2. Adlandırın ve oluşturun
3. Proje için faturalandırmayı etkinleştirin
4. APIs & Services > Enable APIs'ye gidin > "Compute Engine API" arayın > etkinleştirin

VM'i oluşturun

Makine türleri:

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. Compute Engine > VM instances > Create instance'a gidin
2. Ad: openclaw-gateway
3. Bölge: us-central1, Zon: us-central1-a
4. Makine türü: e2-small
5. Önyükleme diski: Debian 12, 20GB
6. Oluşturun

VM'e SSH ile bağlanın

CLI:

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

Console:

Compute Engine panosunda VM'inizin yanındaki "SSH" düğmesine tıklayın.

Not: SSH anahtarı yayılımı VM oluşturulduktan sonra 1-2 dakika sürebilir. Bağlantı reddedilirse bekleyin ve yeniden deneyin.

Docker kurun (VM üzerinde)

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

Grup değişikliğinin etkili olması için çıkış yapıp tekrar giriş yapın:

exit

Ardından tekrar SSH ile bağlanın:

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

Doğrulayın:

docker --version
docker compose version

OpenClaw deposunu klonlayın

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

Bu kılavuz, ikili dosya kalıcılığını garanti etmek için özel bir imaj derleyeceğinizi varsayar.

Kalıcı ana makine dizinleri oluşturun

Docker kapsayıcıları geçicidir. Tüm uzun ömürlü durum ana makinede yaşamalıdır.

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

Ortam değişkenlerini yapılandırın

Depo kökünde .env oluşturun.

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

Kararlı gateway token'ını .env üzerinden yönetmek istediğinizde OPENCLAW_GATEWAY_TOKEN ayarlayın; aksi takdirde yeniden başlatmalar arasında istemcilere güvenmeden önce gateway.auth.token yapılandırın. İki kaynak da yoksa OpenClaw bu başlatma için yalnızca çalışma zamanına ait bir token kullanır. Bir keyring parolası oluşturun ve GOG_KEYRING_PASSWORD içine yapıştırın:

openssl rand -hex 32

Bu dosyayı commit etmeyin.

Bu .env dosyası OPENCLAW_GATEWAY_TOKEN gibi kapsayıcı/çalışma zamanı env değerleri içindir. Saklanan sağlayıcı OAuth/API anahtarı kimlik doğrulaması, bağlanan ~/.openclaw/agents/<agentId>/agent/auth-profiles.json içinde yaşar.

Docker Compose yapılandırması

docker-compose.yml oluşturun veya güncelleyin.

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:
      # Recommended: keep the Gateway loopback-only on the VM; access via SSH tunnel.
      # To expose it publicly, remove the `127.0.0.1:` prefix and firewall accordingly.
      - "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 yalnızca önyükleme kolaylığı içindir; uygun bir gateway yapılandırmasının yerine geçmez. Yine de dağıtımınız için kimlik doğrulamayı (gateway.auth.token veya parola) ayarlayın ve güvenli bind ayarları kullanın.

Paylaşılan Docker VM çalışma zamanı adımları

Ortak Docker ana makine akışı için paylaşılan çalışma zamanı kılavuzunu kullanın:

• Gerekli ikili dosyaları imaja yerleştirin
• Derleyin ve başlatın
• Nerede ne kalıcı olur
• Güncellemeler

GCP'ye özgü başlatma notları

GCP üzerinde derleme pnpm install --frozen-lockfile sırasında Killed veya exit code 137 ile başarısız olursa, VM'in belleği tükenmiştir. En az e2-small kullanın; daha güvenilir ilk derlemeler için e2-medium kullanın.

LAN'a bind ederken (OPENCLAW_GATEWAY_BIND=lan), devam etmeden önce güvenilir bir tarayıcı origin'i yapılandırın:

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

Gateway portunu değiştirdiyseniz 18789 yerine yapılandırdığınız portu kullanın.

Dizüstü bilgisayarınızdan erişin

Gateway portunu yönlendirmek için bir SSH tüneli oluşturun:

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

Tarayıcınızda açın:

http://127.0.0.1:18789/

Temiz bir pano bağlantısını yeniden yazdırın:

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

UI paylaşılan gizli anahtar kimlik doğrulaması isterse, yapılandırılmış token'ı veya parolayı Control UI ayarlarına yapıştırın. Bu Docker akışı varsayılan olarak bir token yazar; kapsayıcı yapılandırmasını parola kimlik doğrulamasına geçirirseniz bunun yerine o parolayı kullanın.

Control UI unauthorized veya disconnected (1008): pairing required gösterirse, tarayıcı cihazını onaylayın:

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

Paylaşılan kalıcılık ve güncelleme referansına tekrar mı ihtiyacınız var? Bkz. Docker VM Runtime ve Docker VM Runtime güncellemeleri.