// dokumentacja openclaw

Instalacja OpenClaw na Fly.io — wdrożenie z trwałym magazynem

OpenClaw na Fly.io

Fly.io to platforma chmurowa idealnie nadająca się do uruchamiania małych, trwałych usług. Ten poradnik opisuje wdrożenie OpenClaw Gateway z persystentnym magazynem danych, automatycznym HTTPS i integracją kanałów komunikacji. Koszt to ok. 10–15 USD miesięcznie.

Wymagania wstępne

  • Narzędzie flyctl (CLI Fly.io) — zainstaluj przez curl -L https://fly.io/install.sh | sh.
  • Konto Fly.io (dostępna warstwa darmowa).
  • Klucze API providerów modeli AI.
  • Tokeny kanałów komunikacji (opcjonalnie — np. bot Discord, Telegram).

Szybki start w 5 krokach

1. Utworzenie aplikacji

git clone https://github.com/openclaw/openclaw.git
cd openclaw

# Utworz aplikacje Fly z wolumenem 1 GB
fly apps create openclaw-gateway
fly volumes create openclaw_data --size 1 --region waw

Wybierz region najbliższy Twojej lokalizacji — np. waw (Warszawa) dla użytkowników w Polsce.

2. Konfiguracja fly.toml

Dostosuj plik fly.toml do swoich potrzeb:

[build]
  dockerfile = "Dockerfile"

[env]
  OPENCLAW_GATEWAY_BIND = "lan"
  OPENCLAW_STATE_DIR = "/data/.openclaw"

[[mounts]]
  source = "openclaw_data"
  destination = "/data"

[[services]]
  internal_port = 3000
  protocol = "tcp"
  [services.concurrency]
    hard_limit = 25
    soft_limit = 20

[[vm]]
  memory = "2gb"

Ważne: internal_port musi odpowiadać portowi Gateway (3000). Zalecane 2 GB pamięci zamiast domyślnych 512 MB.

3. Ustawienie sekretów

fly secrets set OPENAI_API_KEY="sk-..."
fly secrets set OPENCLAW_GATEWAY_TOKEN="$(openssl rand -hex 32)"

4. Wdrożenie

fly deploy

Fly.io automatycznie zbuduje obraz Docker i uruchomi kontener.

5. Dostęp do panelu

Po wdrożeniu utwórz konfigurację przez SSH i otwórz panel sterowania:

# Dostep SSH do kontenera
fly ssh console

# Lub otworz panel w przegladarce
fly proxy 18789:3000

Wdrożenie prywatne

Dla zwiększonego bezpieczeństwa możesz użyć konfiguracji fly.private.toml, która usuwa publiczny adres IP. Dostęp jest wówczas możliwy wyłącznie przez SSH, WireGuard lub lokalny proxy.

Rozwiązywanie problemów

  • Niepowodzenie health check — upewnij się, że internal_port odpowiada portowi Gateway i że Gateway nasłuchuje na lan (nie localhost).
  • Problemy z bindowaniem — użyj OPENCLAW_GATEWAY_BIND=lan zamiast 0.0.0.0.
  • Brak pamięci — zwiększ alokację do 2 GB w sekcji [[vm]].
  • Plik blokady — jeśli Gateway nie startuje, usuń plik blokady przez fly ssh console.
Wróc do dokumentacji