---
read_when:
    - نشر OpenClaw على Render
    - تريد نشرًا سحابيًا تصريحيًا باستخدام Render Blueprints
summary: نشر OpenClaw على Render باستخدام Infrastructure-as-Code
title: Render
x-i18n:
    generated_at: "2026-04-05T12:48:34Z"
    model: gpt-5.4
    provider: openai
    source_hash: 379297f0298ddac0c1c657695f52619bb482f7b76d358e765880726f6f558c88
    source_path: install/render.mdx
    workflow: 15
---

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

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

- حساب [Render](https://render.com) ‏(تتوفر فئة مجانية)
- مفتاح API من [مزود النموذج](/providers) المفضل لديك

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

[النشر إلى Render](https://render.com/deploy?repo=https://github.com/openclaw/openclaw)

سيؤدي النقر فوق هذا الرابط إلى:

1. إنشاء خدمة Render جديدة من Blueprint ‏`render.yaml` الموجودة في جذر هذا المستودع.
2. بناء صورة Docker ثم النشر

بعد النشر، سيتبع عنوان URL الخاص بخدمتك النمط `https://<service-name>.onrender.com`.

## فهم Blueprint

تُعد Render Blueprints ملفات YAML تعرّف بنيتك التحتية. ويقوم `render.yaml` الموجود في هذا
المستودع بتكوين كل ما يلزم لتشغيل OpenClaw:

```yaml
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:

```bash
openclaw backup create
```

ينشئ هذا أرشيفًا احتياطيًا محمولًا يتضمن حالة OpenClaw بالإضافة إلى أي
مساحة عمل مكوّنة. راجع [النسخ الاحتياطي](/cli/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`

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

- إعداد قنوات المراسلة: [القنوات](/channels)
- تكوين Gateway: [تكوين Gateway](/gateway/configuration)
- إبقاء OpenClaw محدّثة: [التحديث](/install/updating)
