Wdróż OpenClaw na Render korzystając z Infrastructure as Code. Dołączony plik render.yaml (Blueprint) opisuje cały stos deklaratywnie — usługę, dysk, zmienne środowiskowe — dzięki czemu wdrożysz wszystko jednym kliknięciem, a konfiguracja infrastruktury żyje obok kodu.

Wymagania wstępne

• Konto na Render (dostępna darmowa warstwa)
• Klucz API od wybranego dostawcy modelu

Wdrożenie za pomocą Render Blueprint

Deploy to Render

Kliknięcie tego linku spowoduje:

1. Utworzenie nowej usługi Render na podstawie pliku render.yaml (Blueprint) z głównego katalogu repozytorium.
2. Wyświetlenie monitu o podanie SETUP_PASSWORD.
3. Zbudowanie obrazu Docker i wdrożenie.

Po wdrożeniu URL Twojej usługi będzie miał postać https://<nazwa-uslugi>.onrender.com.

Jak działa Blueprint

Render Blueprints to pliki YAML opisujące Twoją infrastrukturę. Plik render.yaml w tym repozytorium konfiguruje wszystko, co potrzebne do uruchomienia OpenClaw:

services:
  - type: web
    name: openclaw
    runtime: docker
    plan: starter
    healthCheckPath: /health
    envVars:
      - key: PORT
        value: "8080"
      - key: SETUP_PASSWORD
        sync: false # prompts during deploy
      - key: OPENCLAW_STATE_DIR
        value: /data/.openclaw
      - key: OPENCLAW_WORKSPACE_DIR
        value: /data/workspace
      - key: OPENCLAW_GATEWAY_TOKEN
        generateValue: true # auto-generates a secure token
    disk:
      name: openclaw-data
      mountPath: /data
      sizeGB: 1

Kluczowe mechanizmy Blueprint:

Wybór planu

Blueprint domyślnie ustawia plan starter. Aby użyć darmowej warstwy, zmień plan: free w render.yaml swojego forka (ale uwaga: brak trwałego dysku oznacza, że konfiguracja resetuje się przy każdym wdrożeniu).

Po wdrożeniu

Dokończ konfigurację w kreatorze

1. Przejdź do https://<twoja-usluga>.onrender.com/setup
2. Podaj swoje SETUP_PASSWORD
3. Wybierz dostawcę modelu i wklej klucz API
4. Opcjonalnie skonfiguruj kanały komunikacji (Telegram, Discord, Slack)
5. Kliknij Run setup

Panel sterowania (Control UI)

Dashboard webowy jest dostępny pod adresem https://<twoja-usluga>.onrender.com/openclaw.

Funkcje panelu Render

Logi

Podgląd logów w czasie rzeczywistym: Dashboard → Twoja usługa → Logs. Filtruj według:

• Logi budowania (tworzenie obrazu Docker)
• Logi wdrożenia (start usługi)
• Logi runtime (wyjście aplikacji)

Dostęp do powłoki

Do debugowania otwórz sesję powłoki: Dashboard → Twoja usługa → Shell. Trwały dysk jest zamontowany w /data.

Zmienne środowiskowe

Zmienne możesz modyfikować w Dashboard → Twoja usługa → Environment. Zmiany automatycznie uruchamiają ponowne wdrożenie.

Automatyczne wdrożenia

Jeśli korzystasz z oryginalnego repozytorium OpenClaw, Render nie będzie automatycznie wdrażał aktualizacji. Aby zaktualizować, uruchom ręczną synchronizację Blueprint z poziomu panelu.

Własna domena

1. Przejdź do Dashboard → Twoja usługa → Settings → Custom Domains
2. Dodaj swoją domenę
3. Skonfiguruj DNS zgodnie z instrukcją (CNAME wskazujący na *.onrender.com)
4. Render automatycznie wygeneruje certyfikat TLS

Skalowanie

Render obsługuje skalowanie poziome i pionowe:

• Pionowe: zmień plan, aby uzyskać więcej CPU/RAM
• Poziome: zwiększ liczbę instancji (plan Standard i wyższe)

W przypadku OpenClaw skalowanie pionowe zazwyczaj wystarcza. Skalowanie poziome wymaga sesji przypiętych (sticky sessions) lub zewnętrznego zarządzania stanem.

Kopie zapasowe i migracja

Wyeksportuj konfigurację i workspace w dowolnym momencie:

https://<twoja-usluga>.onrender.com/setup/export

Pobierzesz przenośną kopię zapasową, którą możesz przywrócić na dowolnym hoście OpenClaw.

Rozwiązywanie problemów

Usługa nie startuje

Sprawdź logi wdrożenia w panelu Render. Najczęstsze przyczyny:

• Brak SETUP_PASSWORD — Blueprint powinien o to zapytać, ale upewnij się, że wartość jest ustawiona
• Niezgodność portów — sprawdź, czy PORT=8080 zgadza się z portem z Dockerfile

Wolny start na zimno (darmowa warstwa)

Usługi na darmowym planie wyłączają się po 15 minutach bezczynności. Pierwsze żądanie po wyłączeniu trwa kilka sekund, zanim kontener się uruchomi. Przejdź na plan Starter, żeby usługa działała non-stop.

Utrata danych po ponownym wdrożeniu

Dzieje się tak na darmowej warstwie (brak trwałego dysku). Przejdź na płatny plan lub regularnie eksportuj konfigurację przez /setup/export.

Błędy health check

Render oczekuje odpowiedzi 200 z /health w ciągu 30 sekund. Jeśli budowanie się udaje, ale wdrożenie nie, usługa może zbyt długo się uruchamiać. Sprawdź:

• Logi budowania pod kątem błędów
• Czy kontener uruchamia się lokalnie przez docker build && docker run