OpenClaw Docker запускает Gateway через Docker Compose, а состояние сохраняет в подключённых каталогах хоста. Для рабочего развёртывания проверьте опубликованный порт, права пользователя контейнера, состав резервной копии и восстановление в отдельном каталоге. Контейнер удобно заменить образом новой версии лишь тогда, когда конфигурация, рабочая область и данные сессий переживают такую замену.
Роль контейнера
Официальный Docker-гайд OpenClaw описывает запуск Gateway через Compose и хранение состояния за пределами контейнера. Контейнер Gateway и изолированная среда выполнения агента представляют разные режимы.
Gateway принимает подключения, держит конфигурацию и управляет рабочими сессиями. Docker здесь задаёт способ размещения самого сервиса. Отдельный Docker sandbox для инструментов агента включается своей настройкой и по умолчанию выключен. При проектировании прав помните: полномочия агента на работу с файлами и внешними сервисами задаются отдельными правилами. Для такой задачи составьте собственную карту разрешённых действий.
Ближайший материал про Gateway разбирает сетевой доступ и права. Здесь маршрут продолжается с момента выбора контейнера: какие каталоги переживают замену образа, как открыть нужный порт, какой пользователь владеет файлами и как доказать восстановимость копии. Сетевую схему стоит зафиксировать до запуска, поскольку публикация порта меняет поверхность доступа к панели управления.
В официальном руководстве Docker назван дополнительным способом установки. Для выбранного режима нужны Docker Engine либо Docker Desktop и Docker Compose. Скрипт запуска из корня исходного репозитория собирает образ, проводит первоначальную настройку и запускает Gateway. Ключи, токены и другие секреты вводите только в защищённом окружении. Храните их вне учебных материалов и общих журналов.
На этапе планирования отделите проверяемые факты продукта от политики компании. Документация объясняет монтаж каталогов и проверку здоровья. Выбор ответственного за копии, правила хранения архивов и порядок допуска сотрудников задаёт владелец системы. Такой подход даёт точные критерии приёмки без обещания, что сама команда запуска решит операционные вопросы.
Запуск и порт
Начните с выбранного образа и файла Compose из официального проекта. Скрипт ./scripts/docker/setup.sh выполняют из корня репозитория; он создаёт конфигурацию, проводит onboarding и поднимает сервис. Для устойчивого окружения закрепите версию образа и сохраните список использованных переменных рядом с эксплуатационной документацией, исключив значения секретов. После обновления сверяйте состояние и доступность сервиса до подключения рабочих каналов.
- Выберите хост и образ, подготовьте Docker Compose и отдельные каталоги для конфигурации и рабочей области. Зафиксируйте владельца каталогов на хосте.
- Проверьте соответствие опубликованного порта адресу панели. По руководству локальный интерфейс доступен на 127.0.0.1:18789 при стандартной настройке.
- Запустите официальный сценарий настройки, сохраните созданные секреты в закрытом контуре и проверьте ответ Gateway через документированные маршруты здоровья.
- Повторно создайте контейнер с прежними подключёнными каталогами в тестовом окружении. Сверьте настройки, рабочую область и доступность панели.
Значение gateway.bind внутри контейнера и публикация порта на хосте решают разные задачи. Руководство объясняет, что режим lan позволяет браузеру хоста достичь опубликованного порта, а loopback ограничивает доступ сетевым пространством контейнера. Адрес 127.0.0.1 внутри контейнера указывает на сам контейнер. Поэтому настройку соединения с сервисом на хосте проверяют отдельно. За правилами внешнего доступа и управления правами обратитесь к материалу о архитектуре корпоративной нейросети.
Контрольный запрос к /healthz показывает жизнеспособность процесса. По документации /startupz связан с запуском и допуском трафика, а /readyz даёт более глубокий статус с учётом каналов. Успешный ответ одной проверки ещё оставляет открытым вопрос восстановления данных: его проверяют отдельным упражнением. Для публичного хоста пересмотрите правила входящего трафика и защиту панели до подключения пользователей.
Данные и права
В официальной схеме хранения Compose монтирует каталог конфигурации в /home/node/.openclaw, рабочую область в /home/node/.openclaw/workspace и каталог ключа для прежних профилей авторизации отдельно. В конфигурационном каталоге лежат настройки, база состояния и данные авторизации. Документация прямо предупреждает: некоторые токены находятся в базе в открытом виде. Копии этих каталогов требуют такой же защиты, как действующие учётные данные.
Для каждой точки монтирования запишите путь на хосте, назначение внутри контейнера и владельца. По официальному руководству образ работает от пользователя node с идентификатором 1000; несовпадение владельца подключённых каталогов вызывает ошибку доступа. Исправляйте права на конкретном каталоге, сохраняя минимальные полномочия. Запуск всего сервиса с расширенными правами ради обхода ошибки создаёт новую зону риска и затрудняет аудит.
| Объект | Проверка перед запуском | Проверка после замены |
|---|---|---|
| Конфигурация | Каталог подключён и доступен пользователю контейнера | Настройки Gateway сохранились |
| Рабочая область | Путь монтирования указан явно | Файлы доступны ожидаемому процессу |
| Порт | Адрес и публикация согласованы | Панель открывается через утверждённый маршрут |
| Архив | Место хранения и доступ назначены | Архив прошёл проверку и тестовое извлечение |
Секреты исключите из общих логов, снимков экрана и открытых папок резервного копирования. Доступ к архиву ограничьте кругом администраторов, которым разрешено восстановление. При выборе хранилища учитывайте общий объём рабочих файлов и базы. Для оценки рисков агентных инструментов полезен разбор прав, секретов и проверок ИИ-агента; он дополняет задачи контейнерного развёртывания.
Копия и восстановление
Постоянное монтирование сохраняет данные при замене контейнера; для защиты от потери хоста нужен отдельный архив. Официальное руководство по копиям описывает создание полного архива командой openclaw backup create с проверкой. Такой архив охватывает состояние, конфигурацию, учётные данные, каталоги агентов и рабочие области по настройке. Место хранения выбирайте за пределами удаляемого контейнера; доступ к нему ограничьте как доступ к действующим секретам.
Проверка архива подтверждает структуру и содержимое пакета; подлинность источника и готовность сервиса к запуску устанавливают отдельно. Для репетиции восстановления используйте доверенную копию: извлеките её в новый пустой каталог, сопоставьте пути состояния, конфигурации и рабочих областей, затем подготовьте отдельное тестовое окружение. Оригинальный рабочий каталог оставьте доступным до завершения сверки.
Документация предписывает остановить Gateway и другие процессы записи перед активацией восстановленного состояния, вернуть связанные ресурсы из одной копии и выполнить doctor перед повторным запуском. Если образ и данные имеют разные версии, проверьте совместимость схемы базы по актуальным инструкциям. После запуска оцените доступность панели, состояние каналов и целостность нужных рабочих файлов. Факт успешной распаковки без этой сверки даёт лишь частичный результат.
Сценарий восстановления включает решение ответственного человека: какую копию брать, где хранить текущий каталог до переключения и когда возвращать доступ пользователям. Эти решения влияют на настройки хранилища и порядок проверки. Для внедрения ИИ-агента под рабочий процесс их лучше включить в техническое задание вместе с правами и журналом изменений.
Нужна схема хранения и восстановления вашего Gateway?
Приёмка развёртывания
Для пилота предложите отдельное окружение с учебными данными и ограниченными правами. До запуска составьте список критериев приёмки: путь к каждому монтированию, опубликованный адрес, владелец каталога, перечень файлов в копии и признаки успешного восстановления. Затем по очереди перезапустите контейнер, замените образ в тестовой схеме и восстановите архив в новый каталог. Результаты записывайте как наблюдения, без заявления об уже проведённом внедрении.
Хорошая приёмка проверяет разные типы отказов. Если контейнер запустился без рабочей области, ищите ошибку в монтаже. Если панель открылась, но канал показывает сбой, смотрите глубокую проверку готовности и журнал. Если архив распакован, а сервис читает старую базу, сверяйте путь состояния в Compose и настройках запуска. Для каждой проверки заранее назначьте человека, который принимает решение о возврате к предыдущей конфигурации.
Обновление образа планируйте вместе с копией состояния и записью версии. Документация описывает проверку и миграцию состояния при штатной замене образа с сохранёнными подключёнными каталогами. Для отката требуется согласованная пара образа и состояния. Удаление файлов блокировок ради запуска пропускает диагностику причины и создаёт риск для данных. Вместо этого разберите права, состояние файловой системы и результаты doctor.
Стоимость такого проекта зависит от схемы сети, объёма состояния, количества подключений, требований к хранению секретов и сложности проверки восстановления. В смете отдельно покажите подготовку окружения, перенос данных, тестовые отказы и документацию для администратора. Тарифы продукта и инфраструктуры сверяйте по актуальным условиям поставщиков; решение о составе работ принимайте по проверяемой схеме.