Перейти к основному содержимому

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

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

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

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

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

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

  1. Создаст новый сервис Render из Blueprint render.yaml в корне этого репозитория.
  2. Запросит установку SETUP_PASSWORD
  3. Соберет 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 репозитория
healthCheckPathRender отслеживает /health и перезапускает нерабочие экземпляры
sync: falseЗапрашивает значение во время развертывания (секреты)
generateValue: trueАвтоматически генерирует криптографически безопасное значение
diskПостоянное хранилище, сохраняющееся при повторных развертываниях

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

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

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

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

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

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

Доступ к веб-интерфейсу управления​

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

Возможности панели управления Render​

Логи​

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

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

Доступ к оболочке (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/ОЗУ
  • Горизонтальное: Увеличьте количество экземпляров (тариф 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