Fly.io

Hedef: Kalıcı depolama, otomatik HTTPS ve Discord/kanal erişimiyle bir Fly.io makinesinde çalışan OpenClaw Gateway.

Gereksinimler

flyctl CLI yüklü olmalıdır
Fly.io hesabı (ücretsiz katman kullanılabilir)
Model kimlik doğrulaması: seçtiğiniz model sağlayıcısının API anahtarı
Kanal kimlik bilgileri: Discord bot belirteci, Telegram belirteci vb.

Yeni başlayanlar için hızlı yol

Depoyu klonlayın, fly.toml dosyasını özelleştirin
Uygulamayı ve birimi oluşturun, gizli değerleri ayarlayın
fly deploy ile dağıtın
Yapılandırmayı oluşturmak için SSH ile bağlanın veya Control UI’ı kullanın

Fly uygulamasını oluşturun

git clone https://github.com/openclaw/openclaw.git
cd openclaw

# kendi adınızı seçin
fly apps create my-openclaw

# 1 GB genellikle yeterlidir
fly volumes create openclaw_data --size 1 --region iad

Size yakın bir bölge seçin. Yaygın seçenekler: lhr (Londra), iad (Virginia), sjc (San Jose).

fly.toml dosyasını yapılandırın

fly.toml dosyasını uygulama adınıza ve gereksinimlerinize uyacak şekilde düzenleyin. Depoda izlenen fly.toml, aşağıda gösterilen herkese açık şablondur; deploy/fly.private.toml ise güçlendirilmiş, genel IP içermeyen varyanttır (bkz. Özel dağıtım).

app = "my-openclaw"  # uygulamanızın adı
primary_region = "iad"

[build]
  dockerfile = "Dockerfile"

[env]
  NODE_ENV = "production"
  OPENCLAW_PREFER_PNPM = "1"
  OPENCLAW_STATE_DIR = "/data"
  NODE_OPTIONS = "--max-old-space-size=1536"

[processes]
  app = "node dist/index.js gateway --allow-unconfigured --port 3000 --bind lan"

[http_service]
  internal_port = 3000
  force_https = true
  auto_stop_machines = false
  auto_start_machines = true
  min_machines_running = 1
  processes = ["app"]

[[vm]]
  size = "shared-cpu-2x"
  memory = "2048mb"

[mounts]
  source = "openclaw_data"
  destination = "/data"

OpenClaw Docker imajının giriş noktası tini olup varsayılan olarak node openclaw.mjs gateway çalıştırır. Fly [processes], ENTRYPOINT değerine dokunmadan Docker CMD değerinin yerini alır (burada aynı derlenmiş giriş noktası olan node dist/index.js gateway ... doğrudan çalıştırılır); böylece işlem tini altında çalışmaya devam eder.Temel ayarlar:

Ayar	Nedeni
`--bind lan`	Fly proxy’sinin gateway’e erişebilmesi için `0.0.0.0` adresine bağlanır
`--allow-unconfigured`	Yapılandırma dosyası olmadan başlatır (dosyayı daha sonra oluşturursunuz)
`internal_port = 3000`	Fly sağlık kontrolleri için `--port 3000` (veya `OPENCLAW_GATEWAY_PORT`) ile eşleşmelidir
`memory = "2048mb"`	512 MB çok küçüktür; 2 GB önerilir
`OPENCLAW_STATE_DIR = "/data"`	Durumu birimde kalıcı hâle getirir

Gizli değerleri ayarlayın

# zorunlu: geri döngü dışı bağlama için gateway kimlik doğrulama belirteci
fly secrets set OPENCLAW_GATEWAY_TOKEN=$(openssl rand -hex 32)

# model sağlayıcısı API anahtarları
fly secrets set ANTHROPIC_API_KEY=example-anthropic-key-not-real

# isteğe bağlı: diğer sağlayıcılar
fly secrets set OPENAI_API_KEY=example-openai-key-not-real
fly secrets set GOOGLE_API_KEY=...

# kanal belirteçleri
fly secrets set DISCORD_BOT_TOKEN=example-discord-bot-token

