الانتقال إلى المحتوى الرئيسي
انشر OpenClaw على Render باستخدام Infrastructure as Code. يعرّف Blueprint المضمّن render.yaml مكدسك بالكامل بشكل تصريحي، بما في ذلك الخدمة والقرص ومتغيرات البيئة، بحيث يمكنك النشر بنقرة واحدة وتتبّع بنية البنية التحتية الخاصة بك إلى جانب الشفرة.

​
المتطلبات المسبقة

​
النشر باستخدام Render Blueprint

النشر إلى Render سيؤدي النقر فوق هذا الرابط إلى:
  1. إنشاء خدمة Render جديدة من Blueprint ‏render.yaml الموجودة في جذر هذا المستودع.
  2. بناء صورة Docker ثم النشر
بعد النشر، سيتبع عنوان URL الخاص بخدمتك النمط https://<service-name>.onrender.com.

​
فهم Blueprint

تُعد Render Blueprints ملفات YAML تعرّف بنيتك التحتية. ويقوم render.yaml الموجود في هذا المستودع بتكوين كل ما يلزم لتشغيل OpenClaw: 
services:
  - type: web
    name: openclaw
    runtime: docker
    plan: starter
    healthCheckPath: /health
    envVars:
      - key: OPENCLAW_GATEWAY_PORT
        value: "8080"
      - key: OPENCLAW_STATE_DIR
        value: /data/.openclaw
      - key: OPENCLAW_WORKSPACE_DIR
        value: /data/workspace
      - key: OPENCLAW_GATEWAY_TOKEN
        generateValue: true # auto-generates a secure token
    disk:
      name: openclaw-data
      mountPath: /data
      sizeGB: 1
ميزات Blueprint الأساسية المستخدمة:
الميزةالغرض
runtime: dockerالبناء من Dockerfile الخاصة بالمستودع
healthCheckPathيراقب Render المسار /health ويعيد تشغيل المثيلات غير السليمة
generateValue: trueيولّد قيمة آمنة تشفيريًا تلقائيًا
diskتخزين دائم يبقى عبر عمليات إعادة النشر

​
اختيار الخطة

الخطةالإيقاف التلقائيالقرصالأنسب لـ
Freeبعد 15 دقيقة من الخمولغير متوفرالاختبار، والعروض التوضيحية
Starterأبدًا1GB+الاستخدام الشخصي، والفرق الصغيرة
Standard+أبدًا1GB+الإنتاج، وقنوات متعددة
تستخدم Blueprint خطة starter افتراضيًا. لاستخدام الفئة المجانية، غيّر plan: free في ملف render.yaml ضمن نسختك المتشعبة (لكن لاحظ: عدم وجود قرص دائم يعني أن حالة OpenClaw ستُعاد تهيئتها عند كل نشر).

​
بعد النشر

​
الوصول إلى Control UI

تتوفر لوحة الويب على https://<your-service>.onrender.com/. اتصل باستخدام السر المشترك المكوَّن. يقوم قالب النشر هذا بإنشاء OPENCLAW_GATEWAY_TOKEN تلقائيًا (يمكنك العثور عليه في Dashboard → your service → Environment)، وإذا استبدلته بمصادقة كلمة المرور فاستخدم تلك الكلمة بدلًا منه.

​
ميزات Render Dashboard

​
السجلات

اعرض السجلات اللحظية في Dashboard → your service → Logs. ويمكنك التصفية حسب:
  • سجلات البناء (إنشاء صورة Docker)
  • سجلات النشر (بدء تشغيل الخدمة)
  • سجلات وقت التشغيل (خرج التطبيق)

​
الوصول إلى shell

لأغراض تصحيح الأخطاء، افتح جلسة shell عبر Dashboard → your service → Shell. يتم تركيب القرص الدائم عند /data.

​
متغيرات البيئة

عدّل المتغيرات في Dashboard → your service → Environment. تؤدي التغييرات إلى إعادة نشر تلقائية.

​
النشر التلقائي

إذا كنت تستخدم مستودع OpenClaw الأصلي، فلن يقوم Render بالنشر التلقائي لـ OpenClaw الخاصة بك. ولتحديثها، شغّل مزامنة Blueprint يدوية من لوحة التحكم.

​
نطاق مخصص

  1. انتقل إلى Dashboard → your service → Settings → Custom Domains
  2. أضف نطاقك
  3. كوّن DNS حسب التعليمات (CNAME إلى *.onrender.com)
  4. يوفّر Render شهادة TLS تلقائيًا

​
التوسّع

يدعم Render التوسّع الأفقي والرأسي:
  • رأسيًا: غيّر الخطة للحصول على CPU/RAM أكثر
  • أفقيًا: زد عدد المثيلات (خطة Standard وما فوق)
بالنسبة إلى OpenClaw، يكون التوسّع الرأسي كافيًا عادةً. أما التوسّع الأفقي فيتطلب جلسات sticky أو إدارة حالة خارجية.

​
النسخ الاحتياطية والترحيل

يمكنك تصدير حالتك وتكوينك وملفات تعريف المصادقة ومساحة العمل في أي وقت باستخدام الوصول إلى shell في Render Dashboard: 
openclaw backup create
ينشئ هذا أرشيفًا احتياطيًا محمولًا يتضمن حالة OpenClaw بالإضافة إلى أي مساحة عمل مكوّنة. راجع النسخ الاحتياطي للتفاصيل.

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

​
الخدمة لا تبدأ

تحقّق من سجلات النشر في Render Dashboard. المشكلات الشائعة:
  • عدم وجود OPENCLAW_GATEWAY_TOKEN — تحقق من تعيينه في Dashboard → Environment
  • عدم تطابق المنفذ — تأكد من تعيين OPENCLAW_GATEWAY_PORT=8080 حتى ترتبط gateway بالمنفذ الذي يتوقعه Render

​
بطء البدء البارد (الفئة المجانية)

تتوقف خدمات الفئة المجانية بعد 15 دقيقة من عدم النشاط. ويستغرق أول طلب بعد الإيقاف بضع ثوانٍ أثناء بدء تشغيل الحاوية. قم بالترقية إلى خطة Starter للحصول على تشغيل دائم.

​
فقدان البيانات بعد إعادة النشر

يحدث هذا في الفئة المجانية (من دون قرص دائم). قم بالترقية إلى خطة مدفوعة، أو صدّر نسخة احتياطية كاملة بانتظام عبر openclaw backup create في shell الخاص بـ Render.

​
إخفاقات فحص السلامة

يتوقع Render استجابة 200 من /health خلال 30 ثانية. وإذا نجحت عمليات البناء لكن فشلت عمليات النشر، فقد تكون الخدمة تستغرق وقتًا طويلًا جدًا لبدء التشغيل. تحقق من:
  • سجلات البناء بحثًا عن أخطاء
  • ما إذا كانت الحاوية تعمل محليًا باستخدام docker build && docker run

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