Fly.io

Tujuan: Gateway OpenClaw berjalan pada mesin Fly.io dengan penyimpanan persisten, HTTPS otomatis, serta akses Discord/kanal.

Yang Anda perlukan

• CLI flyctl terinstal
• Akun Fly.io (tingkat gratis dapat digunakan)
• Autentikasi model: kunci API untuk penyedia model pilihan Anda
• Kredensial kanal: token bot Discord, token Telegram, dan sebagainya

Jalur cepat untuk pemula

1. Klon repositori, sesuaikan fly.toml
2. Buat aplikasi + volume, tetapkan rahasia
3. Terapkan dengan fly deploy
4. Masuk melalui SSH untuk membuat konfigurasi, atau gunakan UI Kontrol

git clone https://github.com/openclaw/openclaw.gitcd openclaw # pilih nama Anda sendirifly apps create my-openclaw # 1 GB biasanya cukupfly volumes create openclaw_data --size 1 --region iad

app = "my-openclaw"  # nama aplikasi Andaprimary_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"

# wajib: token autentikasi gateway untuk pengikatan non-loopbackfly secrets set OPENCLAW_GATEWAY_TOKEN=$(openssl rand -hex 32) # kunci API penyedia modelfly secrets set ANTHROPIC_API_KEY=example-anthropic-key-not-real # opsional: penyedia lainfly secrets set OPENAI_API_KEY=example-openai-key-not-realfly secrets set GOOGLE_API_KEY=... # token kanalfly 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              # log langsungfly logs --no-tail    # log terbaru

fly ssh console

Pemecahan masalah

"Aplikasi tidak mendengarkan pada alamat yang diharapkan"

Gateway mengikat ke 127.0.0.1, bukan ke 0.0.0.0.

Perbaikan: tambahkan --bind lan ke perintah proses Anda dalam fly.toml.

Pemeriksaan kesehatan gagal / koneksi ditolak

Fly tidak dapat menjangkau Gateway pada porta yang dikonfigurasi.

Perbaikan: pastikan internal_port cocok dengan porta Gateway (--port 3000 atau OPENCLAW_GATEWAY_PORT=3000).

OOM / masalah memori

Kontainer terus dimulai ulang atau dihentikan secara paksa. Tandanya: SIGABRT, v8::internal::Runtime_AllocateInYoungGeneration, atau mulai ulang tanpa pesan.

Perbaikan: tingkatkan memori dalam fly.toml:

[[vm]]  memory = "2048mb"

Atau perbarui mesin yang sudah ada:

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

512 MB terlalu kecil. 1 GB mungkin dapat digunakan, tetapi dapat mengalami OOM ketika beban tinggi atau pencatatan log mendetail diaktifkan. Disarankan 2 GB.

Masalah penguncian Gateway

Gateway menolak dimulai dengan galat "sudah berjalan" setelah kontainer dimulai ulang.

Berkas kunci instans tunggal berada di <tmpdir>/openclaw-<uid>/gateway.<hash>.lock (Linux: /tmp/openclaw-<uid>/gateway.<hash>.lock), bukan pada volume persisten /data, sehingga mulai ulang kontainer sepenuhnya biasanya menghapusnya bersama seluruh sistem berkas kontainer lainnya. Jika kunci tetap bertahan (misalnya setelah fly machine restart yang mempertahankan sistem berkas kontainer) dan menghalangi proses awal, hapus secara manual:

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

Konfigurasi tidak dibaca

--allow-unconfigured hanya melewati pengaman proses awal. Opsi tersebut tidak membuat atau memperbaiki /data/openclaw.json, jadi pastikan konfigurasi Anda benar-benar tersedia dan menyertakan "gateway": { "mode": "local" } untuk memulai Gateway lokal secara normal.

Verifikasi bahwa konfigurasi tersedia:

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

Menulis konfigurasi melalui SSH

fly ssh console -C tidak mendukung pengalihan shell. Untuk menulis berkas konfigurasi:

# echo + tee (salurkan dari lokal ke jarak jauh)echo '{"your":"config"}' | fly ssh console -C "tee /data/openclaw.json" # atau sftpfly sftp shell> put /local/path/config.json /data/openclaw.json

fly sftp mungkin gagal jika berkas sudah tersedia; hapus terlebih dahulu:

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

Status tidak dipertahankan

Jika profil autentikasi, status kanal/penyedia, atau sesi hilang setelah mulai ulang, direktori status sedang ditulis ke sistem berkas kontainer, bukan ke volume.

Perbaikan: pastikan OPENCLAW_STATE_DIR=/data ditetapkan dalam fly.toml, lalu terapkan ulang.

Memperbarui

git pullfly deployfly statusfly logs

