Развёртывание на Render | Docs

Разверните OpenClaw на Render, используя подход «инфраструктура как код». Включённый файл render.yaml (Blueprint) декларативно описывает весь стек — сервис, диск, переменные окружения — так что вы можете развернуть всё одним кликом и хранить конфигурацию инфраструктуры рядом с кодом.

Предварительные требования

Аккаунт на Render (есть бесплатный тариф)
API-ключ от выбранного провайдера моделей

Развёртывание через Render Blueprint

Deploy to Render

При нажатии на эту ссылку произойдёт следующее:

Render создаст новый сервис на основе Blueprint-файла render.yaml из корня репозитория.
Вам будет предложено задать SETUP_PASSWORD.
Docker-образ соберётся и развернётся автоматически.

После развёртывания URL вашего сервиса будет иметь вид https://<service-name>.onrender.com.

Что внутри Blueprint

Render Blueprint — это YAML-файл, описывающий вашу инфраструктуру. Файл render.yaml в этом репозитории содержит всё необходимое для запуска OpenClaw:

services:
  - type: web
    name: openclaw
    runtime: docker
    plan: starter
    healthCheckPath: /health
    envVars:
      - key: PORT
        value: "8080"
      - key: SETUP_PASSWORD
        sync: false # prompts during deploy
      - 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` и перезапускает нездоровые инстансы
`sync: false`	Запрашивает значение при развёртывании (для секретов)
`generateValue: true`	Автоматически генерирует криптографически стойкое значение
`disk`	Постоянное хранилище, которое сохраняется между переразвёртываниями

Выбор тарифного плана

План	Отключение при простое	Диск	Для кого
Free	Через 15 мин простоя	Недоступен	Тестирование, демонстрации
Starter	Никогда	1 ГБ и более	Личное использование, небольшие команды
Standard+	Никогда	1 ГБ и более	Продакшен, несколько каналов

По умолчанию Blueprint использует план starter. Чтобы перейти на бесплатный тариф, измените plan: free в файле render.yaml вашего форка (но учтите: без постоянного диска конфигурация сбрасывается при каждом развёртывании).

После развёртывания

Пройдите мастер настройки

Откройте https://<your-service>.onrender.com/setup
Введите ваш SETUP_PASSWORD
Выберите провайдера моделей и вставьте API-ключ
По желанию подключите каналы обмена сообщениями (Telegram, Discord, Slack)
Нажмите Run setup

Панель управления

Веб-панель доступна по адресу https://<your-service>.onrender.com/openclaw.

Возможности панели Render

Логи

Просматривайте логи в реальном времени в разделе Dashboard → ваш сервис → Logs. Доступна фильтрация:

Логи сборки (создание Docker-образа)
Логи развёртывания (запуск сервиса)
Логи работы (вывод приложения)

Доступ к консоли

Для отладки откройте сессию командной строки через Dashboard → ваш сервис → Shell. Постоянный диск смонтирован в /data.

Переменные окружения

Изменяйте переменные в разделе Dashboard → ваш сервис → Environment. Любое изменение автоматически запускает переразвёртывание.

Автоматическое развёртывание

Если вы используете оригинальный репозиторий OpenClaw, Render не будет автоматически обновлять ваш инстанс. Чтобы обновиться, запустите ручную синхронизацию Blueprint через панель управления.

Собственный домен

Перейдите в Dashboard → ваш сервис → Settings → Custom Domains
Добавьте ваш домен
Настройте DNS по инструкции (CNAME на *.onrender.com)
Render автоматически выпустит TLS-сертификат

Масштабирование

Render поддерживает горизонтальное и вертикальное масштабирование:

Вертикальное: смените тарифный план для увеличения CPU/RAM
Горизонтальное: увеличьте количество инстансов (план Standard и выше)

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

Резервное копирование и миграция

Экспортируйте конфигурацию и рабочее пространство в любой момент:

https://<your-service>.onrender.com/setup/export

Вы получите портативную резервную копию, которую можно восстановить на любом хосте с OpenClaw.

Устранение неполадок

Сервис не запускается

Проверьте логи развёртывания в панели Render. Частые проблемы:

Не задан SETUP_PASSWORD — Blueprint запрашивает его при развёртывании, но убедитесь, что значение установлено
Несовпадение портов — убедитесь, что PORT=8080 совпадает с портом, указанным в Dockerfile

Долгий холодный старт (бесплатный тариф)

Сервисы на бесплатном тарифе отключаются через 15 минут простоя. Первый запрос после отключения занимает несколько секунд, пока контейнер запускается. Перейдите на план Starter, чтобы сервис работал постоянно.

Потеря данных после переразвёртывания

Это происходит на бесплатном тарифе (нет постоянного диска). Перейдите на платный план или регулярно экспортируйте конфигурацию через /setup/export.

Ошибки проверки состояния (health check)

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

Логи сборки на наличие ошибок
Запускается ли контейнер локально с помощью docker build && docker run