Ansible

Розгорніть OpenClaw на робочих серверах за допомогою openclaw-ansible — автоматизованого інсталятора з архітектурою, орієнтованою насамперед на безпеку.

Репозиторій openclaw-ansible є основним джерелом достовірної інформації про розгортання за допомогою Ansible. На цій сторінці наведено стислий огляд.

Передумови

Вимога	Відомості
ОС	Debian 11+ або Ubuntu 20.04+
Доступ	Права root або sudo
Мережа	Підключення до Інтернету для встановлення пакетів
Ansible	2.14+ (автоматично встановлюється сценарієм швидкого старту)

Що ви отримуєте

Безпека насамперед на рівні брандмауера: ізоляція UFW + Docker (доступні лише SSH + Tailscale)
VPN Tailscale для віддаленого доступу без публічного відкриття служб
Docker для ізольованих контейнерів пісочниці з прив’язками лише до localhost
Інтеграція із systemd із посиленим захистом і автоматичним запуском під час завантаження
Налаштування однією командою

Швидкий старт

curl -fsSL https://raw.githubusercontent.com/openclaw/openclaw-ansible/main/install.sh | bash

Що встановлюється

Tailscale (коміркова VPN для безпечного віддаленого доступу)
Брандмауер UFW (лише порти SSH + Tailscale)
Docker CE + Compose V2 (стандартний серверний компонент пісочниці агента)
Node.js і pnpm (для OpenClaw потрібен Node 22.22.3+, 24.15+ або 25.9+; рекомендовано Node 24)
OpenClaw, установлений безпосередньо на хості, а не в контейнері
Служба systemd із посиленим захистом

Gateway працює безпосередньо на хості, а не в Docker. Використання пісочниці для агентів необов’язкове; цей плейбук установлює Docker, оскільки він є стандартним серверним компонентом пісочниці. Інші серверні компоненти див. у розділі Пісочниця.

Налаштування після встановлення

Перейдіть до користувача openclaw

sudo -i -u openclaw

Запустіть майстер початкового налаштування

Сценарій після встановлення проведе вас через налаштування OpenClaw.

Підключіть канали обміну повідомленнями

Увійдіть у WhatsApp, Telegram, Discord або Signal:

openclaw channels login --channel <name>

Перевірте встановлення

sudo systemctl status openclaw
sudo journalctl -u openclaw -f

Підключіться до Tailscale

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

Швидкі команди

# Перевірити стан служби
sudo systemctl status openclaw

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

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

# Увійти в канал (виконувати від імені користувача openclaw)
sudo -i -u openclaw
openclaw channels login --channel <name>

Архітектура безпеки

Чотирирівнева модель захисту:

Брандмауер (UFW): публічно відкриті лише SSH (22) і Tailscale (41641/udp)
VPN (Tailscale): Gateway доступний лише через коміркову VPN
Ізоляція Docker: ланцюжок iptables DOCKER-USER запобігає зовнішньому відкриттю портів
Посилення захисту systemd: NoNewPrivileges, PrivateTmp, непривілейований користувач

Перевірте свою зовнішню поверхню атаки:

nmap -p- YOUR_SERVER_IP

Відкритим має бути лише порт 22 (SSH). Gateway і Docker залишаються захищеними від зовнішнього доступу. Docker установлюється для пісочниць агентів (ізольованого виконання інструментів), а не для запуску Gateway. Налаштування пісочниці див. у розділі Багатоагентна пісочниця та інструменти.

Встановлення вручну

Установіть передумови

sudo apt update && sudo apt install -y ansible git

Клонуйте репозиторій

git clone https://github.com/openclaw/openclaw-ansible.git
cd openclaw-ansible

Установіть колекції Ansible

ansible-galaxy collection install -r requirements.yml

Запустіть плейбук

./run-playbook.sh

Або запустіть плейбук безпосередньо, а потім вручну запустіть сценарій налаштування:

ansible-playbook playbook.yml --ask-become-pass
# Потім виконайте: /tmp/openclaw-setup.sh

Оновлення

Інсталятор Ansible налаштовує OpenClaw для оновлення вручну; стандартний процес описано в розділі Оновлення. Щоб повторно запустити плейбук (наприклад, після змін конфігурації):

cd openclaw-ansible
./run-playbook.sh

Ця операція ідемпотентна, тому її можна безпечно виконувати багаторазово.

Усунення несправностей

Брандмауер блокує моє підключення

Спочатку підключіться через VPN Tailscale; за задумом Gateway доступний лише в такий спосіб.
SSH (порт 22) дозволений завжди.

Служба не запускається

# Перевірити журнали
sudo journalctl -u openclaw -n 100

# Перевірити дозволи
sudo ls -la /opt/openclaw

# Перевірити запуск вручну
sudo -i -u openclaw
cd ~/openclaw
openclaw gateway run

Проблеми з пісочницею Docker

# Перевірити, чи працює 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

Не вдається ввійти в канал

Переконайтеся, що команда виконується від імені користувача openclaw:

sudo -i -u openclaw
openclaw channels login --channel <name>

Розширена конфігурація

Докладний опис архітектури безпеки та усунення несправностей див. у репозиторії openclaw-ansible:

Пов’язані матеріали

openclaw-ansible: повний посібник із розгортання
Docker: налаштування контейнеризованого Gateway
Пісочниця: конфігурація пісочниці агента
Багатоагентна пісочниця та інструменти: ізоляція для кожного агента

Install overview

Maintenance

Containers

Hosting

Advanced setup

Передумови

Що ви отримуєте

Швидкий старт

Що встановлюється

Налаштування після встановлення

Швидкі команди

Архітектура безпеки

Встановлення вручну

Оновлення

Усунення несправностей

Розширена конфігурація

Пов’язані матеріали

​Передумови

​Що ви отримуєте

​Швидкий старт

​Що встановлюється

​Налаштування після встановлення

​Швидкі команди

​Архітектура безпеки

​Встановлення вручну

​Оновлення

​Усунення несправностей

​Розширена конфігурація

​Пов’язані матеріали

Передумови

Що ви отримуєте

Швидкий старт

Що встановлюється

Налаштування після встановлення

Швидкі команди

Архітектура безпеки

Встановлення вручну

Оновлення

Усунення несправностей

Розширена конфігурація

Пов’язані матеріали