Ana içeriğe atla

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Render

OpenClaw’u Infrastructure as Code kullanarak Render üzerinde dağıtın. Dahil edilen render.yaml Blueprint’i tüm yığınınızı bildirimsel olarak tanımlar: hizmet, disk, ortam değişkenleri; böylece tek tıklamayla dağıtım yapabilir ve altyapınızı kodunuzla birlikte sürümleyebilirsiniz.

​
Ön koşullar

​
Render Blueprint ile dağıtım yapın

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

​
Blueprint’i anlama

Render Blueprint’leri altyapınızı tanımlayan YAML dosyalarıdır. Bu depodaki render.yaml, OpenClaw’u ç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 üretir
    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 üretir
diskYeniden dağıtımlardan sağ çıkan kalıcı depolama

​
Plan seçimi

PlanAskıya almaDiskEn iyi kullanım
Free15 dk boşta kalıncaKullanılamazTest, demolar
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ığından OpenClaw durumu her dağıtımda sıfırlanır).

​
Dağıtımdan sonra

​
Control UI’a erişin

Web dashboard https://<your-service>.onrender.com/ adresinde kullanılabilir. Yapılandırılmış paylaşılan sır ile bağlanın. Bu dağıtım şablonu otomatik olarak OPENCLAW_GATEWAY_TOKEN üretir (bunu Dashboard → hizmetiniz → Environment altında bulabilirsiniz); bunu parola kimlik doğrulamasıyla değiştirirseniz onun yerine bu parolayı kullanın.

​
Render Dashboard özellikleri

​
Günlükler

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

​
Shell erişimi

Hata ayıklamak için Dashboard → hizmetiniz → Shell üzerinden bir shell oturumu açın. Kalıcı disk /data noktasına bağlanır.

​
Ortam değişkenleri

Değişkenleri Dashboard → hizmetiniz → Environment altında değiştirin. Değişiklikler otomatik bir yeniden dağıtımı tetikler.

​
Otomatik dağıtım

Özgün OpenClaw deposunu kullanıyorsanız Render OpenClaw’unuzu otomatik olarak yeniden dağıtmaz. Güncellemek için dashboard üzerinden elle Blueprint eşitlemesi çalıştırın.

​
Özel alan adı

  1. Dashboard → hizmetiniz → 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 genellikle dikey ölçekleme yeterlidir. Yatay ölçekleme sticky session’lar veya harici durum yönetimi gerektirir.

​
Yedekleme ve taşıma

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

​
Sorun giderme

​
Hizmet başlamıyor

Render Dashboard’daki dağıtım günlüklerini kontrol edin. Yaygın sorunlar:
  • Eksik OPENCLAW_GATEWAY_TOKEN — Dashboard → Environment altında ayarlandığını doğrulayın
  • Port uyuşmazlığı — Gateway’in Render’ın beklediği porta bağlanması için OPENCLAW_GATEWAY_PORT=8080 ayarlı olduğundan emin olun

​
Yavaş soğuk başlangıçlar (ücretsiz katman)

Ücretsiz katman hizmetleri 15 dakika hareketsizlikten sonra askıya alınır. Askıya almadan sonraki ilk istek, container 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 yoktur). Ücretli bir plana yükseltin veya Render shell içinde openclaw backup create ile düzenli olarak tam yedek dışa aktarın.

​
Sağlık kontrolü hataları

Render, /health yolundan 30 saniye içinde 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
  • Container’ın yerelde docker build && docker run ile çalışıp çalışmadığı

​
Sonraki adımlar