Хостинг и развертывание

Развертывание на Render

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

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

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

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

Развернуть на Render Нажатие на эту ссылку:

Создаст новый сервис Render из Blueprint render.yaml в корне этого репозитория.
Запросит установку SETUP_PASSWORD
Соберет 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: 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`	Постоянное хранилище, сохраняющееся при повторных развертываниях

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

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

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

Доступ к оболочке (Shell)

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

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

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

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

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

Пользовательский домен

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

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

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

Вертикальное: Измените тарифный план, чтобы получить больше CPU/ОЗУ
Горизонтальное: Увеличьте количество экземпляров (тариф Standard и выше)

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

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

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

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

Развернуть на Railway Развернуть на Northflank