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

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

git clone https://github.com/openclaw/openclaw.gitcd openclaw # kendi adınızı seçinfly apps create my-openclaw # 1 GB genellikle yeterlidirfly volumes create openclaw_data --size 1 --region iad

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"

# zorunlu: geri döngü dışı bağlama için gateway kimlik doğrulama belirtecifly 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ılarfly secrets set OPENAI_API_KEY=example-openai-key-not-realfly secrets set GOOGLE_API_KEY=... # kanal belirteçlerifly secrets set DISCORD_BOT_TOKEN=example-discord-bot-token

fly deploy

fly statusfly logs

fly ssh console

mkdir -p /datacat > /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

exitfly machine restart <machine-id>

fly open

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

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 sftpfly 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 pullfly deployfly statusfly 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 listfly machine update <machine-id> --command "node dist/index.js gateway --port 3000 --bind lan" -y # veya bellek artışıyla birliktefly 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 listelefly ips list -a my-openclaw # genel IP'leri serbest bırakfly ips release <public-ipv4> -a my-openclawfly 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 etfly 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ÖLGEv6       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:

1. ngrok tüneli: ngrok'u konteynerin içinde veya bir yardımcı konteyner olarak çalıştırın
2. Tailscale Funnel: belirli yolları Tailscale üzerinden erişime açın
3. 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

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

İlgili

• Kuruluma genel bakış
• Hetzner
• Docker
• VPS barındırma