> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Ansible

Разверните OpenClaw на рабочих серверах с помощью **[openclaw-ansible](https://github.com/openclaw/openclaw-ansible)** — автоматизированного установщика с архитектурой, ориентированной прежде всего на безопасность.

> [!NOTE]
>
> Репозиторий [openclaw-ansible](https://github.com/openclaw/openclaw-ansible) является основным источником сведений о развертывании с помощью Ansible. На этой странице представлен краткий обзор.

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

| Требование | Подробности |
| - | - |
| ОС | Debian 11+ или Ubuntu 20.04+ |
| Доступ | Права root или sudo |
| Сеть | Подключение к интернету для установки пакетов |
| Ansible | 2.14+ (автоматически устанавливается скриптом быстрого запуска) |

## Что вы получите

* Безопасность на уровне межсетевого экрана: UFW + изоляция Docker (доступны только SSH + Tailscale)
* VPN Tailscale для удаленного доступа без публичного предоставления сервисов
* Docker для изолированных контейнеров песочницы с привязкой только к localhost
* Интеграция с systemd с усилением безопасности и автоматическим запуском при загрузке
* Настройка одной командой

## Быстрый запуск

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
curl -fsSL https://raw.githubusercontent.com/openclaw/openclaw-ansible/main/install.sh | bash
```

## Что устанавливается

1. Tailscale (ячеистая VPN для безопасного удаленного доступа)
2. Межсетевой экран UFW (только порты SSH + Tailscale)
3. Docker CE + Compose V2 (сервер песочницы агентов по умолчанию)
4. Node.js и pnpm (для OpenClaw требуется Node 22.22.3+, 24.15+ или 25.9+; рекомендуется Node 24)
5. OpenClaw, установленный непосредственно на хосте, а не в контейнере
6. Сервис systemd с усиленной безопасностью

> [!NOTE]
>
> Gateway работает непосредственно на хосте, а не в Docker. Песочница агентов
> необязательна; этот плейбук устанавливает Docker, поскольку он является сервером
> песочницы по умолчанию. Другие серверы см. в разделе [Песочница](https://docs2.openclaw.ai/ru/gateway/sandboxing.md).

## Настройка после установки

**1. Переключитесь на пользователя openclaw**

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
sudo -i -u openclaw
```

**2. Запустите мастер первоначальной настройки**

Скрипт после установки поможет вам настроить OpenClaw.

**3. Подключите каналы обмена сообщениями**

Войдите в WhatsApp, Telegram, Discord или Signal:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw channels login --channel <name>
```

**4. Проверьте установку**

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
sudo systemctl status openclaw
sudo journalctl -u openclaw -f
```

**5. Подключитесь к Tailscale**

Присоединитесь к своей ячеистой VPN для безопасного удаленного доступа.

### Основные команды

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
# Проверить состояние сервиса
sudo systemctl status openclaw

# Просмотреть журналы в реальном времени
sudo journalctl -u openclaw -f

# Перезапустить Gateway
sudo systemctl restart openclaw

# Вход в канал (выполняется от имени пользователя openclaw)
sudo -i -u openclaw
openclaw channels login --channel <name>
```

## Архитектура безопасности

Четырехуровневая модель защиты:

1. Межсетевой экран (UFW): публично доступны только SSH (22) и Tailscale (41641/udp)
2. VPN (Tailscale): Gateway доступен только через ячеистую VPN
3. Изоляция Docker: цепочка iptables `DOCKER-USER` предотвращает доступ к портам извне
4. Усиление безопасности systemd: `NoNewPrivileges`, `PrivateTmp`, непривилегированный пользователь

Проверьте доступную извне поверхность атаки:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
nmap -p- YOUR_SERVER_IP
```

Открытым должен быть только порт 22 (SSH). Gateway и Docker остаются защищенными от внешнего доступа.

Docker устанавливается для песочниц агентов (изолированного выполнения инструментов), а не для запуска Gateway. Настройку песочницы см. в разделе [Многоагентная песочница и инструменты](https://docs2.openclaw.ai/ru/tools/multi-agent-sandbox-tools.md).

## Установка вручную

**1. Установите необходимые компоненты**

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
sudo apt update && sudo apt install -y ansible git
```

**2. Клонируйте репозиторий**

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
git clone https://github.com/openclaw/openclaw-ansible.git
cd openclaw-ansible
```

**3. Установите коллекции Ansible**

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
ansible-galaxy collection install -r requirements.yml
```

**4. Запустите плейбук**

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
./run-playbook.sh
```

Либо запустите плейбук напрямую, а затем вручную выполните скрипт настройки:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
ansible-playbook playbook.yml --ask-become-pass
# Затем выполните: /tmp/openclaw-setup.sh
```

## Обновление

Установщик Ansible настраивает OpenClaw для обновления вручную; стандартный порядок действий см. в разделе [Обновление](https://docs2.openclaw.ai/ru/install/updating.md).

Чтобы повторно запустить плейбук (например, после изменения конфигурации):

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
cd openclaw-ansible
./run-playbook.sh
```

Операция идемпотентна, поэтому ее можно безопасно выполнять несколько раз.

## Устранение неполадок

> [accordion] Межсетевой экран блокирует подключение
>
> * Сначала подключитесь через VPN Tailscale; по замыслу Gateway доступен только таким способом.
> * SSH (порт 22) разрешен всегда.

> [accordion] Сервис не запускается
>
> ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
> # Проверить журналы
> sudo journalctl -u openclaw -n 100
>
> # Проверить права доступа
> sudo ls -la /opt/openclaw
>
> # Проверить запуск вручную
> sudo -i -u openclaw
> cd ~/openclaw
> openclaw gateway run
> ```

> [accordion] Проблемы с песочницей Docker
>
> ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
> # Проверить, работает ли Docker
> sudo systemctl status docker
>
> # Проверить образ песочницы
> sudo docker images | grep openclaw-sandbox
>
> # Собрать отсутствующий образ песочницы (требуется рабочая копия исходного кода)
> cd /opt/openclaw/openclaw
> sudo -u openclaw ./scripts/sandbox-setup.sh
> # Для установки через npm без рабочей копии исходного кода см.
> # https://docs.openclaw.ai/gateway/sandboxing#images-and-setup
> ```

> [accordion] Не удается войти в канал
>
> Убедитесь, что команда выполняется от имени пользователя `openclaw`:
>
> ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
> sudo -i -u openclaw
> openclaw channels login --channel <name>
> ```

## Расширенная конфигурация

Подробное описание архитектуры безопасности и устранения неполадок см. в репозитории openclaw-ansible:

* [Архитектура безопасности](https://github.com/openclaw/openclaw-ansible/blob/main/docs/security.md)
* [Технические подробности](https://github.com/openclaw/openclaw-ansible/blob/main/docs/architecture.md)
* [Руководство по устранению неполадок](https://github.com/openclaw/openclaw-ansible/blob/main/docs/troubleshooting.md)

## Связанные материалы

* [openclaw-ansible](https://github.com/openclaw/openclaw-ansible): полное руководство по развертыванию
* [Docker](https://docs2.openclaw.ai/ru/install/docker.md): настройка контейнеризованного Gateway
* [Песочница](https://docs2.openclaw.ai/ru/gateway/sandboxing.md): настройка песочницы агентов
* [Многоагентная песочница и инструменты](https://docs2.openclaw.ai/ru/tools/multi-agent-sandbox-tools.md): изоляция каждого агента