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

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

Развертывание с помощью Render Blueprint

Deploy to Render

Нажав на эту ссылку, вы:

  1. Создадите новый сервис Render из render.yaml Blueprint в корне этого репозитория.
  2. Вам будет предложено установить SETUP_PASSWORD
  3. Будет собран Docker-образ и выполнено развертывание

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

Понимание Blueprint

Render Blueprints — это 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          # запрос во время развертывания
      - key: OPENCLAW_STATE_DIR
        value: /data/.openclaw
      - key: OPENCLAW_WORKSPACE_DIR
        value: /data/workspace
      - key: OPENCLAW_GATEWAY_TOKEN
        generateValue: true  # автогенерация безопасного токена
    disk:
      name: openclaw-data
      mountPath: /data
      sizeGB: 1

Используемые ключевые функции Blueprint:

ФункцияНазначение
runtime: dockerСборка из Dockerfile репозитория
healthCheckPathRender мониторит /health и перезапускает нездоровые экземпляры
sync: falseЗапрос значения во время развертывания (секреты)
generateValue: trueАвтогенерация криптографически безопасного значения
diskПостоянное хранилище, сохраняющееся при повторных развертываниях

Выбор плана

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

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

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

Завершите работу мастера настройки

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

Доступ к Control UI

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

Функции панели Render

Логи

Просматривайте логи в реальном времени в Dashboard → ваш сервис → Logs. Фильтр по:

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

Доступ к 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 обычно достаточно вертикального масштабирования. Горизонтальное масштабирование требует липких сессий или внешнего управления состоянием.

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

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

https://<ваш-сервис>.onrender.com/setup/export

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

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

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

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

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

Медленный холодный старт (бесплатный уровень)

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

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

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

Сбои проверки работоспособности

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

  • Логи сборки на наличие ошибок
  • Работает ли контейнер локально с помощью docker build && docker run
← Назад к документации