---
read_when:
    - استقرار OpenClaw در Render
    - شما یک استقرار ابری اعلانی با Render Blueprints می‌خواهید
summary: استقرار OpenClaw روی Render با زیرساخت به‌عنوان کد
title: رندر
x-i18n:
    generated_at: "2026-04-29T23:07:17Z"
    model: gpt-5.5
    provider: openai
    source_hash: 95ffe98a60e9919826a7c7fdb9cbafd63d20ce3de111ac305f43907b1ae442dc
    source_path: install/render.mdx
    workflow: 16
---

# Render

OpenClaw را با استفاده از زیرساخت به‌صورت کد روی Render مستقر کنید. `render.yaml` Blueprint همراه، کل پشته شما را به‌صورت اعلامی تعریف می‌کند: سرویس، دیسک، متغیرهای محیطی؛ بنابراین می‌توانید با یک کلیک مستقر کنید و زیرساخت خود را کنار کدتان نسخه‌بندی کنید.

## پیش‌نیازها

- یک [حساب Render](https://render.com) (سطح رایگان موجود است)
- یک کلید API از [ارائه‌دهنده مدل](/fa/providers) دلخواه شما

## استقرار با Render Blueprint

[استقرار در Render](https://render.com/deploy?repo=https://github.com/openclaw/openclaw)

کلیک روی این پیوند:

1. یک سرویس Render جدید از Blueprint `render.yaml` در ریشه این مخزن ایجاد می‌کند.
2. تصویر Docker را می‌سازد و مستقر می‌کند

پس از استقرار، نشانی سرویس شما از الگوی `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      | پس از ۱۵ دقیقه بیکاری | در دسترس نیست | آزمایش، دمو                |
| Starter   | هرگز             | 1GB+          | استفاده شخصی، تیم‌های کوچک     |
| Standard+ | هرگز             | 1GB+          | تولید، چندین کانال |

Blueprint به‌طور پیش‌فرض روی `starter` تنظیم شده است. برای استفاده از سطح رایگان، مقدار `plan: free` را در
`render.yaml` فورک خود تغییر دهید (اما توجه کنید: نبود دیسک پایدار یعنی وضعیت OpenClaw
در هر استقرار بازنشانی می‌شود).

## پس از استقرار

### دسترسی به رابط کنترل

داشبورد وب در `https://<your-service>.onrender.com/` در دسترس است.

با راز مشترک پیکربندی‌شده متصل شوید. این الگوی استقرار
`OPENCLAW_GATEWAY_TOKEN` را به‌صورت خودکار تولید می‌کند (آن را در **داشبورد → سرویس شما →
محیط** پیدا کنید)؛ اگر آن را با احراز هویت گذرواژه‌ای جایگزین می‌کنید، به‌جای آن از همان گذرواژه
استفاده کنید.

## قابلیت‌های داشبورد Render

### گزارش‌ها

گزارش‌های بلادرنگ را در **داشبورد → سرویس شما → گزارش‌ها** ببینید. بر اساس این موارد فیلتر کنید:

- گزارش‌های ساخت (ایجاد تصویر Docker)
- گزارش‌های استقرار (راه‌اندازی سرویس)
- گزارش‌های زمان اجرا (خروجی برنامه)

### دسترسی Shell

برای اشکال‌زدایی، از مسیر **داشبورد → سرویس شما → Shell** یک نشست Shell باز کنید. دیسک پایدار در `/data` سوار شده است.

### متغیرهای محیطی

متغیرها را در **داشبورد → سرویس شما → محیط** تغییر دهید. تغییرات باعث استقرار دوباره خودکار می‌شوند.

### استقرار خودکار

اگر از مخزن اصلی OpenClaw استفاده می‌کنید، Render نسخه OpenClaw شما را به‌صورت خودکار مستقر نمی‌کند. برای به‌روزرسانی آن، از داشبورد یک همگام‌سازی دستی Blueprint اجرا کنید.

## دامنه سفارشی

1. به **داشبورد → سرویس شما → تنظیمات → دامنه‌های سفارشی** بروید
2. دامنه خود را اضافه کنید
3. DNS را طبق دستورالعمل پیکربندی کنید (CNAME به `*.onrender.com`)
4. Render به‌صورت خودکار یک گواهی TLS فراهم می‌کند

## مقیاس‌پذیری

Render از مقیاس‌پذیری افقی و عمودی پشتیبانی می‌کند:

- **عمودی**: پلن را تغییر دهید تا CPU/RAM بیشتری دریافت کنید
- **افقی**: تعداد نمونه‌ها را افزایش دهید (پلن Standard و بالاتر)

برای OpenClaw، مقیاس‌پذیری عمودی معمولا کافی است. مقیاس‌پذیری افقی به نشست‌های چسبنده یا مدیریت وضعیت خارجی نیاز دارد.

## پشتیبان‌گیری و مهاجرت

هر زمان که خواستید، با استفاده از دسترسی Shell در داشبورد Render، وضعیت، پیکربندی، پروفایل‌های احراز هویت و workspace خود را
صادر کنید:

```bash
openclaw backup create
```

این کار یک آرشیو پشتیبان قابل حمل با وضعیت OpenClaw به‌همراه هر workspace پیکربندی‌شده
ایجاد می‌کند. برای جزئیات، [پشتیبان‌گیری](/fa/cli/backup) را ببینید.

## عیب‌یابی

### سرویس شروع نمی‌شود

گزارش‌های استقرار را در داشبورد Render بررسی کنید. مشکلات رایج:

- نبود `OPENCLAW_GATEWAY_TOKEN` — بررسی کنید که در **داشبورد → محیط** تنظیم شده باشد
- ناهماهنگی پورت — مطمئن شوید `OPENCLAW_GATEWAY_PORT=8080` تنظیم شده است تا Gateway به پورتی که Render انتظار دارد متصل شود

### شروع سرد کند (سطح رایگان)

سرویس‌های سطح رایگان پس از ۱۵ دقیقه بی‌فعالیتی خاموش می‌شوند. نخستین درخواست پس از خاموشی چند ثانیه طول می‌کشد تا کانتینر شروع شود. برای همیشه روشن بودن، به پلن Starter ارتقا دهید.

### از دست رفتن داده پس از استقرار دوباره

این اتفاق در سطح رایگان رخ می‌دهد (بدون دیسک پایدار). به یک پلن پولی ارتقا دهید، یا
به‌طور منظم از طریق `openclaw backup create` در Shell مربوط به Render یک پشتیبان کامل صادر کنید.

### شکست بررسی سلامت

Render انتظار دارد ظرف ۳۰ ثانیه از `/health` پاسخ 200 دریافت کند. اگر ساخت‌ها موفق هستند اما استقرارها شکست می‌خورند، ممکن است شروع سرویس بیش از حد طول بکشد. بررسی کنید:

- گزارش‌های ساخت برای خطاها
- اینکه آیا کانتینر به‌صورت محلی با `docker build && docker run` اجرا می‌شود یا نه

## گام‌های بعدی

- راه‌اندازی کانال‌های پیام‌رسانی: [کانال‌ها](/fa/channels)
- پیکربندی Gateway: [پیکربندی Gateway](/fa/gateway/configuration)
- به‌روز نگه داشتن OpenClaw: [به‌روزرسانی](/fa/install/updating)
