Fly.io

هدف: اجرای OpenClaw Gateway روی یک ماشین Fly.io با ذخیره‌سازی پایدار، HTTPS خودکار، و دسترسی Discord/کانال.

آنچه نیاز دارید

• نصب بودن flyctl CLI
• حساب Fly.io (سطح رایگان هم کافی است)
• احراز هویت مدل: کلید API برای ارائه‌دهنده مدل انتخابی شما
• اعتبارنامه‌های کانال: توکن ربات Discord، توکن Telegram، و غیره.

مسیر سریع برای مبتدیان

1. مخزن را کلون کنید → fly.toml را سفارشی کنید
2. برنامه + حجم را بسازید → secretها را تنظیم کنید
3. با fly deploy استقرار دهید
4. با SSH وارد شوید تا پیکربندی بسازید یا از 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

عیب‌یابی

«برنامه روی آدرس مورد انتظار در حال گوش دادن نیست»

Gateway به‌جای 0.0.0.0 به 127.0.0.1 متصل شده است.

راه‌حل: --bind lan را به فرمان فرایند خود در fly.toml اضافه کنید.

بررسی‌های سلامت ناموفق هستند / اتصال رد شد

Fly نمی‌تواند روی پورت پیکربندی‌شده به Gateway برسد.

راه‌حل: مطمئن شوید internal_port با پورت Gateway مطابقت دارد (--port 3000 یا OPENCLAW_GATEWAY_PORT=3000 را تنظیم کنید).

OOM / مشکلات حافظه

کانتینر مدام راه‌اندازی مجدد می‌شود یا کشته می‌شود. نشانه‌ها: SIGABRT، v8::internal::Runtime_AllocateInYoungGeneration، یا راه‌اندازی‌های مجدد بی‌صدا.

راه‌حل: حافظه را در fly.toml افزایش دهید:

[[vm]]  memory = "2048mb"

یا یک ماشین موجود را به‌روزرسانی کنید:

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

یادداشت: 512 مگابایت خیلی کم است. 1 گیگابایت ممکن است کار کند، اما زیر بار یا با لاگ‌گیری مفصل ممکن است دچار OOM شود. 2 گیگابایت توصیه می‌شود.

مشکلات قفل Gateway

Gateway با خطاهای «already running» از شروع شدن خودداری می‌کند.

این زمانی رخ می‌دهد که کانتینر راه‌اندازی مجدد می‌شود اما فایل قفل PID روی volume باقی می‌ماند.

راه‌حل: فایل قفل را حذف کنید:

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

فایل قفل در /data/gateway.*.lock قرار دارد (نه در یک زیردایرکتوری).

پیکربندی خوانده نمی‌شود

--allow-unconfigured فقط guard راه‌اندازی را دور می‌زند. این گزینه /data/openclaw.json را نمی‌سازد یا تعمیر نمی‌کند، بنابراین مطمئن شوید پیکربندی واقعی شما وجود دارد و وقتی یک شروع معمولی Gateway محلی می‌خواهید، شامل gateway.mode="local" است.

وجود پیکربندی را بررسی کنید:

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

نوشتن پیکربندی از طریق SSH

فرمان fly ssh console -C از redirection شل پشتیبانی نمی‌کند. برای نوشتن یک فایل پیکربندی:

# 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

یادداشت: اگر فایل از قبل وجود داشته باشد، fly sftp ممکن است شکست بخورد. ابتدا حذف کنید:

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

وضعیت پایدار نمی‌ماند

اگر پس از راه‌اندازی مجدد، پروفایل‌های احراز هویت، وضعیت کانال/ارائه‌دهنده، یا sessionها را از دست می‌دهید، دایرکتوری وضعیت روی فایل‌سیستم کانتینر نوشته می‌شود.

راه‌حل: مطمئن شوید OPENCLAW_STATE_DIR=/data در fly.toml تنظیم شده است و دوباره استقرار دهید.

به‌روزرسانی‌ها

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

به‌روزرسانی فرمان ماشین

اگر لازم است فرمان راه‌اندازی را بدون استقرار کامل تغییر دهید:

