Podman

• Podman запускает контейнер Gateway.
• Ваш хостовый CLI openclaw является плоскостью управления.
• Постоянное состояние по умолчанию хранится на хосте в ~/.openclaw.
• Повседневное управление использует openclaw --container <name> ... вместо sudo -u openclaw, podman exec или отдельного сервисного пользователя.

​

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

• Podman в rootless-режиме
• OpenClaw CLI, установленный на хосте
• Необязательно: systemd --user, если нужен автозапуск под управлением Quadlet
• Необязательно: sudo, только если вам нужен loginctl enable-linger "$(whoami)" для сохранения запуска после перезагрузки на headless-хосте

​

Быстрый старт

• ./scripts/podman/setup.sh по умолчанию собирает openclaw:local в вашем rootless-хранилище Podman или использует OPENCLAW_IMAGE / OPENCLAW_PODMAN_IMAGE, если вы задали одну из этих переменных.
• Он создает ~/.openclaw/openclaw.json с gateway.mode: "local", если файл отсутствует.
• Он создает ~/.openclaw/.env с OPENCLAW_GATEWAY_TOKEN, если файл отсутствует.
• Для ручных запусков вспомогательный скрипт читает из ~/.openclaw/.env только небольшой allowlist ключей, связанных с Podman, и передает контейнеру явные переменные окружения runtime; он не передает Podman весь env-файл.

./scripts/podman/setup.sh --quadlet

• OPENCLAW_IMAGE или OPENCLAW_PODMAN_IMAGE — использовать существующий/загруженный образ вместо сборки openclaw:local
• OPENCLAW_IMAGE_APT_PACKAGES — установить дополнительные apt-пакеты во время сборки образа (также принимает legacy OPENCLAW_DOCKER_APT_PACKAGES)
• OPENCLAW_IMAGE_PIP_PACKAGES — установить дополнительные Python-пакеты во время сборки образа; фиксируйте версии и используйте только те индексы пакетов, которым доверяете
• OPENCLAW_EXTENSIONS — предварительно установить зависимости plugins во время сборки
• OPENCLAW_INSTALL_BROWSER — предварительно установить Chromium и Xvfb для автоматизации браузера (задайте 1, чтобы включить)

./scripts/run-openclaw-podman.sh launch

./scripts/run-openclaw-podman.sh launch setup

• Используйте аутентификацию под управлением OpenClaw во время настройки: API-ключи Anthropic для Anthropic или браузерную OAuth/device-code-аутентификацию OpenAI Codex для OpenAI на базе Codex.
• Лаунчер Podman не монтирует хостовые домашние каталоги учетных данных CLI, такие как ~/.claude или ~/.codex, в контейнер настройки или Gateway.
• Существующие хостовые CLI-логины являются удобными путями на том же хосте. Для контейнерных установок храните аутентификацию провайдера в смонтированном состоянии ~/.openclaw, которым управляет настройка.

export OPENCLAW_CONTAINER=openclaw

openclaw dashboard --no-open
openclaw gateway status --deep   # включает дополнительное сканирование сервиса
openclaw doctor
openclaw channels login

​

Podman и Tailscale

• Оставляйте хост публикации Podman равным 127.0.0.1.
• Предпочитайте управляемый хостом tailscale serve вместо openclaw gateway --tailscale serve.
• На macOS, если локальный контекст device-auth в браузере ненадежен, используйте доступ через Tailscale вместо специальных обходных решений с локальными туннелями.

• Tailscale
• Control UI

​

Systemd (Quadlet, необязательно)

~/.config/containers/systemd/openclaw.container

• Запуск: systemctl --user start openclaw.service
• Остановка: systemctl --user stop openclaw.service
• Статус: systemctl --user status openclaw.service
• Логи: journalctl --user -u openclaw.service -f

systemctl --user daemon-reload
systemctl --user restart openclaw.service

sudo loginctl enable-linger "$(whoami)"

​