Geri döngü dışı bağlamalar (--bind lan) geçerli bir gateway kimlik doğrulama yolu gerektirir. Bu örnek OPENCLAW_GATEWAY_TOKEN kullanır ancak gateway.auth.password veya doğru yapılandırılmış, geri döngü dışı bir güvenilir proxy dağıtımı da gereksinimi karşılar. SecretRef sözleşmesi için Gizli değer yönetimi bölümüne bakın.Bu belirteçleri parola gibi değerlendirin. Gizli değerlerin openclaw.json dışında kalması için API anahtarları ve belirteçlerde yapılandırma dosyası yerine ortam değişkenlerini/fly secrets tercih edin.

Dağıtın

fly deploy

İlk dağıtım Docker imajını oluşturur. Dağıtımdan sonra doğrulayın:

fly status
fly logs

HTTP/WebSocket dinleyicisi çalışmaya başladığında Gateway başlangıç günlüklerine gateway ready kaydedilir. Fly’ın kendi sağlık kontrolü, fly.toml uyarınca internal_port = 3000 değerini izler; imajın Docker HEALTHCHECK yönergesi ayrıca varsayılan 18789 portunda /healthz değerini yoklar. Bu dağıtım gateway’i --port 3000 değerine geçersiz kıldığı için söz konusu port burada kullanılmaz.

Yapılandırma dosyasını oluşturun

Uygun bir yapılandırma oluşturmak için makineye SSH ile bağlanın:

fly ssh console

mkdir -p /data
cat > /data/openclaw.json << 'EOF'
{
  "agents": {
    "defaults": {
      "model": {
        "primary": "anthropic/claude-opus-4-6",
        "fallbacks": ["anthropic/claude-sonnet-4-6", "openai/gpt-5.4"]
      },
      "maxConcurrent": 4
    },
    "list": [
      {
        "id": "main",
        "default": true
      }
    ]
  },
  "auth": {
    "profiles": {
      "anthropic:default": { "mode": "token", "provider": "anthropic" },
      "openai:default": { "mode": "token", "provider": "openai" }
    }
  },
  "bindings": [
    {
      "agentId": "main",
      "match": { "channel": "discord" }
    }
  ],
  "channels": {
    "discord": {
      "enabled": true,
      "groupPolicy": "allowlist",
      "guilds": {
        "YOUR_GUILD_ID": {
          "channels": { "general": { "allow": true } },
          "requireMention": false
        }
      }
    }
  },
  "gateway": {
    "mode": "local",
    "bind": "auto",
    "controlUi": {
      "allowedOrigins": [
        "https://my-openclaw.fly.dev",
        "http://localhost:3000",
        "http://127.0.0.1:3000"
      ]
    }
  },
  "meta": {}
}
EOF

OPENCLAW_STATE_DIR=/data kullanıldığında yapılandırma yolu /data/openclaw.json olur.https://my-openclaw.fly.dev değerini gerçek Fly uygulama kaynağınızla değiştirin. Gateway başlangıcı, yapılandırma mevcut olmadan ilk başlatmanın devam edebilmesi için yerel Control UI kaynaklarını çalışma zamanındaki --bind ve --port değerlerinden oluşturur; ancak Fly üzerinden tarayıcı erişimi için tam HTTPS kaynağının yine gateway.controlUi.allowedOrigins içinde listelenmesi gerekir.Discord belirteci şu iki kaynaktan birinden alınabilir:

Ortam değişkeni DISCORD_BOT_TOKEN (gizli değerler için önerilir); yapılandırmaya eklenmesi gerekmez, gateway bunu otomatik olarak okur
Yapılandırma dosyası channels.discord.token

Uygulamak için yeniden başlatın:

exit
fly machine restart <machine-id>

Gateway'e erişin

Control UI

fly open

Alternatif olarak https://my-openclaw.fly.dev/ adresini ziyaret edin.Yapılandırılmış paylaşılan gizli değerle kimlik doğrulayın: OPENCLAW_GATEWAY_TOKEN içindeki gateway belirteci veya parola kimlik doğrulamasına geçtiyseniz parolanız.

