// dokumentacja openclaw

Instalacja OpenClaw na Hetzner VPS — tani hosting 24/7

OpenClaw na Hetzner

Hetzner to jeden z najtańszych sposobów uruchomienia trwałego Gateway OpenClaw — koszt wynosi ok. 5 USD miesięcznie. Ten poradnik opisuje konfigurację z użyciem Dockera na VPS z systemem Ubuntu lub Debian.

Co zostanie zainstalowane

  • Serwer Linux (VPS) od Hetzner.
  • Docker jako środowisko uruchomieniowe aplikacji.
  • Trwałe katalogi (~/.openclaw i workspace) zamontowane w kontenerze.
  • Dostęp do panelu sterowania przez tunel SSH.

Szybka instalacja

  1. Zamów VPS — w panelu Hetzner wybierz VPS z Ubuntu/Debian, minimum 2 GB RAM.
  2. Zainstaluj Docker: 
    ssh root@twoj-adres-ip
apt update && apt install -y docker.io docker-compose-plugin
systemctl enable --now docker
  3. Sklonuj repozytorium: 
    git clone https://github.com/openclaw/openclaw.git
cd openclaw
  4. Utwórz katalogi trwałe: 
    mkdir -p ~/.openclaw ~/openclaw-workspace
  5. Przygotuj plik .env: 
    OPENCLAW_GATEWAY_TOKEN=$(openssl rand -hex 32)
GOG_KEYRING_PASSWORD=$(openssl rand -hex 32)
OPENCLAW_GATEWAY_BIND=127.0.0.1
OPENCLAW_GATEWAY_PORT=18789
  6. Skonfiguruj docker-compose.yml z montowaniem wolumenów i zmiennymi środowiskowymi.
  7. Uruchom kontener: 
    docker compose up -d
  8. Zweryfikuj dostęp przez tunel SSH: 
    ssh -L 18789:127.0.0.1:18789 root@twoj-adres-ip

Bezpieczeństwo

Kilka ważnych zasad dotyczących bezpieczeństwa:

  • Domyślnie port 18789 jest powiązany z localhost — Gateway nie jest wystawiony na zewnątrz.
  • Używaj silnych, losowo generowanych sekretów dla OPENCLAW_GATEWAY_TOKEN i GOG_KEYRING_PASSWORD.
  • Jeśli wielu użytkowników korzysta z jednego serwera, zachowaj ścisłą separację — osobne instancje VPS, konta systemowe lub kontenery.
  • Dla środowisk z niezaufanymi użytkownikami rozważ oddzielne hosty.

Infrastruktura jako kod (Terraform)

Społeczność utrzymuje repozytoria Terraform, które automatyzują:

  • Provisionowanie serwera Hetzner.
  • Hardening bezpieczeństwa systemu.
  • Konfigurację zapory sieciowej.
  • Wdrożenie OpenClaw z Docker Compose.

To podejście jest idealne, jeśli zarządzasz wieloma instancjami lub chcesz powtarzalnej konfiguracji.

Wróc do dokumentacji