Fly.io

Tujuan: OpenClaw Gateway berjalan di mesin Fly.io dengan penyimpanan persisten, HTTPS otomatis, dan akses Discord/channel.

Yang Anda perlukan

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

Jalur cepat pemula

1. Kloning repo → sesuaikan fly.toml
2. Buat aplikasi + volume → atur secrets
3. Deploy dengan fly deploy
4. Masuk melalui SSH untuk membuat konfigurasi atau gunakan Control UI

# Clone the repogit clone https://github.com/openclaw/openclaw.gitcd openclaw # Create a new Fly app (pick your own name)fly apps create my-openclaw # Create a persistent volume (1GB is usually enough)fly volumes create openclaw_data --size 1 --region iad

app = "my-openclaw"  # Your app nameprimary_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"

# Required: Gateway token (for non-loopback binding)fly secrets set OPENCLAW_GATEWAY_TOKEN=$(openssl rand -hex 32) # Model provider API keysfly secrets set ANTHROPIC_API_KEY=example-anthropic-key-not-real # Optional: Other providersfly secrets set OPENAI_API_KEY=example-openai-key-not-realfly secrets set GOOGLE_API_KEY=... # Channel tokensfly secrets set DISCORD_BOT_TOKEN=example-discord-bot-token

fly deploy

fly statusfly logs

[gateway] listening on ws://0.0.0.0:3000 (PID xxx)[discord] logged in to discord as xxx

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              # Live logsfly logs --no-tail    # Recent logs

fly ssh console

Pemecahan masalah

"App is not listening on expected address"

Gateway mengikat ke 127.0.0.1 alih-alih 0.0.0.0.

Perbaikan: Tambahkan --bind lan ke perintah proses Anda di fly.toml.

Pemeriksaan kesehatan gagal / koneksi ditolak

Fly tidak dapat menjangkau gateway pada port yang dikonfigurasi.

Perbaikan: Pastikan internal_port cocok dengan port gateway (atur --port 3000 atau OPENCLAW_GATEWAY_PORT=3000).

OOM / Masalah Memori

Container terus dimulai ulang atau dihentikan. Tanda-tanda: SIGABRT, v8::internal::Runtime_AllocateInYoungGeneration, atau restart diam-diam.

Perbaikan: Tingkatkan memori di fly.toml:

[[vm]]  memory = "2048mb"

Atau perbarui mesin yang ada:

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

Catatan: 512MB terlalu kecil. 1GB mungkin berfungsi tetapi dapat OOM saat beban tinggi atau dengan logging verbose. 2GB direkomendasikan.

Masalah lock Gateway

Gateway menolak mulai dengan error "already running".

Ini terjadi ketika container dimulai ulang tetapi file lock PID tetap ada pada volume.

Perbaikan: Hapus file lock:

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

File lock berada di /data/gateway.*.lock (bukan di subdirektori).

Konfigurasi tidak dibaca

--allow-unconfigured hanya melewati guard startup. Itu tidak membuat atau memperbaiki /data/openclaw.json, jadi pastikan konfigurasi sebenarnya ada dan menyertakan gateway.mode="local" ketika Anda menginginkan startup gateway lokal normal.

Verifikasi konfigurasi ada:

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

Menulis konfigurasi melalui SSH

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

# Use echo + tee (pipe from local to remote)echo '{"your":"config"}' | fly ssh console -C "tee /data/openclaw.json" # Or use sftpfly sftp shell> put /local/path/config.json /data/openclaw.json

Catatan: fly sftp mungkin gagal jika file sudah ada. Hapus terlebih dahulu:

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

State tidak persisten

Jika Anda kehilangan profil autentikasi, state channel/penyedia, atau sesi setelah restart, direktori state sedang menulis ke sistem file container.

Perbaikan: Pastikan OPENCLAW_STATE_DIR=/data diatur di fly.toml dan deploy ulang.

Pembaruan

# Pull latest changesgit pull # Redeployfly deploy # Check healthfly statusfly logs

Memperbarui perintah mesin

Jika Anda perlu mengubah perintah startup tanpa redeploy penuh:

