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

Передумови

Розгортання за допомогою 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 цього репозиторію
healthCheckPathRender відстежує /health і перезапускає нездорові екземпляри
generateValue: trueАвтоматично генерує криптографічно безпечне значення
diskПостійне сховище, яке зберігається після повторних розгортань

Вибір тарифу

ТарифЗупинкаДискНайкраще підходить для
FreeПісля 15 хв бездіяльностіНедоступнийТестування, демо
StarterНіколи1GB+Особистого використання, малих команд
Standard+Ніколи1GB+Production, кількох каналів
Blueprint типово використовує starter. Щоб використовувати безкоштовний тариф, змініть plan: free у render.yaml вашого форку (але зверніть увагу: без постійного диска стан OpenClaw скидатиметься після кожного розгортання).

Після розгортання

Доступ до Control UI

Вебпанель доступна за адресою https://<your-service>.onrender.com/. Підключайтеся, використовуючи налаштований спільний секрет. Цей шаблон розгортання автоматично генерує OPENCLAW_GATEWAY_TOKEN (знайдіть його в Dashboard → ваш сервіс → Environment); якщо ви заміните його на автентифікацію паролем, використовуйте натомість цей пароль.

Можливості Render Dashboard

Logs

Переглядайте журнали в реальному часі в Dashboard → ваш сервіс → Logs. Можна фільтрувати:
  • Журнали збирання (створення Docker-образу)
  • Журнали розгортання (запуск сервісу)
  • Журнали runtime (вивід застосунку)

Доступ до 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 sessions або зовнішнього керування станом.

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

Експортуйте свій стан, конфігурацію, профілі автентифікації та workspace у будь-який момент через доступ до shell у Render Dashboard:
openclaw backup create
Це створює переносний архів резервної копії зі станом OpenClaw і будь-яким налаштованим workspace. Докладніше див. у Backup.

Усунення несправностей

Сервіс не запускається

Перевірте журнали розгортання в Render Dashboard. Типові проблеми:
  • Відсутній OPENCLAW_GATEWAY_TOKEN — переконайтеся, що його задано в Dashboard → Environment
  • Невідповідність порту — переконайтеся, що задано OPENCLAW_GATEWAY_PORT=8080, щоб gateway прив’язувався до порту, який очікує Render

Повільний cold start (безкоштовний тариф)

Сервіси безкоштовного тарифу зупиняються після 15 хвилин бездіяльності. Перший запит після зупинки займає кілька секунд, поки контейнер запускається. Перейдіть на тариф Starter для постійної роботи.

Втрата даних після повторного розгортання

Це трапляється на безкоштовному тарифі (немає постійного диска). Перейдіть на платний тариф або регулярно експортуйте повну резервну копію через openclaw backup create у shell Render.

Помилки перевірки стану

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

Наступні кроки