# Render

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

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

• حساب Render (تتوفر فئة مجانية)
• مفتاح API من موفر النموذج الذي تفضله

# النشر باستخدام 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 # يُنشئ رمزًا آمنًا تلقائيًا
    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 → خدمتك → Environment). وإذا استبدلته بمصادقة كلمة مرور، فاستخدم كلمة المرور تلك بدلًا منه.

# ميزات Render Dashboard

# السجلات

اعرض السجلات في الوقت الفعلي في Dashboard → خدمتك → Logs. يمكنك التصفية حسب:

• سجلات البناء (إنشاء صورة Docker)
• سجلات النشر (بدء تشغيل الخدمة)
• سجلات وقت التشغيل (مخرجات التطبيق)

# الوصول إلى Shell

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

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

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

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

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

# نطاق مخصص

1. انتقل إلى Dashboard → خدمتك → 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 بالإضافة إلى أي مساحة عمل مضبوطة. راجع Backup للتفاصيل.

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

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

تحقق من سجلات النشر في 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

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

• اضبط قنوات المراسلة: القنوات
• اضبط Gateway: تكوين Gateway
• حافظ على تحديث OpenClaw: التحديث