# Render

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

# پیش‌نیازها

• یک حساب Render (سطح رایگان موجود است)
• یک کلید API از ارائه‌دهنده مدل دلخواه شما

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

استقرار در Render

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

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

پس از استقرار، نشانی سرویس شما از الگوی 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	پس از ۱۵ دقیقه بیکاری	در دسترس نیست	آزمایش، دمو
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 خود را صادر کنید:

openclaw backup create

این کار یک آرشیو پشتیبان قابل حمل با وضعیت OpenClaw به‌همراه هر workspace پیکربندی‌شده ایجاد می‌کند. برای جزئیات، پشتیبان‌گیری را ببینید.

# عیب‌یابی

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

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

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

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

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

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

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

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

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

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

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

• راه‌اندازی کانال‌های پیام‌رسانی: کانال‌ها
• پیکربندی Gateway: پیکربندی Gateway
• به‌روز نگه داشتن OpenClaw: به‌روزرسانی