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 eşdeğeri: IAM & Admin > Create Project yolunu izleyin, faturalandırmayı etkinleştirin, ardından APIs & Services > Enable APIs > "Compute Engine API" > Enable yolunu izleyin.

Sanal makineyi 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

Sanal makineye SSH ile bağlanın

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

Console: Compute Engine panosunda sanal makinenin yanındaki "SSH" seçeneğine tıklayın.

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

Docker'ı yükleyin (sanal makinede)

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 geçerli olması için oturumu kapatıp yeniden açın, ardından SSH ile tekrar 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 yerleştirdiğiniz 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; uzun ömürlü tüm durum ana makinede bulunmalıdır.

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

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

Depo kökünde .env dosyasını 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 boyunca istemcilere güvenmeden önce gateway.auth.token değerini yapılandırın. İkisi de ayarlanmamışsa OpenClaw bu başlatma için yalnızca çalışma zamanına özgü bir token kullanır. GOG_KEYRING_PASSWORD için bir anahtarlık parolası oluşturun:

openssl rand -hex 32

Bu dosyayı commit etmeyin. Dosya, OPENCLAW_GATEWAY_TOKEN gibi konteyner/çalışma zamanı ortam değişkenlerini içerir. Saklanan sağlayıcı OAuth/API anahtarı kimlik doğrulama bilgileri, bağlanan ~/.openclaw/agents/<agentId>/agent/auth-profiles.json dosyasında 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 sanal makinede yalnızca loopback üzerinden erişilebilir tutun; SSH tüneliyle 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 kurulum kolaylığı 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 sanal makinesi çalışma zamanı adımları

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

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

GCP'ye özgü başlatma notları

pnpm install --frozen-lockfile sırasında derleme Killed veya exit code 137 hatasıyla başarısız olursa sanal makinenin 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üvenilir bir tarayıcı kökeni yapılandırın:

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

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 pano bağlantısını yeniden yazdırın:

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

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

Paylaşılan kalıcılık eşlemesi için Docker Sanal Makinesi Çalışma Zamanı ve güncelleme akışı bölümlerine bakın.