Ana içeriğe atla

​
Hetzner Üzerinde OpenClaw (Docker, Üretim VPS Rehberi)

​
Amaç

Docker kullanarak bir Hetzner VPS üzerinde, dayanıklı durum, yerleşik ikili dosyalar ve güvenli yeniden başlatma davranışıyla kalıcı bir OpenClaw Gateway çalıştırmak. “~5$’a OpenClaw 7/24” istiyorsanız, bu en basit ve güvenilir kurulumdur. Hetzner fiyatları değişir; en küçük Debian/Ubuntu VPS’i seçin ve OOM’lara (bellek yetersizliği) takılırsanız ölçeklendirin.

​
Ne yapıyoruz (basitçe)?

  • Küçük bir Linux sunucusu kiralıyoruz (Hetzner VPS)
  • Docker’ı kuruyoruz (izole uygulama çalışma zamanı)
  • OpenClaw Gateway’i Docker içinde başlatıyoruz
  • ~/.openclaw + ~/.openclaw/workspace verilerini ana makinede kalıcı hale getiriyoruz (yeniden başlatma/yeniden oluşturma sonrası korunur)
  • Dizüstünüzden bir SSH tüneli üzerinden Kontrol UI’ye erişiyoruz
Gateway’e şu yollarla erişilebilir:
  • Dizüstünüzden SSH port yönlendirmesi
  • Güvenlik duvarı ve belirteçleri kendiniz yönetiyorsanız doğrudan port açma
Bu rehber, Hetzner üzerinde Ubuntu veya Debian varsayar.
Başka bir Linux VPS kullanıyorsanız, paketleri buna göre eşleyin. Genel Docker akışı için bkz. Docker.

​
Hızlı yol (deneyimli operatörler)

  1. Hetzner VPS’i sağlayın
  2. Docker’ı kurun
  3. OpenClaw deposunu klonlayın
  4. Kalıcı ana makine dizinlerini oluşturun
  5. .env ve docker-compose.yml yapılandırın
  6. Ana makine hacim bağlaması
  7. docker compose up -d
  8. Kalıcılığı ve Gateway erişimini doğrulayın

​
İhtiyacınız olanlar

  • Root erişimine sahip Hetzner VPS
  • Dizüstünüzden SSH erişimi
  • SSH + kopyala/yapıştır konusunda temel rahatlık
  • ~20 dakika
  • Docker ve Docker Compose
  • Model kimlik doğrulama bilgileri
  • İsteğe bağlı sağlayıcı kimlik bilgileri
    • WhatsApp QR
    • Telegram bot belirteci
    • Gmail OAuth

​
1. VPS’i sağlayın

Hetzner’da bir Ubuntu veya Debian VPS oluşturun. Root olarak bağlanın: 
ssh root@YOUR_VPS_IP
Bu rehber VPS’in durum bilgisi tutan (stateful) olduğunu varsayar. Bunu tek kullanımlık (disposable) altyapı gibi ele almayın.

​
2. Docker’ı kurun (VPS üzerinde)

apt-get update
apt-get install -y git curl ca-certificates
curl -fsSL https://get.docker.com | sh
Doğrulayın: 
docker --version
docker compose version

​
3. OpenClaw deposunu klonlayın

git clone https://github.com/openclaw/openclaw.git
cd openclaw
Bu rehber, ikili dosyaların kalıcılığını garanti etmek için özel bir imaj oluşturacağınızı varsayar.

​
4. Kalıcı ana makine dizinlerini oluşturun

Docker container’ları geçicidir. Tüm uzun ömürlü durum ana makinede bulunmalıdır. 
mkdir -p /root/.openclaw/workspace

# Set ownership to the container user (uid 1000):
chown -R 1000:1000 /root/.openclaw

​
5. Ortam değişkenlerini yapılandırın

Depo kökünde .env oluşturun. 
OPENCLAW_IMAGE=openclaw:latest
OPENCLAW_GATEWAY_TOKEN=change-me-now
OPENCLAW_GATEWAY_BIND=lan
OPENCLAW_GATEWAY_PORT=18789

OPENCLAW_CONFIG_DIR=/root/.openclaw
OPENCLAW_WORKSPACE_DIR=/root/.openclaw/workspace

GOG_KEYRING_PASSWORD=change-me-now
XDG_CONFIG_HOME=/home/node/.openclaw
Güçlü gizli anahtarlar üretin: 
openssl rand -hex 32
Bu dosyayı commit etmeyin.

​
6. 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:
      # Recommended: keep the Gateway loopback-only on the VPS; 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"

      # Optional: only if you run iOS/Android nodes against this VPS and need Canvas host.
      # If you expose this publicly, read /gateway/security and firewall accordingly.
      # - "18793:18793"
    command:
      [
        "node",
        "dist/index.js",
        "gateway",
        "--bind",
        "${OPENCLAW_GATEWAY_BIND}",
        "--port",
        "${OPENCLAW_GATEWAY_PORT}",
        "--allow-unconfigured",
      ]
--allow-unconfigured is only for bootstrap convenience, it is not a replacement for a proper gateway configuration. Still set auth (gateway.auth.token or password) and use safe bind settings for your deployment.

​
7. Gerekli ikili dosyaları imaja yerleştirin (kritik)

