Podman

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

​

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

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

​

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

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

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

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

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, если контекст аутентификации устройства в локальном браузере работает ненадёжно, используйте доступ через Tailscale вместо нестандартных обходных решений с локальными туннелями.

​

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

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

sudo loginctl enable-linger "$(whoami)"

​

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

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

​

Обновление образов

OPENCLAW_CONFIG_DIR="${OPENCLAW_CONFIG_DIR:-$HOME/.openclaw}"
OPENCLAW_WORKSPACE_DIR="${OPENCLAW_WORKSPACE_DIR:-$OPENCLAW_CONFIG_DIR/workspace}"
OPENCLAW_PODMAN_IMAGE="${OPENCLAW_PODMAN_IMAGE:-${OPENCLAW_IMAGE:-openclaw:local}}"

podman run --rm -it \
  --userns=keep-id \
  --user "$(id -u):$(id -g)" \
  -e HOME=/home/node \
  -e NPM_CONFIG_CACHE=/home/node/.openclaw/.npm \
  -v "$OPENCLAW_CONFIG_DIR:/home/node/.openclaw:rw" \
  -v "$OPENCLAW_WORKSPACE_DIR:/home/node/.openclaw/workspace:rw" \
  "$OPENCLAW_PODMAN_IMAGE" \
  openclaw doctor --fix

​

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

• Журналы контейнера: podman logs -f openclaw
• Остановка контейнера: podman stop openclaw
• Удаление контейнера: podman rm -f openclaw
• Открытие URL панели управления через CLI хоста: openclaw dashboard --no-open
• Проверка работоспособности и состояния через CLI хоста: openclaw gateway status --deep (RPC-проверка и дополнительное сканирование служб)

​

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

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

​

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

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