Günlükler

fly logs              # canlı günlükler
fly logs --no-tail    # son günlükler

SSH konsolu

fly ssh console

Sorun giderme

”Uygulama beklenen adresi dinlemiyor”

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ılan port üzerinden gateway’e erişemiyor. Düzeltme: internal_port değerinin gateway portuyla (--port 3000 veya OPENCLAW_GATEWAY_PORT=3000) eşleştiğinden emin olun.

OOM / bellek sorunları

Kapsayıcı sürekli yeniden başlatılıyor veya sonlandırılıyor. Belirtiler: SIGABRT, v8::internal::Runtime_AllocateInYoungGeneration veya sessiz yeniden başlatmalar. Düzeltme: fly.toml içindeki belleği artırın:

[[vm]]
  memory = "2048mb"

Alternatif olarak mevcut bir makineyi güncelleyin:

fly machine update <machine-id> --vm-memory 2048 -y

512 MB çok küçüktür. 1 GB çalışabilir ancak yük altında veya ayrıntılı günlük kaydı kullanılırken OOM oluşabilir. 2 GB önerilir.

Gateway kilidi sorunları

Gateway, kapsayıcı yeniden başlatıldıktan sonra “zaten çalışıyor” hatalarıyla başlamayı reddediyor. Çalışma zamanı kilit dosyaları kalıcı /data biriminde değil, <tmpdir>/openclaw-<uid>/gateway.<hash>.lock ve gateway.state.<hash>.lock konumlarında (Linux: /tmp/openclaw-<uid>/gateway.*.lock) bulunur; dolayısıyla kapsayıcının tamamen yeniden başlatılması normalde bu dosyaları kapsayıcı dosya sisteminin geri kalanıyla birlikte temizler. Bir kilit varlığını sürdürürse (örneğin kapsayıcı dosya sistemini koruyan bir fly machine restart) ve başlatmayı engellerse kilidi elle kaldırın:

fly ssh console --command "rm -f /tmp/openclaw-*/gateway.*.lock"
fly machine restart <machine-id>

Yapılandırma okunmuyor

--allow-unconfigured yalnızca başlangıç korumasını atlar. /data/openclaw.json dosyasını oluşturmaz veya onarmaz; bu nedenle gerçek yapılandırmanızın mevcut olduğundan ve normal bir yerel gateway başlangıcı için "gateway": { "mode": "local" } içerdiğinden emin olun. Yapılandırmanın mevcut olduğunu doğrulayın:

fly ssh console --command "cat /data/openclaw.json"

Yapılandırmayı SSH üzerinden yazma

fly ssh console -C kabuk yönlendirmesini desteklemez. Bir yapılandırma dosyası yazmak için:

# echo + tee (yerelden uzağa kanal üzerinden aktarın)
echo '{"your":"config"}' | fly ssh console -C "tee /data/openclaw.json"

# veya sftp
fly sftp shell
> put /local/path/config.json /data/openclaw.json

Dosya zaten mevcutsa fly sftp başarısız olabilir; önce silin:

fly ssh console --command "rm /data/openclaw.json"

Durum kalıcı değil

Yeniden başlatmanın ardından kimlik doğrulama profillerini, kanal/sağlayıcı durumunu veya oturumları kaybediyorsanız durum dizini birim yerine kapsayıcı dosya sistemine yazılıyordur. Düzeltme: fly.toml içinde OPENCLAW_STATE_DIR=/data değerinin ayarlandığından emin olun ve yeniden dağıtın.

Güncelleme

git pull
fly deploy
fly status
fly logs

Buradaki denetimli yol git pull + fly deploy birleşimidir: imajı Dockerfile’dan yeniden oluşturur; böylece CLI/gateway sürümü, temel işletim sistemi imajı ve tüm Dockerfile değişiklikleri birlikte güncellenir. Çalışan kapsayıcının içindeki openclaw update aynı işlem değildir; çünkü imaj, algılayabileceği bir .git çalışma kopyası veya npm tarafından yönetilen genel kurulum olmadan, Docker ile oluşturulmuş bir dist/ ağacı olarak sunulur. VM tarzı kurulumlardaki bu akış için Güncelleme bölümüne bakın.

