render.yaml декларативно визначає весь ваш стек: сервіс, диск, змінні середовища, тож ви можете розгорнути все в один клік і версіонувати інфраструктуру разом із кодом.
Передумови
- Обліковий запис Render (доступний безкоштовний тариф)
- Ключ API від вашого бажаного провайдера моделей
Розгортання за допомогою Render Blueprint
Deploy to Render Натискання цього посилання:- Створить новий сервіс Render з Blueprint
render.yamlу корені цього репозиторію. - Збере Docker-образ і виконає розгортання
https://<service-name>.onrender.com.
Розуміння Blueprint
Render Blueprints — це YAML-файли, які визначають вашу інфраструктуру.render.yaml у цьому
репозиторії налаштовує все необхідне для запуску OpenClaw:
| Можливість | Призначення |
|---|---|
runtime: docker | Збирання з Dockerfile цього репозиторію |
healthCheckPath | Render відстежує /health і перезапускає нездорові екземпляри |
generateValue: true | Автоматично генерує криптографічно безпечне значення |
disk | Постійне сховище, яке зберігається після повторних розгортань |
Вибір тарифу
| Тариф | Зупинка | Диск | Найкраще підходить для |
|---|---|---|---|
| Free | Після 15 хв бездіяльності | Недоступний | Тестування, демо |
| Starter | Ніколи | 1GB+ | Особистого використання, малих команд |
| Standard+ | Ніколи | 1GB+ | Production, кількох каналів |
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 з панелі керування.Власний домен
- Перейдіть до Dashboard → ваш сервіс → Settings → Custom Domains
- Додайте свій домен
- Налаштуйте DNS згідно з інструкціями (CNAME на
*.onrender.com) - Render автоматично надасть TLS-сертифікат
Масштабування
Render підтримує горизонтальне та вертикальне масштабування:- Вертикальне: змініть тариф, щоб отримати більше CPU/RAM
- Горизонтальне: збільшіть кількість екземплярів (тариф Standard і вище)
Резервні копії та міграція
Експортуйте свій стан, конфігурацію, профілі автентифікації та workspace у будь-який момент через доступ до shell у Render Dashboard:Усунення несправностей
Сервіс не запускається
Перевірте журнали розгортання в 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
Наступні кроки
- Налаштуйте канали обміну повідомленнями: Канали
- Налаштуйте Gateway: Конфігурація Gateway
- Підтримуйте OpenClaw в актуальному стані: Оновлення