git pull + fly deploy adalah jalur yang diawasi di sini: perintah tersebut membangun ulang citra dari Dockerfile, sehingga versi CLI/Gateway, citra sistem operasi dasar, dan setiap perubahan Dockerfile diperbarui secara bersamaan. openclaw update di dalam kontainer yang sedang berjalan bukan operasi yang sama karena citra dikirim sebagai pohon dist/ hasil pembangunan Docker, tanpa salinan kerja .git dan tanpa instalasi global yang dikelola npm untuk dideteksi; lihat Memperbarui untuk alur tersebut pada instalasi bergaya VM.

Memperbarui perintah mesin

Untuk mengubah perintah proses awal tanpa penerapan ulang penuh:

fly machines listfly machine update <machine-id> --command "node dist/index.js gateway --port 3000 --bind lan" -y # atau dengan peningkatan memorifly machine update <machine-id> --vm-memory 2048 --command "node dist/index.js gateway --port 3000 --bind lan" -y

fly deploy berikutnya mengatur ulang perintah mesin ke nilai yang tercantum dalam fly.toml; terapkan kembali perubahan manual setelah penerapan ulang.

Penerapan privat (diperkuat)

Secara bawaan, Fly mengalokasikan IP publik, sehingga Gateway Anda dapat dijangkau di https://your-app.fly.dev dan ditemukan oleh pemindai internet (Shodan, Censys, dan sebagainya).

Gunakan deploy/fly.private.toml untuk penerapan yang diperkuat dengan tanpa IP publik: konfigurasi ini tidak menyertakan [http_service], sehingga tidak ada akses masuk publik yang dialokasikan.

Kapan menggunakan penerapan privat

• Hanya panggilan/pesan keluar (tanpa Webhook masuk)
• Terowongan ngrok atau Tailscale menangani semua panggilan balik Webhook
• Akses Gateway dilakukan melalui SSH, proksi, atau WireGuard, bukan melalui peramban
• Penerapan harus disembunyikan dari pemindai internet

Penyiapan

fly deploy -c deploy/fly.private.toml

Atau konversikan penerapan yang sudah ada:

# tampilkan IP saat inifly ips list -a my-openclaw # lepaskan IP publikfly ips release <public-ipv4> -a my-openclawfly ips release <public-ipv6> -a my-openclaw # beralih ke konfigurasi privat agar penerapan berikutnya tidak mengalokasikan ulang IP publikfly deploy -c deploy/fly.private.toml # alokasikan IPv6 privat sajafly ips allocate-v6 --private -a my-openclaw

Setelah ini, fly ips list seharusnya hanya menampilkan IP berjenis private:

VERSION  IP                   TYPE             REGIONv6       fdaa:x:x:x:x::x      private          global

Mengakses penerapan privat

Opsi 1: proksi lokal (paling sederhana)

fly proxy 3000:3000 -a my-openclaw# buka http://localhost:3000 di peramban

Opsi 2: VPN WireGuard

fly wireguard create# impor ke klien WireGuard, lalu akses melalui IPv6 internal# contoh: http://[fdaa:x:x:x:x::x]:3000

Opsi 3: hanya SSH

fly ssh console -a my-openclaw

Webhook dengan penerapan privat

Untuk panggilan balik webhook (Twilio, Telnyx, dan sebagainya) tanpa mengeksposnya ke publik:

1. Terowongan ngrok: jalankan ngrok di dalam kontainer atau sebagai sidecar
2. Tailscale Funnel: ekspos jalur tertentu melalui Tailscale
3. Hanya keluar: beberapa penyedia (Twilio) dapat digunakan untuk panggilan keluar tanpa webhook

Contoh konfigurasi panggilan suara dengan ngrok, di bawah plugins.entries.voice-call.config:

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

Terowongan ngrok berjalan di dalam kontainer dan menyediakan URL webhook publik tanpa mengekspos aplikasi Fly itu sendiri. Atur webhookSecurity.allowedHosts ke nama host terowongan agar header host yang diteruskan dapat diterima.

Kompromi keamanan

Catatan

• Fly.io menggunakan arsitektur x86; Dockerfile kompatibel dengan x86 dan ARM.
• Untuk orientasi WhatsApp/Telegram, gunakan fly ssh console.
• Data persisten berada di volume pada /data.
• Signal memerlukan signal-cli (CLI berbasis Java) di dalam citra; gunakan citra khusus dan pertahankan memori sebesar 2 GB atau lebih.

Biaya

Dengan konfigurasi yang direkomendasikan (shared-cpu-2x, RAM 2 GB), perkirakan biayanya sekitar $10–15/bulan, tergantung pada penggunaan; tingkat gratis mencakup sebagian alokasi dasar. Lihat harga Fly.io untuk tarif terkini.

Langkah selanjutnya

• Siapkan kanal perpesanan: Kanal
• Konfigurasikan Gateway: Konfigurasi Gateway
• Pastikan OpenClaw selalu mutakhir: Memperbarui

Terkait

• Ikhtisar instalasi
• Hetzner
• Docker
• Hosting VPS