Makine komutunu güncelleme

Başlangıç komutunu tam bir yeniden dağıtım yapmadan değiştirmek için:

fly machines list
fly machine update <machine-id> --command "node dist/index.js gateway --port 3000 --bind lan" -y

# veya bellek artışıyla birlikte
fly machine update <machine-id> --vm-memory 2048 --command "node dist/index.js gateway --port 3000 --bind lan" -y

Daha sonraki bir fly deploy, makine komutunu fly.toml içinde bulunan değere geri döndürür; yeniden dağıtımdan sonra elle yapılan değişiklikleri tekrar uygulayın.

Özel dağıtım (güçlendirilmiş)

Fly varsayılan olarak genel IP’ler tahsis eder; dolayısıyla gateway’inize https://your-app.fly.dev adresinden erişilebilir ve internet tarayıcıları (Shodan, Censys vb.) tarafından keşfedilebilir. Genel IP içermeyen güçlendirilmiş bir dağıtım için deploy/fly.private.toml kullanın: [http_service] değerini içermediğinden genel giriş tahsis edilmez.

Özel dağıtım ne zaman kullanılmalı?

Yalnızca giden çağrılar/mesajlar (gelen webhook yok)
Tüm webhook geri çağrılarını ngrok veya Tailscale tünelleri yönetir
Gateway erişimi tarayıcı yerine SSH, proxy veya WireGuard üzerinden sağlanır
Dağıtımın internet tarayıcılarından gizlenmesi gerekir

Kurulum

fly deploy -c deploy/fly.private.toml

Alternatif olarak mevcut bir dağıtımı dönüştürün:

# mevcut IP'leri listele
fly ips list -a my-openclaw

# genel IP'leri serbest bırak
fly ips release <public-ipv4> -a my-openclaw
fly ips release <public-ipv6> -a my-openclaw

# gelecekteki dağıtımların genel IP'leri yeniden tahsis etmemesi için özel yapılandırmaya geç
fly deploy -c deploy/fly.private.toml

# yalnızca özel IPv6 tahsis et
fly ips allocate-v6 --private -a my-openclaw

Bundan sonra, fly ips list yalnızca private türünde bir IP göstermelidir:

SÜRÜM    IP                   TÜR              BÖLGE
v6       fdaa:x:x:x:x::x      özel             genel

Özel bir dağıtıma erişme

Seçenek 1: yerel proxy (en basit)

fly proxy 3000:3000 -a my-openclaw
# bir tarayıcıda http://localhost:3000 adresini aç

Seçenek 2: WireGuard VPN

fly wireguard create
# bir WireGuard istemcisine içe aktar, ardından dahili IPv6 üzerinden eriş
# örnek: http://[fdaa:x:x:x:x::x]:3000

Seçenek 3: yalnızca SSH

fly ssh console -a my-openclaw

Özel dağıtımla Webhook’lar

Genel erişime açmadan Webhook geri çağrıları (Twilio, Telnyx vb.) için:

ngrok tüneli: ngrok’u konteynerin içinde veya bir yardımcı konteyner olarak çalıştırın
Tailscale Funnel: belirli yolları Tailscale üzerinden erişime açın
Yalnızca giden: bazı sağlayıcılar (Twilio), Webhook’lar olmadan giden çağrılar için çalışır

plugins.entries.voice-call.config altında ngrok kullanan örnek sesli arama yapılandırması:

{
  plugins: {
    entries: {
      "voice-call": {
        enabled: true,
        config: {
          provider: "twilio",
          tunnel: { provider: "ngrok" },
          webhookSecurity: {
            allowedHosts: ["example.ngrok.app"],
          },
        },
      },
    },
  },
}