Çalışan bir container içine ikili dosyalar kurmak bir tuzaktır. Çalışma anında kurulan her şey yeniden başlatmada kaybolur. Skills tarafından gereken tüm harici ikili dosyalar imaj oluşturma zamanında kurulmalıdır. Aşağıdaki örnekler yalnızca üç yaygın ikili dosyayı gösterir:
  • Gmail erişimi için gog
  • Google Places için goplaces
  • WhatsApp için wacli
Bunlar örnektir, eksiksiz bir liste değildir. Aynı deseni kullanarak gerektiği kadar ikili dosya kurabilirsiniz. Daha sonra ek ikili dosyalara bağımlı yeni skills eklerseniz şunları yapmalısınız:
  1. Dockerfile’ı güncelleyin
  2. İmajı yeniden oluşturun
  3. Container’ları yeniden başlatın
Örnek Dockerfile 
FROM node:22-bookworm

RUN apt-get update && apt-get install -y socat && rm -rf /var/lib/apt/lists/*

# Example binary 1: Gmail CLI
RUN curl -L https://github.com/steipete/gog/releases/latest/download/gog_Linux_x86_64.tar.gz \
  | tar -xz -C /usr/local/bin && chmod +x /usr/local/bin/gog

# Example binary 2: Google Places CLI
RUN curl -L https://github.com/steipete/goplaces/releases/latest/download/goplaces_Linux_x86_64.tar.gz \
  | tar -xz -C /usr/local/bin && chmod +x /usr/local/bin/goplaces

# Example binary 3: WhatsApp CLI
RUN curl -L https://github.com/steipete/wacli/releases/latest/download/wacli_Linux_x86_64.tar.gz \
  | tar -xz -C /usr/local/bin && chmod +x /usr/local/bin/wacli

# Add more binaries below using the same pattern

WORKDIR /app
COPY package.json pnpm-lock.yaml pnpm-workspace.yaml .npmrc ./
COPY ui/package.json ./ui/package.json
COPY scripts ./scripts

RUN corepack enable
RUN pnpm install --frozen-lockfile

COPY . .
RUN pnpm build
RUN pnpm ui:install
RUN pnpm ui:build

ENV NODE_ENV=production

CMD ["node","dist/index.js"]

​
8. Derleyin ve başlatın

docker compose build
docker compose up -d openclaw-gateway
İkili dosyaları doğrulayın: 
docker compose exec openclaw-gateway which gog
docker compose exec openclaw-gateway which goplaces
docker compose exec openclaw-gateway which wacli
Beklenen çıktı: 
/usr/local/bin/gog
/usr/local/bin/goplaces
/usr/local/bin/wacli

​
9. Gateway’i doğrulayın

docker compose logs -f openclaw-gateway
Başarılı: 
[gateway] listening on ws://0.0.0.0:18789
Dizüstünüzden: 
ssh -N -L 18789:127.0.0.1:18789 root@YOUR_VPS_IP
Açın: http://127.0.0.1:18789/ Gateway belirtecinizi yapıştırın.

​
Nerede ne kalıcı (tek doğru kaynak)

OpenClaw Docker içinde çalışır, ancak Docker tek doğru kaynak değildir. Tüm uzun ömürlü durum; yeniden başlatmalar, yeniden oluşturma ve yeniden başlatma (reboot) sonrasında hayatta kalmalıdır.
BileşenKonumKalıcılık mekanizmasıNotlar
Gateway yapılandırması/home/node/.openclaw/Ana makine hacim bağlamasıopenclaw.json, belirteçler dahil
Model kimlik profilleri/home/node/.openclaw/Ana makine hacim bağlamasıOAuth belirteçleri, API anahtarları
Skill yapılandırmaları/home/node/.openclaw/skills/Ana makine hacim bağlamasıSkill düzeyi durum
concepts/agent-workspace.md/home/node/.openclaw/workspace/Ana makine hacim bağlamasıKod ve ajan artefaktları
WhatsApp oturumu/home/node/.openclaw/Harici ikili dosyalarQR girişini korur
Gmail anahtarlığı/home/node/.openclaw/Ana makine volume + parolaGOG_KEYRING_PASSWORD gerektirir
Derleme zamanında imaja gömülmelidir/usr/local/bin/Docker imajıNode çalışma zamanı
Çalışma zamanında kurmayınContainer dosya sistemiDocker imajıHer imaj oluşturmada yeniden kurulur
OS paketleriContainer dosya sistemiDocker imajıYalnızca kaynaktan derliyorsanız pnpm
Docker containerGeçicidirYeniden başlatılabilirYok edilmesi güvenlidir

​
Kod Olarak Altyapı (Terraform)

Altyapı-kod iş akışlarını tercih eden ekipler için, topluluk tarafından sürdürülen bir Terraform kurulumu şunları sağlar:
  • Uzak durum yönetimi ile modüler Terraform yapılandırması
  • cloud-init aracılığıyla otomatik sağlama
  • Dağıtım betikleri (bootstrap, deploy, backup/restore)
  • Güvenlik güçlendirmesi (güvenlik duvarı, UFW, yalnızca SSH erişimi)
  • Gateway erişimi için SSH tünel yapılandırması
Depolar: Bu yaklaşım, yukarıdaki Docker kurulumunu tekrarlanabilir dağıtımlar, sürüm kontrollü altyapı ve otomatik felaket kurtarma ile tamamlar.
Not: Topluluk tarafından sürdürülmektedir. Sorunlar veya katkılar için yukarıdaki depo bağlantılarına bakın.