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

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

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

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

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

• Порты:

• 80/tcp: HTTP (для перенаправления на HTTPS и проверки Certbot).

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

• 18789/tcp: Локальный порт шлюза OpenClaw.

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

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

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

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

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

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

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

• /root/nginx — рабочая директория Docker Compose для Nginx.

• /etc/systemd/system/openclaw-gateway.service — системная служба шлюза.

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

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

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

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

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

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

5. Добавление официального репозитория NodeSource.

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

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

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

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

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

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

12. Настройка проксирования:

13. Настройка Nginx для работы в качестве обратного прокси с поддержкой SSL.

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

• Для обеспечения безопасности используется отдельный пользователь openclaw с ограниченными правами.

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

• Настройка sudo secure_path включает пути к бинарным файлам pnpm для корректной работы команд от имени суперпользователя.

• Включено автоматическое обновление безопасности через unattended-upgrades.

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

Для обеспечения работы SSL-сертификатов используется контейнерный метод развертывания прокси-сервера:

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

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

• Инициализация приложения: Команда openclaw onboard используется для автоматической настройки параметров шлюза (порт, привязка к интерфейсу, токен).

• Патчинг конфигурации: Приложение модифицируется с помощью команды openclaw config patch для поддержки работы через HTTPS обратный прокси. Это включает настройку publicOrigin, allowedOrigins и доверенных прокси (127.0.0.1).

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

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

1. Обновить пакеты через системный менеджер пакетов (если используется версия из репозитория).

2. При использовании глобальной установки через pnpm, обновите версию командой:

   pnpm install -g openclaw@latest
   

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

• Конфигурация шлюза: /home/openclaw/.openclaw

• Настройки прокси (Nginx): /data/nginx/user_conf.d/{domain}.conf

• Файл патча HTTPS: /home/openclaw/.openclaw/https-proxy.patch.json5

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

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

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

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

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

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

• Перезагрузка: systemctl restart openclaw-gateway

• Проверка статуса: systemctl status openclaw-gateway