ngrok tüneli konteynerin içinde çalışır ve Fly uygulamasının kendisini erişime açmadan genel bir Webhook URL’si sağlar. İletilen ana makine üstbilgilerinin kabul edilmesi için webhookSecurity.allowedHosts değerini tünelin ana makine adına ayarlayın.

Güvenlik ödünleşimleri

Unsur	Genel	Özel
İnternet tarayıcıları	Keşfedilebilir	Gizli
Doğrudan saldırılar	Mümkün	Engellenmiş
Kontrol arayüzü erişimi	Tarayıcı	Proxy/VPN
Webhook teslimi	Doğrudan	Tünel üzerinden

Notlar

Fly.io x86 mimarisini kullanır; Dockerfile hem x86 hem de ARM ile uyumludur.
WhatsApp/Telegram ilk kurulumu için fly ssh console kullanın.
Kalıcı veriler, /data konumundaki birimde bulunur.
Signal, imajda signal-cli (Java tabanlı bir CLI) gerektirir; özel bir imaj kullanın ve belleği 2GB+ olarak tutun.

Maliyet

Önerilen yapılandırmayla (shared-cpu-2x, 2GB RAM), kullanıma bağlı olarak ayda yaklaşık $10-15 tutarında maliyet bekleyin; ücretsiz katman temel kullanım kotasının bir kısmını karşılar. Güncel ücretler için Fly.io fiyatlandırmasına bakın.

Sonraki adımlar

Mesajlaşma kanallarını ayarlayın: Kanallar
Gateway’i yapılandırın: Gateway yapılandırması
OpenClaw’ı güncel tutun: Güncelleme

Install overview

Maintenance

Containers

Hosting

Advanced setup

Gereksinimler

Yeni başlayanlar için hızlı yol

Control UI

Günlükler

SSH konsolu

Sorun giderme

”Uygulama beklenen adresi dinlemiyor”

Sağlık kontrolleri başarısız / bağlantı reddedildi

OOM / bellek sorunları

Gateway kilidi sorunları

Yapılandırma okunmuyor

Yapılandırmayı SSH üzerinden yazma

Durum kalıcı değil

Güncelleme

Makine komutunu güncelleme

Özel dağıtım (güçlendirilmiş)

Özel dağıtım ne zaman kullanılmalı?

Kurulum

Özel bir dağıtıma erişme

Özel dağıtımla Webhook’lar

Güvenlik ödünleşimleri

Notlar

Maliyet

Sonraki adımlar

İlgili

​Gereksinimler

​Yeni başlayanlar için hızlı yol

​Control UI

​Günlükler

​SSH konsolu

​Sorun giderme

​”Uygulama beklenen adresi dinlemiyor”

​Sağlık kontrolleri başarısız / bağlantı reddedildi

​OOM / bellek sorunları

​Gateway kilidi sorunları

​Yapılandırma okunmuyor

​Yapılandırmayı SSH üzerinden yazma

​Durum kalıcı değil

​Güncelleme

​Makine komutunu güncelleme

​Özel dağıtım (güçlendirilmiş)

​Özel dağıtım ne zaman kullanılmalı?

​Kurulum

​Özel bir dağıtıma erişme

​Özel dağıtımla Webhook’lar

​Güvenlik ödünleşimleri

​Notlar

​Maliyet

​Sonraki adımlar

​İlgili

Gereksinimler

Yeni başlayanlar için hızlı yol

Control UI

Günlükler

SSH konsolu

Sorun giderme

”Uygulama beklenen adresi dinlemiyor”

Sağlık kontrolleri başarısız / bağlantı reddedildi

OOM / bellek sorunları

Gateway kilidi sorunları

Yapılandırma okunmuyor

Yapılandırmayı SSH üzerinden yazma

Durum kalıcı değil

Güncelleme

Makine komutunu güncelleme

Özel dağıtım (güçlendirilmiş)

Özel dağıtım ne zaman kullanılmalı?

Kurulum

Özel bir dağıtıma erişme

Özel dağıtımla Webhook’lar

Güvenlik ödünleşimleri

Notlar

Maliyet

Sonraki adımlar

İlgili