Обзор развертывания 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 выполняется в несколько этапов:
-
Подготовка системы:
-
Очистка существующих репозиториев NodeSource и Docker для предотвращения конфликтов.
-
Установка базовых системных пакетов (
ca-certificates,curl,gnupg,sudo,dbus-user-session). -
Установка среды выполнения:
-
Настройка репозитория NodeSource.
-
Установка Node.js (версия 24).
-
Глобальная установка пакетного менеджера
pnpm. -
Развертывание OpenClaw:
-
Создание пользователя
openclawс включенным режимом "lingering" для обеспечения работы фоновых процессов. -
Установка приложения через
pnpm install -g openclaw@latest. -
Выполнение автоматической инициализации (onboarding) в локальном режиме.
-
Применение патча конфигурации для поддержки HTTPS проксирования.
-
Настройка сетевого шлюза:
-
Создание системного юнита
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.
Инструкция по обновлению приложения¶
Для обновления основного приложения необходимо:
-
Обновить пакет через
pnpm: -
Перезапустить службу шлюза для применения изменений:
Расположение конфигурационных файлов и данных¶
-
Конфигурация приложения:
/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