# Render

Розгорніть OpenClaw на Render за допомогою Infrastructure as Code. Включений Blueprint render.yaml декларативно визначає весь ваш стек, сервіс, диск, змінні середовища, тож ви можете розгорнути все в один клік і версіонувати інфраструктуру разом із кодом.

# Передумови

• Обліковий запис Render (доступний безкоштовний тариф)
• API-ключ від обраного вами провайдера моделей

# Розгортання за допомогою Render Blueprint

Deploy to 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-образу)
• журналами розгортання (запуск сервісу)
• журналами runtime (вивід застосунку)

# Доступ до оболонки

Для налагодження відкрийте сесію оболонки через 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 підтримує горизонтальне та вертикальне масштабування:

• Vertical: змініть тариф, щоб отримати більше CPU/RAM
• Horizontal: збільште кількість інстансів (тариф Standard і вище)

Для OpenClaw зазвичай достатньо вертикального масштабування. Горизонтальне масштабування потребує sticky sessions або зовнішнього керування станом.

# Резервні копії та міграція

Експортуйте стан, конфігурацію, auth profiles і робочий простір у будь-який час за допомогою доступу до оболонки в 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 в оболонці Render.

# Збої перевірки працездатності

Render очікує відповідь 200 від /health протягом 30 секунд. Якщо збирання успішне, але розгортання завершується збоєм, сервіс може запускатися надто довго. Перевірте:

• журнали збирання на наявність помилок
• чи запускається контейнер локально за допомогою docker build && docker run

# Подальші кроки

• Налаштуйте канали обміну повідомленнями: Channels
• Налаштуйте Gateway: Gateway configuration
• Підтримуйте OpenClaw в актуальному стані: Updating