# Get machine IDfly machines list # Update commandfly machine update <machine-id> --command "node dist/index.js gateway --port 3000 --bind lan" -y # Or with memory increasefly machine update <machine-id> --vm-memory 2048 --command "node dist/index.js gateway --port 3000 --bind lan" -y

Catatan: Setelah fly deploy, perintah mesin dapat direset ke yang ada di fly.toml. Jika Anda membuat perubahan manual, terapkan kembali setelah deploy.

Deployment privat (diperkuat)

Secara default, Fly mengalokasikan IP publik, membuat gateway Anda dapat diakses di https://your-app.fly.dev. Ini praktis tetapi berarti deployment Anda dapat ditemukan oleh pemindai internet (Shodan, Censys, dll.).

Untuk deployment yang diperkuat dengan tanpa eksposur publik, gunakan templat privat.

Kapan menggunakan deployment privat

• Anda hanya membuat panggilan/pesan keluar (tanpa webhook masuk)
• Anda menggunakan tunnel ngrok atau Tailscale untuk callback webhook apa pun
• Anda mengakses gateway melalui SSH, proxy, atau WireGuard alih-alih browser
• Anda ingin deployment tersembunyi dari pemindai internet

Penyiapan

Gunakan deploy/fly.private.toml alih-alih konfigurasi standar:

# Deploy with private configfly deploy -c deploy/fly.private.toml

Atau konversi deployment yang ada:

# List current IPsfly ips list -a my-openclaw # Release public IPsfly ips release <public-ipv4> -a my-openclawfly ips release <public-ipv6> -a my-openclaw # Switch to private config so future deploys don't re-allocate public IPs# (remove [http_service] or deploy with the private template)fly deploy -c deploy/fly.private.toml # Allocate private-only IPv6fly ips allocate-v6 --private -a my-openclaw

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

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

Mengakses deployment privat

Karena tidak ada URL publik, gunakan salah satu metode ini:

Opsi 1: Proxy lokal (paling sederhana)

# Forward local port 3000 to the appfly proxy 3000:3000 -a my-openclaw # Then open http://localhost:3000 in browser

Opsi 2: WireGuard VPN

# Create WireGuard config (one-time)fly wireguard create # Import to WireGuard client, then access via internal IPv6# Example: http://[fdaa:x:x:x:x::x]:3000

Opsi 3: hanya SSH

fly ssh console -a my-openclaw

Webhook dengan deployment privat

Jika Anda memerlukan callback webhook (Twilio, Telnyx, dll.) tanpa eksposur publik:

1. tunnel ngrok - Jalankan ngrok di dalam container atau sebagai sidecar
2. Tailscale Funnel - Ekspos path tertentu melalui Tailscale
3. Hanya outbound - Beberapa penyedia (Twilio) berfungsi baik untuk panggilan outbound tanpa webhook

Contoh konfigurasi panggilan suara dengan ngrok:

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

Tunnel ngrok berjalan di dalam container dan menyediakan URL webhook publik tanpa mengekspos aplikasi Fly itu sendiri. Atur webhookSecurity.allowedHosts ke hostname tunnel publik agar header host yang diteruskan diterima.

Manfaat keamanan

Catatan

• Fly.io menggunakan arsitektur x86 (bukan ARM)
• Dockerfile kompatibel dengan kedua arsitektur
• Untuk onboarding WhatsApp/Telegram, gunakan fly ssh console
• Data persisten berada di volume di /data
• Signal memerlukan Java + signal-cli; gunakan image kustom dan pertahankan memori pada 2GB+.

Biaya

Dengan konfigurasi yang direkomendasikan (shared-cpu-2x, RAM 2GB):

• ~$10-15/bulan tergantung penggunaan
• Tingkat gratis mencakup sebagian kuota

Lihat harga Fly.io untuk detail.

Langkah berikutnya

• Siapkan kanal perpesanan: Kanal
• Konfigurasikan Gateway: Konfigurasi Gateway
• Jaga OpenClaw tetap terbaru: Memperbarui

Terkait

• Ikhtisar instalasi
• Hetzner
• Docker
• VPS hosting