Fly.io

الهدف: تشغيل OpenClaw Gateway على جهاز Fly.io مع تخزين دائم، وHTTPS تلقائي، ووصول Discord/القنوات.

ما تحتاجه

• تثبيت flyctl CLI
• حساب Fly.io (تعمل الخطة المجانية)
• مصادقة النموذج: مفتاح API لمزوّد النموذج الذي تختاره
• بيانات اعتماد القناة: رمز بوت Discord، رمز Telegram، إلخ.

المسار السريع للمبتدئين

1. استنسخ المستودع ← خصّص fly.toml
2. أنشئ التطبيق + وحدة التخزين ← اضبط الأسرار
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

استكشاف الأخطاء وإصلاحها

"App is not listening on expected address"

يرتبط Gateway بـ 127.0.0.1 بدلًا من 0.0.0.0.

الإصلاح: أضف --bind lan إلى أمر العملية في fly.toml.

فشل فحوصات الصحة / رفض الاتصال

لا يستطيع Fly الوصول إلى Gateway على المنفذ المُعد.

الإصلاح: تأكد من أن internal_port يطابق منفذ Gateway (اضبط --port 3000 أو OPENCLAW_GATEWAY_PORT=3000).

نفاد الذاكرة / مشكلات الذاكرة

تستمر الحاوية في إعادة التشغيل أو تتعرض للقتل. العلامات: SIGABRT، أو v8::internal::Runtime_AllocateInYoungGeneration، أو عمليات إعادة تشغيل صامتة.

الإصلاح: زد الذاكرة في fly.toml:

[[vm]]  memory = "2048mb"

أو حدّث جهازًا موجودًا:

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

ملاحظة: 512MB صغيرة جدًا. قد تعمل 1GB لكنها قد تواجه نفادًا للذاكرة تحت الحمل أو مع التسجيل المطوّل. يوصى بـ 2GB.

مشكلات قفل Gateway

يرفض Gateway البدء مع أخطاء "already running".

يحدث هذا عندما تعيد الحاوية التشغيل لكن ملف قفل PID يبقى على وحدة التخزين.

الإصلاح: احذف ملف القفل:

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

يوجد ملف القفل في /data/gateway.*.lock (وليس في دليل فرعي).

عدم قراءة الإعدادات

يتجاوز --allow-unconfigured حارس بدء التشغيل فقط. لا ينشئ أو يصلح /data/openclaw.json، لذلك تأكد من وجود إعداداتك الحقيقية وأنها تتضمن gateway.mode="local" عندما تريد بدء Gateway محلي عادي.

تحقق من وجود الإعدادات:

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

كتابة الإعدادات عبر SSH

لا يدعم الأمر fly ssh console -C إعادة توجيه الصدفة. لكتابة ملف إعدادات:

# 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"

عدم استمرار الحالة

إذا فقدت ملفات تعريف المصادقة، أو حالة القناة/المزوّد، أو الجلسات بعد إعادة التشغيل، فإن دليل الحالة يكتب إلى نظام ملفات الحاوية.

الإصلاح: تأكد من ضبط 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 لأي عمليات رد Webhook
• تصل إلى Gateway عبر SSH أو وكيل أو WireGuard بدلًا من المتصفح
• تريد أن يكون النشر مخفيًا عن ماسحات الإنترنت

الإعداد

استخدم 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

الخيار 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

الخيار 3: SSH فقط

fly ssh console -a my-openclaw

Webhooks مع النشر الخاص

إذا كنت تحتاج إلى استدعاءات Webhook راجعة (Twilio، Telnyx، وما إلى ذلك) من دون تعريض عام:

1. نفق ngrok - شغّل ngrok داخل الحاوية أو كحاوية جانبية
2. Tailscale Funnel - عرّض مسارات محددة عبر Tailscale
3. صادر فقط - يعمل بعض المزوّدين (Twilio) بشكل جيد للمكالمات الصادرة من دون Webhooks

مثال على إعداد مكالمات صوتية باستخدام ngrok:

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

يعمل نفق ngrok داخل الحاوية ويوفّر عنوان URL عامًا للـ Webhook من دون تعريض تطبيق Fly نفسه. اضبط webhookSecurity.allowedHosts على اسم مضيف النفق العام حتى تُقبَل ترويسات المضيف المُمرَّرة.

فوائد الأمان

ملاحظات

• يستخدم Fly.io معمارية x86 (وليس ARM)
• ملف Dockerfile متوافق مع كلتا المعماريتين
• لإعداد WhatsApp/Telegram، استخدم fly ssh console
• تعيش البيانات الدائمة على وحدة التخزين في /data
• يتطلب Signal Java + signal-cli؛ استخدم صورة مخصصة وأبقِ الذاكرة عند 2GB+.

التكلفة

مع الإعداد الموصى به (shared-cpu-2x، وذاكرة 2GB RAM):

• نحو 10-15 دولارًا أمريكيًا/شهرًا حسب الاستخدام
• تتضمن الطبقة المجانية قدرًا من الحصة

راجع تسعير Fly.io للاطلاع على التفاصيل.

الخطوات التالية

• إعداد قنوات المراسلة: القنوات
• تهيئة Gateway: تهيئة Gateway
• إبقاء OpenClaw محدّثًا: التحديث

ذات صلة

• نظرة عامة على التثبيت
• Hetzner
• Docker
• استضافة VPS