Конфигурация, env и хранилище

• Каталог конфигурации: ~/.openclaw
• Каталог рабочей области: ~/.openclaw/workspace
• Файл токена: ~/.openclaw/.env
• Вспомогательный скрипт запуска: ./scripts/run-openclaw-podman.sh

• OPENCLAW_CONFIG_DIR -> /home/node/.openclaw
• OPENCLAW_WORKSPACE_DIR -> /home/node/.openclaw/workspace

• OPENCLAW_PODMAN_CONTAINER — имя контейнера (по умолчанию openclaw)
• OPENCLAW_PODMAN_IMAGE / OPENCLAW_IMAGE — образ для запуска
• OPENCLAW_PODMAN_GATEWAY_HOST_PORT — порт хоста, сопоставленный с контейнерным 18789
• OPENCLAW_PODMAN_BRIDGE_HOST_PORT — порт хоста, сопоставленный с контейнерным 18790
• OPENCLAW_PODMAN_PUBLISH_HOST — интерфейс хоста для опубликованных портов; по умолчанию 127.0.0.1
• OPENCLAW_GATEWAY_BIND — режим bind Gateway внутри контейнера; по умолчанию lan
• OPENCLAW_PODMAN_USERNS — keep-id (по умолчанию), auto или host

• Сгенерированная служба Quadlet намеренно сохраняет фиксированную усиленную форму по умолчанию: опубликованные порты 127.0.0.1, --bind lan внутри контейнера и пользовательское пространство имен keep-id.
• Она фиксирует OPENCLAW_NO_RESPAWN=1, Restart=on-failure и TimeoutStartSec=300.
• Она публикует как 127.0.0.1:18789:18789 (Gateway), так и 127.0.0.1:18790:18790 (bridge).
• Она читает ~/.openclaw/.env как runtime EnvironmentFile для значений вроде OPENCLAW_GATEWAY_TOKEN, но не использует allowlist переопределений, специфичных для Podman, из ручного лаунчера.
• Если вам нужны пользовательские порты публикации, хост публикации или другие флаги запуска контейнера, используйте ручной лаунчер или напрямую отредактируйте ~/.config/containers/systemd/openclaw.container, затем перезагрузите и перезапустите службу.

​

Полезные команды

• Логи контейнера: podman logs -f openclaw
• Остановить контейнер: podman stop openclaw
• Удалить контейнер: podman rm -f openclaw
• Открыть URL dashboard из хостового CLI: openclaw dashboard --no-open
• Health/status через хостовый CLI: openclaw gateway status --deep (RPC-зонд + дополнительное сканирование сервиса)

​

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

• Permission denied (EACCES) для конфигурации или рабочей области: По умолчанию контейнер запускается с --userns=keep-id и --user <your uid>:<your gid>. Убедитесь, что хостовые пути конфигурации/рабочей области принадлежат вашему текущему пользователю.
• Запуск Gateway заблокирован (отсутствует gateway.mode=local): Убедитесь, что ~/.openclaw/openclaw.json существует и задает gateway.mode="local". scripts/podman/setup.sh создает его, если он отсутствует.
• Команды CLI контейнера попадают не в ту цель: Используйте openclaw --container <name> ... явно или экспортируйте OPENCLAW_CONTAINER=<name> в своем shell.
• openclaw update завершается ошибкой с --container: Это ожидаемо. Пересоберите/загрузите образ, затем перезапустите контейнер или службу Quadlet.
• Служба Quadlet не запускается: Выполните systemctl --user daemon-reload, затем systemctl --user start openclaw.service. На headless-системах также может понадобиться sudo loginctl enable-linger "$(whoami)".
• SELinux блокирует bind mounts: Не меняйте поведение монтирования по умолчанию; лаунчер автоматически добавляет :Z в Linux, когда SELinux работает в enforcing- или permissive-режиме.

​

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

• Docker
• Фоновый процесс Gateway
• Устранение неполадок Gateway