# 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

یادداشت: پس از fly deploy، فرمان ماشین ممکن است به چیزی که در fly.toml است بازنشانی شود. اگر تغییرات دستی انجام داده‌اید، پس از استقرار دوباره آن‌ها را اعمال کنید.

استقرار خصوصی (سخت‌گیرانه)

به‌طور پیش‌فرض، Fly IPهای عمومی اختصاص می‌دهد و Gateway شما را در https://your-app.fly.dev در دسترس قرار می‌دهد. این راحت است، اما یعنی استقرار شما توسط اسکنرهای اینترنتی (Shodan، Censys، و غیره) قابل کشف است.

برای یک استقرار سخت‌گیرانه‌تر با بدون در معرض‌گذاری عمومی، از الگوی خصوصی استفاده کنید.

چه زمانی از استقرار خصوصی استفاده کنید

• فقط تماس‌ها/پیام‌های خروجی انجام می‌دهید (بدون Webhook ورودی)
• از تونل‌های ngrok یا Tailscale برای هر callback مربوط به Webhook استفاده می‌کنید
• به‌جای مرورگر از طریق SSH، پراکسی، یا WireGuard به Gateway دسترسی دارید
• می‌خواهید استقرار از اسکنرهای اینترنتی پنهان باشد

راه‌اندازی

به‌جای پیکربندی استاندارد، از deploy/fly.private.toml استفاده کنید:

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

یا یک استقرار موجود را تبدیل کنید:

# 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

پس از این، fly ips list باید فقط یک IP از نوع private نشان دهد:

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

دسترسی به استقرار خصوصی

از آنجا که URL عمومی وجود ندارد، از یکی از این روش‌ها استفاده کنید:

گزینه 1: پراکسی محلی (ساده‌ترین)

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

گزینه ۲: VPN WireGuard

# 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

گزینه ۳: فقط SSH

fly ssh console -a my-openclaw

Webhookها با استقرار خصوصی

اگر به callbackهای Webhook (Twilio، Telnyx و غیره) بدون در معرض عموم قرار گرفتن نیاز دارید:

1. تونل ngrok - ngrok را داخل کانتینر یا به‌صورت sidecar اجرا کنید
2. Tailscale Funnel - مسیرهای مشخصی را از طریق Tailscale در دسترس قرار دهید
3. فقط خروجی - برخی ارائه‌دهندگان (Twilio) برای تماس‌های خروجی بدون Webhook به‌خوبی کار می‌کنند

نمونه پیکربندی تماس صوتی با ngrok:

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

تونل ngrok داخل کانتینر اجرا می‌شود و بدون افشای خود برنامه Fly، یک URL عمومی برای Webhook فراهم می‌کند. webhookSecurity.allowedHosts را روی hostname عمومی تونل تنظیم کنید تا headerهای host فورواردشده پذیرفته شوند.

مزایای امنیتی

نکات

• Fly.io از معماری x86 استفاده می‌کند (نه ARM)
• Dockerfile با هر دو معماری سازگار است
• برای راه‌اندازی WhatsApp/Telegram، از fly ssh console استفاده کنید
• داده‌های پایدار روی volume در /data قرار دارند
• Signal به Java + signal-cli نیاز دارد؛ از یک image سفارشی استفاده کنید و حافظه را روی 2GB+ نگه دارید.

هزینه

با پیکربندی پیشنهادی (shared-cpu-2x، ۲ گیگابایت RAM):

• حدود ۱۰ تا ۱۵ دلار در ماه، بسته به میزان استفاده
• tier رایگان شامل مقداری سهمیه است

برای جزئیات، قیمت‌گذاری Fly.io را ببینید.

مراحل بعدی

• کانال‌های پیام‌رسانی را راه‌اندازی کنید: کانال‌ها
• Gateway را پیکربندی کنید: پیکربندی Gateway
• OpenClaw را به‌روز نگه دارید: به‌روزرسانی

مرتبط

• نمای کلی نصب
• Hetzner
• Docker
• میزبانی VPS