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

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

Процесс развертывания требует операционной системы, совместимой с Ubuntu, для выполнения скриптов установки и управления системными пакетами. Перед началом установки должны быть выполнены следующие условия:

Сервер должен работать под управлением Ubuntu.
Для установки системных пакетов, клонирования репозиториев и изменения конфигураций пользователей требуются права root или sudo.
Система должна иметь доступ к сети для клонирования репозитория OpenClaw с GitHub.
Пакеты ansible и git должны быть установлены или доступны для установки через apt.

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

Приложение OpenClaw развертывается путем клонирования конкретного репозитория и выполнения автоматизированного скрипта установки. Этот процесс обеспечивает подготовку окружения, удовлетворение зависимостей и установку приложения из ветки main.

Рабочий процесс установки включает следующие шаги:

Установить системные пакеты, включая ansible и git.
Удалить любой существующий репозиторий OpenClaw в /opt/openclaw-ansible для обеспечения чистого состояния.
Склонировать репозиторий OpenClaw с https://github.com/openclaw/openclaw-ansible.git в /opt/openclaw-ansible, используя ветку main.
Установить необходимые коллекции Ansible с помощью ansible-galaxy.
Выполнить скрипт установки ./run-playbook.sh, находящийся в директории установки.
Скрипт установки запускается со следующими переменными окружения для управления памятью и ведением логов:
NODE_OPTIONS: --max-old-space-size=768
npm_config_jobs: 2
npm_config_loglevel: warn
CI: true

Настройка разрешений и прав доступа¶

Развертывание создает специального системного пользователя для управления приложением и обеспечивает надлежащее владение директориями.

Создается системный пользователь с именем openclaw со следующими атрибутами:
Домашняя директория: /home/openclaw
Shell: /bin/bash
Группы: sudo
Пароль: Установлен в виде хешированного значения, соответствующего слову openclaw
Владельцем директории /home/openclaw и всего ее содержимого рекурсивно назначается пользователь и группа openclaw.
Скрипту установки ./run-playbook.sh предоставляются права на выполнение для пользователя.

Во время установки система обеспечивает отсутствие загрузки инструментов управления пакетами, временно останавливая автоматические обновления, ожидая освобождения блокировок, а затем повторно активируя их по завершении.

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

Приложение и его компоненты установки организованы в определенных локациях на сервере:

Компонент	Путь	Описание
Директория установки	`/opt/openclaw-ansible`	Содержит склонированный репозиторий и скрипты установки
Скрипт запуска	`/opt/openclaw-ansible/run-playbook.sh`	Исполняемый скрипт для развертывания приложения
Домашняя директория пользователя	`/home/openclaw`	Домашняя директория для системного пользователя `openclaw`

Запуск, остановка и обновление¶

Развертывание опирается на скрипт run-playbook.sh в директории /opt/openclaw-ansible для управления жизненным циклом приложения.

Для выполнения установки или повторного развертывания приложения выполните скрипт с повышенными привилегиями:
```
cd /opt/openclaw-ansible
sudo ./run-playbook.sh
```
Скрипт обрабатывает установку зависимостей и конфигурацию окружения OpenClaw.
Обновления приложения могут быть выполнены путем получения последних изменений из ветки main внутри директории /opt/openclaw-ansible и повторного запуска скрипта, так как скрипт включает логику обновления репозитория и коллекций.