Podman

• Podman uruchamia kontener gateway.
• Hostowy openclaw CLI jest płaszczyzną sterowania.
• Stan trwały domyślnie znajduje się na hoście w ~/.openclaw.
• Codzienne zarządzanie używa openclaw --container <name> ... zamiast sudo -u openclaw, podman exec lub osobnego użytkownika usługi.

​

Wymagania wstępne

• Podman w trybie bezrootowym
• OpenClaw CLI zainstalowane na hoście
• Opcjonalnie: systemd --user, jeśli chcesz automatyczne uruchamianie zarządzane przez Quadlet
• Opcjonalnie: sudo tylko wtedy, gdy chcesz użyć loginctl enable-linger "$(whoami)" dla trwałości po uruchomieniu systemu na hoście bez monitora

​

Szybki start

• ./scripts/podman/setup.sh domyślnie buduje openclaw:local w Twoim bezrootowym magazynie Podman albo używa OPENCLAW_IMAGE / OPENCLAW_PODMAN_IMAGE, jeśli je ustawisz.
• Tworzy ~/.openclaw/openclaw.json z gateway.mode: "local", jeśli go brakuje.
• Tworzy ~/.openclaw/.env z OPENCLAW_GATEWAY_TOKEN, jeśli go brakuje.
• Przy ręcznym uruchamianiu helper odczytuje tylko niewielką listę dozwolonych kluczy związanych z Podman z ~/.openclaw/.env i przekazuje jawne zmienne środowiskowe runtime do kontenera; nie przekazuje całego pliku środowiska do Podman.

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

• OPENCLAW_IMAGE lub OPENCLAW_PODMAN_IMAGE — użyj istniejącego/pobranego obrazu zamiast budować openclaw:local
• OPENCLAW_IMAGE_APT_PACKAGES — zainstaluj dodatkowe pakiety apt podczas budowania obrazu (akceptuje też starsze OPENCLAW_DOCKER_APT_PACKAGES)
• OPENCLAW_IMAGE_PIP_PACKAGES — zainstaluj dodatkowe pakiety Python podczas budowania obrazu; przypnij wersje i używaj tylko indeksów pakietów, którym ufasz
• OPENCLAW_EXTENSIONS — wstępnie zainstaluj zależności pluginów w czasie budowania
• OPENCLAW_INSTALL_BROWSER — wstępnie zainstaluj Chromium i Xvfb do automatyzacji przeglądarki (ustaw na 1, aby włączyć)

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

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

• Użyj uwierzytelniania zarządzanego przez OpenClaw podczas konfiguracji: kluczy API Anthropic dla Anthropic albo uwierzytelniania OAuth przeglądarki/kodem urządzenia OpenAI Codex dla OpenAI opartego na Codex.
• Launcher Podman nie montuje katalogów domowych poświadczeń hostowego CLI, takich jak ~/.claude czy ~/.codex, do kontenera konfiguracji ani gateway.
• Istniejące logowania hostowego CLI są ścieżkami wygody na tym samym hoście. W instalacjach kontenerowych trzymaj uwierzytelnianie dostawców w zamontowanym stanie ~/.openclaw, którym zarządza konfiguracja.

export OPENCLAW_CONTAINER=openclaw

openclaw dashboard --no-open
openclaw gateway status --deep   # includes extra service scan
openclaw doctor
openclaw channels login

​

Podman i Tailscale

• Pozostaw host publikacji Podman jako 127.0.0.1.
• Preferuj zarządzane przez hosta tailscale serve zamiast openclaw gateway --tailscale serve.
• W systemie macOS, jeśli lokalny kontekst uwierzytelniania urządzenia w przeglądarce jest zawodny, użyj dostępu Tailscale zamiast doraźnych obejść z lokalnymi tunelami.

• Tailscale
• Control UI

​

Systemd (Quadlet, opcjonalnie)

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

• Start: systemctl --user start openclaw.service
• Stop: systemctl --user stop openclaw.service
• Status: systemctl --user status openclaw.service
• Logi: journalctl --user -u openclaw.service -f

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

