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

Обзор развертывания OpenClaw на сервере

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

Для корректной работы приложения требуются следующие параметры системы:

  • Операционная система: Debian 11+ или Ubuntu 20.04+.

  • Пользователь: В системе создается выделенный пользователь openclaw с домашним каталогом /home/openclaw.

  • Порты:

  • 80 (HTTP) — для проверки сертификатов и перенаправления на HTTPS.

  • 443 (HTTPS) — основной порт доступа к панели управления.

  • 18789 (TCP) — внутренний порт шлюза OpenClaw (Gateway).

FQDN итоговой панели на домене hostkey.in

Доступ к интерфейсу осуществляется через поддомен, сформированный по следующему шаблону:

Параметр Значение
Префикс openclaw
Домен hostkey.in
Полный шаблон openclaw{Server_ID_from_Invapi}.hostkey.in

Структура файлов и каталогов

Основные директории, используемые в системе:

  • /home/openclaw/.openclaw — конфигурационные файлы приложения.

  • /data/nginx — конфигурации прокси-сервера Nginx.

  • /data/nginx/user_conf.d — пользовательские настройки виртуальных хостов.

  • /root/nginx — рабочая директория Docker-контейнера Nginx.

Процесс установки приложения

Развертывание OpenClaw выполняется в несколько этапов:

  1. Подготовка системы:

  2. Очистка существующих репозиториев NodeSource и Docker для предотвращения конфликтов.

  3. Установка базовых системных пакетов (ca-certificates, curl, gnupg, sudo, dbus-user-session).

  4. Установка среды выполнения:

  5. Настройка репозитория NodeSource.

  6. Установка Node.js (версия 24).

  7. Глобальная установка пакетного менеджера pnpm.

  8. Развертывание OpenClaw:

  9. Создание пользователя openclaw с включенным режимом "lingering" для обеспечения работы фоновых процессов.

  10. Установка приложения через pnpm install -g openclaw@latest.

  11. Выполнение автоматической инициализации (onboarding) в локальном режиме.

  12. Применение патча конфигурации для поддержки HTTPS проксирования.

  13. Настройка сетевого шлюза:

  14. Создание системного юнита openclaw-gateway.service для управления процессом через systemd.

Права доступа и безопасность

  • Пользователь приложения: Все процессы OpenClaw работают от имени пользователя openclaw.

  • Ограничения прав: Конфигурационные файлы в директории .openclaw имеют права 0600 или 0700, доступные только владельцу.

  • Брандмауэр (UFW): Автоматически открываются порты 80/tcp и 443/tcp.

  • Безопасность шлюза: Для предотвращения конфликтов при перезапуске, перед стартом сервиса выполняется очистка порта с помощью fuser.

Базы данных

Приложение использует локальный режим работы. Данные хранятся в директориях пользователя openclaw внутри его домашнего каталога.

Контейнеры Docker и их запуск

Для обеспечения работы HTTPS используется контейнер Nginx с интегрированным Certbot.

Параметр Значение
Образ jonasal/nginx-certbot:6.2.0-nginx1.31.0
Режим сети host
Тома (volumes) /etc/letsencrypt, /data/nginx/user_conf.d
Переменные окружения CERTBOT_EMAIL
Политика перезапуска unless-stopped

Кастомные скрипты и дополнительные настройки

В процессе установки выполняются следующие действия:

  • Настройка PATH: В профиль пользователя openclaw добавляются пути к бинарным файлам pnpm. Также обновляется secure_path в /etc/sudoers.d/openclaw-path для корректной работы через sudo.

  • HTTPS Patching: Применяется JSON5-патч (https-proxy.patch.json5) к конфигурации шлюза, чтобы разрешить работу через обратный прокси и настроить доверенные прокси (127.0.0.1).

  • Генерация токена: Для авторизации шлюза генерируется уникальный токен, который сохраняется в /root/openclaw-gateway-token.txt.

Инструкция по обновлению приложения

Для обновления основного приложения необходимо:

  1. Обновить пакет через pnpm:

    pnpm install -g openclaw@latest
    

  2. Перезапустить службу шлюза для применения изменений:

    sudo systemctl restart openclaw-gateway.service
    

Расположение конфигурационных файлов и данных

  • Конфигурация приложения: /home/openclaw/.openclaw

  • Файл окружения шлюза: /home/openclaw/.openclaw/gateway.env

  • Конфигурация Nginx: /data/nginx/user_conf.d/{domain}.conf

Доступные порты для подключения

  • https://{domain} — основной интерфейс управления.

Запуск, остановка приложения

Управление шлюзом осуществляется через systemctl:

  • Запуск: sudo systemctl start openclaw-gateway.service

  • Остановка: sudo systemctl stop openclaw-gateway.service

  • Статус: sudo systemctl status openclaw-gateway.service

question_mark
Я могу вам чем-то помочь?
question_mark
ИИ Помощник ×