GCP

gcloud CLI'yi yükleyin (veya Console'u kullanın)

cloud.google.com/sdk/docs/install adresinden yükleyin, ardından:

gcloud initgcloud auth login

Alternatif olarak aşağıdaki tüm adımları Cloud Console web arayüzü üzerinden gerçekleştirin.

Bir GCP projesi oluşturun

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

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

Console'daki karşılığı: IAM & Admin > Create Project yolunu izleyin, faturalandırmayı etkinleştirin, ardından APIs & Services > Enable APIs > "Compute Engine API" > Enable yolunu izleyin.

VM'yi oluşturun

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

VM'ye SSH ile bağlanın

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

Console: Compute Engine kontrol panelinde VM'nin yanındaki "SSH" seçeneğine tıklayın.

SSH anahtarının yayılması VM oluşturulduktan sonra 1-2 dakika sürebilir; bağlantı reddedilirse bekleyip yeniden deneyin.

Docker'ı yükleyin (VM üzerinde)

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

Grup değişikliğinin uygulanması için oturumu kapatıp yeniden açın, ardından tekrar SSH ile bağlanın:

exit

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

Doğrulayın:

docker --versiondocker compose version

OpenClaw deposunu klonlayın

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

Bu kılavuz, imaja gömdüğünüz ikili dosyaların yeniden başlatmalardan sonra korunması için özel bir imaj derler.

Kalıcı ana makine dizinlerini oluşturun

Docker konteynerleri geçicidir; tüm uzun ömürlü durum ana makinede tutulmalıdır.

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

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

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

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

Kararlı Gateway token'ını .env üzerinden yönetmek için OPENCLAW_GATEWAY_TOKEN değerini ayarlayın; aksi takdirde, yeniden başlatmalar arasında istemcilere güvenmeden önce gateway.auth.token yapılandırmasını yapın. Hiçbiri ayarlanmazsa OpenClaw, söz konusu başlatma için yalnızca çalışma zamanında geçerli bir token kullanır. GOG_KEYRING_PASSWORD için bir anahtarlık parolası oluşturun:

openssl rand -hex 32

Bu dosyayı commit etmeyin. OPENCLAW_GATEWAY_TOKEN gibi konteyner/çalışma zamanı ortam değişkenlerini içerir. Saklanan sağlayıcı OAuth/API anahtarıyla kimlik doğrulama bilgileri bağlanan ~/.openclaw/agents/<agentId>/agent/auth-profiles.json içinde bulunur.

Docker Compose yapılandırması

docker-compose.yml dosyasını 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:      # Önerilen: Gateway'i VM üzerinde yalnızca geri döngü arabiriminde tutun; SSH tüneli üzerinden erişin.      # Herkese açık hâle getirmek için `127.0.0.1:` önekini kaldırın ve güvenlik duvarını buna göre yapılandırın.      - "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 ilk kurulumu kolaylaştırmak içindir; gerçek Gateway yapılandırmasının yerine geçmez. Dağıtımınız için yine de kimlik doğrulamayı (gateway.auth.token veya parola) ve güvenli bir bağlama modunu ayarlayın.

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

Genel Docker ana makine akışı için paylaşılan çalışma zamanı kılavuzunu izleyin:

• Gerekli ikili dosyaları imaja gömün
• Derleyin ve başlatın
• Nelerin nerede kalıcı olduğu
• Güncellemeler

GCP'ye özgü başlatma notları

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

LAN'a bağlanırken (OPENCLAW_GATEWAY_BIND=lan) devam etmeden önce güvenilen bir tarayıcı kaynağı yapılandırın:

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

Bağlantı noktasını değiştirdiyseniz 18789 değerini yapılandırdığınız bağlantı noktasıyla değiştirin.

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

Gateway bağlantı noktasını 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 http://127.0.0.1:18789/ adresini açın.

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

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

Kullanıcı arayüzü paylaşılan gizli değerle kimlik doğrulama 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; parola ile kimlik doğrulamaya geçtiyseniz bunun yerine yapılandırılmış parolanızı 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 listdocker compose run --rm openclaw-cli devices approve <requestId>

Paylaşılan kalıcılık haritası için Docker VM Çalışma Zamanı, güncelleme işlemi için güncelleme akışı bölümlerine bakın.