Gerekenler
- flyctl CLI kurulu
- Fly.io hesabı (ücretsiz katman yeterlidir)
- Model kimlik doğrulaması: seçtiğiniz model sağlayıcısı için API anahtarı
- Kanal kimlik bilgileri: Discord bot belirteci, Telegram belirteci vb.
Yeni başlayanlar için hızlı yol
- Depoyu klonlayın →
fly.tomldosyasını özelleştirin - Uygulama + volume oluşturun → gizli değerleri ayarlayın
fly deployile dağıtın- Yapılandırma oluşturmak için SSH ile bağlanın veya Control UI kullanın
Create the Fly app
lhr (Londra), iad (Virginia), sjc (San Jose).Configure fly.toml
fly.toml dosyasını uygulama adınıza ve gereksinimlerinize uyacak şekilde düzenleyin.Güvenlik notu: Varsayılan yapılandırma herkese açık bir URL sunar. Herkese açık IP olmadan güçlendirilmiş bir dağıtım için Özel Dağıtım bölümüne bakın veya deploy/fly.private.toml kullanın.tini kullanır. Fly işlem komutları Docker CMD değerini, ENTRYPOINT değerini değiştirmeden değiştirir; bu nedenle işlem yine tini altında çalışır.Temel ayarlar:| Ayar | Neden |
|---|---|
--bind lan | Fly proxy’sinin Gateway’e ulaşabilmesi için 0.0.0.0 adresine bağlar |
--allow-unconfigured | Yapılandırma dosyası olmadan başlatır (sonrasında bir tane oluşturacaksınız) |
internal_port = 3000 | Fly sağlık kontrolleri için --port 3000 (veya OPENCLAW_GATEWAY_PORT) ile eşleşmelidir |
memory = "2048mb" | 512MB çok küçüktür; 2GB önerilir |
OPENCLAW_STATE_DIR = "/data" | Durumu volume üzerinde kalıcı hale getirir |
Set secrets
- local loopback olmayan bağlamalar (
--bind lan) geçerli bir Gateway kimlik doğrulama yolu gerektirir. Bu Fly.io örneğiOPENCLAW_GATEWAY_TOKENkullanır, ancakgateway.auth.passwordveya doğru yapılandırılmış local loopback olmayan birtrusted-proxydağıtımı da gereksinimi karşılar. - Bu belirteçleri parolalar gibi koruyun.
- Tüm API anahtarları ve belirteçler için yapılandırma dosyası yerine env değişkenlerini tercih edin. Bu, gizli değerleri yanlışlıkla açığa çıkarılabilecek veya günlüğe yazılabilecekleri
openclaw.jsondışında tutar.
Deploy
Create config file
Uygun bir yapılandırma oluşturmak için makineye SSH ile bağlanın:Yapılandırma dizinini ve dosyasını oluşturun:Not:
OPENCLAW_STATE_DIR=/data ile yapılandırma yolu /data/openclaw.json olur.Not: https://my-openclaw.fly.dev değerini gerçek Fly uygulama
kaynağınızla değiştirin. Gateway başlangıcı, ilk önyüklemenin yapılandırma
mevcut olmadan ilerleyebilmesi için yerel Control UI kaynaklarını çalışma zamanı
--bind ve --port değerlerinden tohumlar, ancak Fly üzerinden tarayıcı
erişimi için yine de gateway.controlUi.allowedOrigins içinde tam HTTPS
kaynağının listelenmesi gerekir.Not: Discord belirteci şu kaynaklardan gelebilir:- Ortam değişkeni:
DISCORD_BOT_TOKEN(gizli değerler için önerilir) - Yapılandırma dosyası:
channels.discord.token
DISCORD_BOT_TOKEN değerini otomatik olarak okur.Uygulamak için yeniden başlatın:Access the Gateway
Control UI
Tarayıcıda açın:https://my-openclaw.fly.dev/ adresini ziyaret edinYapılandırılmış paylaşılan gizli değerle kimlik doğrulaması yapın. Bu kılavuz,
OPENCLAW_GATEWAY_TOKEN kaynaklı Gateway belirtecini kullanır; parola kimlik
doğrulamasına geçtiyseniz bunun yerine o parolayı kullanın.Günlükler
SSH Konsolu
Sorun giderme
”App is not listening on expected address”
Gateway,0.0.0.0 yerine 127.0.0.1 adresine bağlanıyor.
Düzeltme: fly.toml içindeki işlem komutunuza --bind lan ekleyin.
Sağlık kontrolleri başarısız / bağlantı reddedildi
Fly, yapılandırılmış bağlantı noktasında Gateway’e ulaşamıyor. Düzeltme:internal_port değerinin Gateway bağlantı noktasıyla eşleştiğinden emin olun (--port 3000 veya OPENCLAW_GATEWAY_PORT=3000 ayarlayın).
OOM / Bellek Sorunları
Kapsayıcı sürekli yeniden başlıyor veya sonlandırılıyor. Belirtiler:SIGABRT, v8::internal::Runtime_AllocateInYoungGeneration veya sessiz yeniden başlatmalar.
Düzeltme: fly.toml içinde belleği artırın:
Gateway kilit sorunları
Gateway, “already running” hatalarıyla başlamayı reddediyor. Bu, kapsayıcı yeniden başlatıldığında ancak PID kilit dosyası volume üzerinde kaldığında olur. Düzeltme: Kilit dosyasını silin:/data/gateway.*.lock konumundadır (bir alt dizinde değildir).
Yapılandırma okunmuyor
--allow-unconfigured yalnızca başlangıç korumasını atlar. /data/openclaw.json oluşturmaz veya onarmaz; bu nedenle gerçek yapılandırmanızın mevcut olduğundan ve normal bir yerel Gateway başlangıcı istediğinizde gateway.mode="local" içerdiğinden emin olun.
Yapılandırmanın mevcut olduğunu doğrulayın:
SSH üzerinden yapılandırma yazma
fly ssh console -C komutu kabuk yönlendirmesini desteklemez. Bir yapılandırma dosyası yazmak için:
fly sftp başarısız olabilir. Önce silin:
Durum kalıcı olmuyor
Yeniden başlatmadan sonra kimlik doğrulama profillerini, kanal/sağlayıcı durumunu veya oturumları kaybediyorsanız durum dizini kapsayıcı dosya sistemine yazıyordur. Düzeltme:fly.toml içinde OPENCLAW_STATE_DIR=/data ayarlandığından emin olun ve yeniden dağıtın.
Güncellemeler
Makine komutunu güncelleme
Tam yeniden dağıtım yapmadan başlangıç komutunu değiştirmeniz gerekiyorsa:fly deploy sonrasında makine komutu fly.toml içindeki değere sıfırlanabilir. Elle değişiklik yaptıysanız dağıtımdan sonra bunları yeniden uygulayın.
Özel dağıtım (güçlendirilmiş)
Varsayılan olarak Fly herkese açık IP’ler ayırır ve Gateway’inizihttps://your-app.fly.dev adresinden erişilebilir hale getirir. Bu kullanışlıdır, ancak dağıtımınızın internet tarayıcıları (Shodan, Censys vb.) tarafından keşfedilebilir olduğu anlamına gelir.
Herkese açık erişim olmayan güçlendirilmiş bir dağıtım için özel şablonu kullanın.
Özel dağıtım ne zaman kullanılır
- Yalnızca giden çağrılar/mesajlar yapıyorsanız (gelen Webhook yoksa)
- Herhangi bir Webhook geri çağrısı için ngrok veya Tailscale tünelleri kullanıyorsanız
- Gateway’e tarayıcı yerine SSH, proxy veya WireGuard üzerinden erişiyorsanız
- Dağıtımın internet tarayıcılarından gizlenmesini istiyorsanız
Kurulum
Standart yapılandırma yerinedeploy/fly.private.toml kullanın:
fly ips list yalnızca private türünde bir IP göstermelidir:
Özel dağıtıma erişme
Herkese açık URL olmadığı için şu yöntemlerden birini kullanın: Seçenek 1: Yerel proxy (en basit)Özel dağıtımla Webhook’lar
Genel erişime açmadan webhook geri çağrılarına (Twilio, Telnyx vb.) ihtiyacınız varsa:- ngrok tüneli - ngrok’u kapsayıcı içinde veya sidecar olarak çalıştırın
- Tailscale Funnel - Belirli yolları Tailscale üzerinden açın
- Yalnızca dışa giden - Bazı sağlayıcılar (Twilio), webhook olmadan dışa giden aramalar için sorunsuz çalışır
webhookSecurity.allowedHosts değerini genel tünel host adı olarak ayarlayın.
Güvenlik avantajları
| Unsur | Genel | Özel |
|---|---|---|
| İnternet tarayıcıları | Keşfedilebilir | Gizli |
| Doğrudan saldırılar | Olası | Engellenir |
| Control UI erişimi | Tarayıcı | Proxy/VPN |
| Webhook teslimi | Doğrudan | Tünel üzerinden |
Notlar
- Fly.io x86 mimarisi kullanır (ARM değil)
- Dockerfile her iki mimariyle de uyumludur
- WhatsApp/Telegram ilk kurulumunda
fly ssh consolekullanın - Kalıcı veriler
/datakonumundaki birimde bulunur - Signal Java + signal-cli gerektirir; özel bir imaj kullanın ve belleği 2 GB+ seviyesinde tutun.
Maliyet
Önerilen yapılandırmayla (shared-cpu-2x, 2 GB RAM):
- Kullanıma bağlı olarak yaklaşık $10-15/ay
- Ücretsiz katman bir miktar kullanım hakkı içerir
Sonraki adımlar
- Mesajlaşma kanallarını ayarlayın: Kanallar
- Gateway’i yapılandırın: Gateway yapılandırması
- OpenClaw’u güncel tutun: Güncelleme