Ana içeriğe atla
OpenClaw’ı Render üzerinde Infrastructure as Code kullanarak dağıtın. Dahil edilen render.yaml Blueprint, tüm yığınınızı bildirime dayalı olarak tanımlar; hizmet, disk, ortam değişkenleri dahil; böylece tek tıklamayla dağıtım yapabilir ve altyapınızı kodunuzla birlikte sürümlendirebilirsiniz.

​
Ön koşullar

​
Render Blueprint ile dağıtım

Deploy to Render Bu bağlantıya tıklamak şunları yapar:
  1. Bu deponun kökündeki render.yaml Blueprint dosyasından yeni bir Render hizmeti oluşturur.
  2. Docker imajını derler ve dağıtır
Dağıtımdan sonra hizmet URL’niz https://<service-name>.onrender.com biçimini izler.

​
Blueprint’i anlama

Render Blueprints, altyapınızı tanımlayan YAML dosyalarıdır. Bu depodaki render.yaml, OpenClaw’ı çalıştırmak için gereken her şeyi yapılandırır: 
services:
  - type: web
    name: openclaw
    runtime: docker
    plan: starter
    healthCheckPath: /health
    envVars:
      - key: OPENCLAW_GATEWAY_PORT
        value: "8080"
      - key: OPENCLAW_STATE_DIR
        value: /data/.openclaw
      - key: OPENCLAW_WORKSPACE_DIR
        value: /data/workspace
      - key: OPENCLAW_GATEWAY_TOKEN
        generateValue: true # güvenli bir token otomatik oluşturur
    disk:
      name: openclaw-data
      mountPath: /data
      sizeGB: 1
Kullanılan temel Blueprint özellikleri:
ÖzellikAmaç
runtime: dockerDeponun Dockerfile dosyasından derler
healthCheckPathRender /health yolunu izler ve sağlıksız örnekleri yeniden başlatır
generateValue: trueKriptografik olarak güvenli bir değer otomatik oluşturur
diskYeniden dağıtımlardan sonra da kalan kalıcı depolama sağlar

​
Bir plan seçme

PlanAskıya almaDiskEn iyi kullanım
Free15 dk boşta kaldıktan sonraKullanılamazTest, demo
StarterAsla1GB+Kişisel kullanım, küçük ekipler
Standard+Asla1GB+Üretim, birden çok kanal
Blueprint varsayılan olarak starter kullanır. Ücretsiz katmanı kullanmak için fork’unuzdaki render.yaml içinde plan: free olarak değiştirin (ancak unutmayın: kalıcı disk olmadığında OpenClaw durumu her dağıtımda sıfırlanır).

​
Dağıtımdan sonra

​
Control UI’ye erişim

Web panosu https://<your-service>.onrender.com/ adresinde kullanılabilir. Yapılandırılmış paylaşılan giz ile bağlanın. Bu dağıtım şablonu otomatik olarak OPENCLAW_GATEWAY_TOKEN oluşturur (bunu Dashboard → your service → Environment içinde bulabilirsiniz); bunu parola kimlik doğrulamasıyla değiştirirseniz bunun yerine o parolayı kullanın.

​
Render Dashboard özellikleri

​
Günlükler

Gerçek zamanlı günlükleri Dashboard → your service → Logs içinde görüntüleyin. Şunlara göre filtreleyin:
  • Derleme günlükleri (Docker imajı oluşturma)
  • Dağıtım günlükleri (hizmet başlatma)
  • Çalışma zamanı günlükleri (uygulama çıktısı)

​
Shell erişimi

Hata ayıklama için Dashboard → your service → Shell üzerinden bir shell oturumu açın. Kalıcı disk /data altına bağlanır.

​
Ortam değişkenleri

Değişkenleri Dashboard → your service → Environment içinde değiştirin. Değişiklikler otomatik yeniden dağıtımı tetikler.

​
Otomatik dağıtım

Özgün OpenClaw deposunu kullanıyorsanız Render, OpenClaw’ınızı otomatik dağıtmaz. Güncellemek için panodan el ile bir Blueprint eşitlemesi çalıştırın.

​
Özel alan adı

  1. Dashboard → your service → Settings → Custom Domains bölümüne gidin
  2. Alan adınızı ekleyin
  3. DNS’i yönergelere göre yapılandırın (*.onrender.com için CNAME)
  4. Render otomatik olarak bir TLS sertifikası sağlar

​
Ölçekleme

Render yatay ve dikey ölçeklemeyi destekler:
  • Dikey: Daha fazla CPU/RAM almak için planı değiştirin
  • Yatay: Örnek sayısını artırın (Standard plan ve üzeri)
OpenClaw için dikey ölçekleme genellikle yeterlidir. Yatay ölçekleme sticky session veya harici durum yönetimi gerektirir.

​
Yedekleme ve taşıma

Durumunuzu, yapılandırmanızı, auth profillerinizi ve çalışma alanınızı istediğiniz zaman Render Dashboard içindeki shell erişimini kullanarak dışa aktarın: 
openclaw backup create
Bu, OpenClaw durumu ile birlikte yapılandırılmış herhangi bir çalışma alanını içeren taşınabilir bir yedek arşivi oluşturur. Ayrıntılar için bkz. Backup.

​
Sorun giderme

​
Hizmet başlamıyor

Render Dashboard içindeki dağıtım günlüklerini kontrol edin. Yaygın sorunlar:
  • Eksik OPENCLAW_GATEWAY_TOKEN — bunun Dashboard → Environment içinde ayarlandığını doğrulayın
  • Port uyumsuzluğu — gateway’nin Render’ın beklediği porta bağlanması için OPENCLAW_GATEWAY_PORT=8080 ayarlandığından emin olun

​
Yavaş cold start’lar (ücretsiz katman)

Ücretsiz katman hizmetleri 15 dakikalık hareketsizlikten sonra askıya alınır. Askıya alma sonrası ilk istek, kapsayıcı başlarken birkaç saniye sürer. Her zaman açık kullanım için Starter planına yükseltin.

​
Yeniden dağıtımdan sonra veri kaybı

Bu ücretsiz katmanda olur (kalıcı disk yok). Ücretli bir plana yükseltin veya Render shell içinde openclaw backup create ile düzenli olarak tam yedek dışa aktarın.

​
Health check hataları

Render, 30 saniye içinde /health yolundan 200 yanıtı bekler. Derlemeler başarılı ama dağıtımlar başarısız oluyorsa hizmetin başlaması çok uzun sürüyor olabilir. Şunları kontrol edin:
  • Hatalar için derleme günlükleri
  • Kapsayıcının yerelde docker build && docker run ile çalışıp çalışmadığı

​
Sonraki adımlar