// dokumentacja openclaw

Instalacja OpenClaw z Docker — konteneryzacja krok po kroku

OpenClaw w kontenerze Docker

Docker to opcjonalna metoda wdrożenia OpenClaw, szczególnie przydatna w przypadku izolowanych środowisk lub systemów, na których nie chcesz instalować zależności globalnie. Dla codziennego rozwoju zalecana jest standardowa instalacja — jest szybsza i wygodniejsza.

Wymagania wstępne

Przed rozpoczęciem upewnij się, że dysponujesz:

  • Docker Desktop lub Docker Engine z Compose v2.
  • Minimum 2 GB RAM przydzielone dla Dockera — mniejsza ilość pamięci może powodować błędy OOM podczas budowania obrazu.
  • Odpowiednia ilość wolnego miejsca na dysku (obraz OpenClaw zajmuje ok. 1–2 GB).
  • Klucz API providera AI (np. OpenAI, Anthropic).

Szybki start — skrypt konfiguracyjny

Najłatwiejszy sposób uruchomienia OpenClaw w Dockerze:

# Sklonuj repozytorium
git clone https://github.com/openclaw/openclaw.git
cd openclaw

# Uruchom skrypt konfiguracyjny
./scripts/docker/setup.sh

Skrypt automatycznie zbuduje obraz Docker, przeprowadzi onboarding (poprosi o klucze API i wygeneruje tokeny) oraz uruchomi kontener.

Użycie gotowego obrazu z rejestru

Możesz również użyć gotowego obrazu z GitHub Container Registry:

docker pull ghcr.io/openclaw/openclaw:latest
docker run -d --name openclaw \
  -v ~/.openclaw:/root/.openclaw \
  -p 18789:18789 \
  ghcr.io/openclaw/openclaw:latest

Katalog ~/.openclaw jest montowany jako wolumen, dzięki czemu konfiguracja i dane persystują między restartami kontenera.

Konfiguracja przez zmienne środowiskowe

Możesz dostosować wdrożenie za pomocą zmiennych środowiskowych:

  • OPENCLAW_IMAGE — nazwa obrazu Docker (domyślnie: ghcr.io/openclaw/openclaw:latest).
  • OPENCLAW_EXTENSIONS — lista rozszerzeń do zainstalowania przy starcie.
  • OPENCLAW_EXTRA_MOUNTS — dodatkowe wolumeny do zamontowania w kontenerze.
  • OPENCLAW_SANDBOX — włącza sandboxing dla narzędzi agentów.

Docker Compose

Dla bardziej zaawansowanej konfiguracji przygotuj plik docker-compose.yml:

version: "3.8"
services:
  openclaw:
    image: ghcr.io/openclaw/openclaw:latest
    container_name: openclaw
    restart: unless-stopped
    ports:
      - "18789:18789"
    volumes:
      - ~/.openclaw:/root/.openclaw
      - ./workspace:/root/workspace
    environment:
      - OPENCLAW_GATEWAY_TOKEN=${OPENCLAW_GATEWAY_TOKEN}
      - OPENCLAW_GATEWAY_BIND=0.0.0.0

Uruchom poleceniem docker compose up -d.

Sandboxing agentów

OpenClaw obsługuje izolowane kontenery Docker do wykonywania narzędzi agentów. Umożliwia to bezpieczne uruchamianie niezaufanych sesji bez konteneryzacji całego Gateway. Sandboxing można włączyć:

  • Na poziomie pojedynczego agenta.
  • Na poziomie sesji.
  • Ze współdzielonym zakresem między agentami.

Panel sterowania

Po uruchomieniu kontenera przejdź do panelu sterowania (Control UI) pod adresem:

http://127.0.0.1:18789/

Stąd możesz konfigurować kanały komunikacji (WhatsApp, Telegram, Discord), zarządzać agentami i monitorować ich aktywność.

Rozwiązywanie problemów

  • Błąd uprawnień — upewnij się, że katalog ~/.openclaw należy do użytkownika o UID 1000: sudo chown -R 1000:1000 ~/.openclaw.
  • Brak obrazu sandboxa — zbuduj obraz sandboxa poleceniem docker build -t openclaw-sandbox ./scripts/docker/sandbox.
  • Błąd OOM podczas budowania — zwiększ limit pamięci Dockera do co najmniej 2 GB w ustawieniach Docker Desktop.
  • Kontener nie startuje — sprawdź logi: docker logs openclaw.
Wróc do dokumentacji