Hetzner

VPS'yi hazırlayın

Hetzner'de bir Ubuntu veya Debian VPS oluşturun, ardından root olarak bağlanın:

ssh root@YOUR_VPS_IP

VPS'yi tek kullanımlık altyapı olarak değil, durum bilgisi taşıyan bir altyapı olarak değerlendirin.

Docker'ı kurun (VPS üzerinde)

apt-get updateapt-get install -y git curl ca-certificatescurl -fsSL https://get.docker.com | sh

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 tüm ikili dosyaların yeniden başlatmalar sonrasında korunması için özel bir imaj oluşturur.

Kalıcı ana bilgisayar dizinleri oluşturun

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

mkdir -p /root/.openclaw/workspace # Sahipliği konteyner kullanıcısına ayarlayın (uid 1000):chown -R 1000:1000 /root/.openclaw

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=/root/.openclawOPENCLAW_WORKSPACE_DIR=/root/.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 yapılandırmasını yapı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ğrulaması, 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 VPS üzerinde yalnızca geri döngüye açık 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 VM çalışma zamanı adımları

Ortak Docker ana bilgisayar 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

Hetzner'a özgü erişim

Paylaşılan derleme ve başlatma adımlarından sonra tüneli açın.

Ön koşul: VPS sshd yapılandırmanızın TCP yönlendirmesine izin verdiğinden emin olun. SSH yapılandırmanızı sıkılaştırdıysanız /etc/ssh/sshd_config ayarını kontrol edin ve şunu ayarlayın:

AllowTcpForwarding local

local, sunucudan gelen uzak yönlendirmeleri engellerken dizüstü bilgisayarınızdan ssh -L yerel yönlendirmelerine izin verir. Bunu no olarak ayarlamak, tünelin şu hatayla başarısız olmasına neden olur: channel 3: open failed: administratively prohibited: open failed

TCP yönlendirmenin etkinleştirildiğini doğruladıktan sonra SSH hizmetini (systemctl restart ssh) yeniden başlatın ve tüneli dizüstü bilgisayarınızdan çalıştırın:

ssh -N -L 18789:127.0.0.1:18789 root@YOUR_VPS_IP

http://127.0.0.1:18789/ adresini açın ve yapılandırılmış paylaşılan gizli anahtarı yapıştırın. Bu kılavuz varsayılan olarak gateway token'ını kullanır; parola kimlik doğrulamasına geçtiyseniz bunun yerine yapılandırılmış parolanızı kullanın.