sudo loginctl enable-linger "$(whoami)"

​

Konfiguracja, środowisko i przechowywanie

• Katalog konfiguracji: ~/.openclaw
• Katalog workspace: ~/.openclaw/workspace
• Plik tokenu: ~/.openclaw/.env
• Helper uruchamiania: ./scripts/run-openclaw-podman.sh

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

• OPENCLAW_PODMAN_CONTAINER — nazwa kontenera (domyślnie openclaw)
• OPENCLAW_PODMAN_IMAGE / OPENCLAW_IMAGE — obraz do uruchomienia
• OPENCLAW_PODMAN_GATEWAY_HOST_PORT — port hosta mapowany na kontener 18789
• OPENCLAW_PODMAN_BRIDGE_HOST_PORT — port hosta mapowany na kontener 18790
• OPENCLAW_PODMAN_PUBLISH_HOST — interfejs hosta dla opublikowanych portów; domyślnie 127.0.0.1
• OPENCLAW_GATEWAY_BIND — tryb wiązania gateway wewnątrz kontenera; domyślnie lan
• OPENCLAW_PODMAN_USERNS — keep-id (domyślnie), auto lub host

• Wygenerowana usługa Quadlet celowo zachowuje stały, utwardzony domyślny kształt: opublikowane porty 127.0.0.1, --bind lan wewnątrz kontenera i przestrzeń nazw użytkownika keep-id.
• Przypina OPENCLAW_NO_RESPAWN=1, Restart=on-failure i TimeoutStartSec=300.
• Publikuje zarówno 127.0.0.1:18789:18789 (gateway), jak i 127.0.0.1:18790:18790 (bridge).
• Odczytuje ~/.openclaw/.env jako runtime EnvironmentFile dla wartości takich jak OPENCLAW_GATEWAY_TOKEN, ale nie używa listy dozwolonych nadpisań specyficznych dla Podman z ręcznego launchera.
• Jeśli potrzebujesz niestandardowych portów publikacji, hosta publikacji lub innych flag uruchamiania kontenera, użyj ręcznego launchera albo edytuj bezpośrednio ~/.config/containers/systemd/openclaw.container, a następnie przeładuj i zrestartuj usługę.

​

Przydatne polecenia

• Logi kontenera: podman logs -f openclaw
• Zatrzymaj kontener: podman stop openclaw
• Usuń kontener: podman rm -f openclaw
• Otwórz URL dashboardu z hostowego CLI: openclaw dashboard --no-open
• Kondycja/status przez hostowe CLI: openclaw gateway status --deep (sonda RPC + dodatkowe skanowanie usługi)

​

Rozwiązywanie problemów

• Odmowa uprawnień (EACCES) w konfiguracji lub workspace: Kontener domyślnie działa z --userns=keep-id i --user <your uid>:<your gid>. Upewnij się, że ścieżki konfiguracji/workspace na hoście należą do bieżącego użytkownika.
• Start Gateway zablokowany (brak gateway.mode=local): Upewnij się, że ~/.openclaw/openclaw.json istnieje i ustawia gateway.mode="local". scripts/podman/setup.sh tworzy go, jeśli go brakuje.
• Polecenia CLI kontenera trafiają w zły cel: Użyj jawnie openclaw --container <name> ... albo wyeksportuj OPENCLAW_CONTAINER=<name> w swojej powłoce.
• openclaw update kończy się niepowodzeniem z --container: To oczekiwane. Przebuduj/pobierz obraz, a następnie zrestartuj kontener albo usługę Quadlet.
• Usługa Quadlet nie startuje: Uruchom systemctl --user daemon-reload, a następnie systemctl --user start openclaw.service. W systemach bez monitora może być też potrzebne sudo loginctl enable-linger "$(whoami)".
• SELinux blokuje bind mounty: Pozostaw domyślne zachowanie montowania bez zmian; launcher automatycznie dodaje :Z w Linuksie, gdy SELinux jest w trybie enforcing lub permissive.

​

Powiązane

• Docker
• Proces Gateway w tle
• Rozwiązywanie problemów z Gateway