Przejdź do głównej treści
Wdróż OpenClaw w Render z użyciem Infrastructure as Code. Dołączony Blueprint render.yaml deklaratywnie definiuje cały stos: usługę, dysk, zmienne środowiskowe, dzięki czemu możesz wdrożyć wszystko jednym kliknięciem i wersjonować infrastrukturę razem z kodem.

​
Wymagania wstępne

​
Wdróż za pomocą Render Blueprint

Deploy to Render Kliknięcie tego linku spowoduje:
  1. Utworzenie nowej usługi Render z Blueprint render.yaml w katalogu głównym tego repozytorium.
  2. Zbudowanie obrazu Docker i wdrożenie
Po wdrożeniu adres URL usługi będzie miał postać https://<service-name>.onrender.com.

​
Zrozumienie Blueprint

Render Blueprints to pliki YAML definiujące infrastrukturę. render.yaml w tym repozytorium konfiguruje wszystko, co jest potrzebne do uruchomienia OpenClaw: 
services:
  - type: web
    name: openclaw
    runtime: docker
    plan: starter
    healthCheckPath: /health
    envVars:
      - key: OPENCLAW_GATEWAY_PORT
        value: "8080"
      - key: OPENCLAW_STATE_DIR
        value: /data/.openclaw
      - key: OPENCLAW_WORKSPACE_DIR
        value: /data/workspace
      - key: OPENCLAW_GATEWAY_TOKEN
        generateValue: true # automatycznie generuje bezpieczny token
    disk:
      name: openclaw-data
      mountPath: /data
      sizeGB: 1
Kluczowe funkcje Blueprint użyte tutaj:
FunkcjaCel
runtime: dockerBuduje z Dockerfile repozytorium
healthCheckPathRender monitoruje /health i restartuje niezdrowe instancje
generateValue: trueAutomatycznie generuje wartość bezpieczną kryptograficznie
diskTrwała pamięć, która przetrwa ponowne wdrożenia

​
Wybór planu

PlanUsypianieDyskNajlepszy do
FreePo 15 min bezczynnościNiedostępnyTestów, demonstracji
StarterNigdy1GB+Użytku osobistego, małych zespołów
Standard+Nigdy1GB+Produkcji, wielu kanałów
Blueprint domyślnie używa planu starter. Aby użyć planu bezpłatnego, zmień plan: free w render.yaml swojego forka (ale uwaga: brak trwałego dysku oznacza, że stan OpenClaw resetuje się przy każdym wdrożeniu).

​
Po wdrożeniu

​
Dostęp do interfejsu Control UI

Panel webowy jest dostępny pod adresem https://<your-service>.onrender.com/. Połącz się przy użyciu skonfigurowanego współdzielonego sekretu. Ten szablon wdrożeniowy automatycznie generuje OPENCLAW_GATEWAY_TOKEN (znajdziesz go w Dashboard → your service → Environment); jeśli zastąpisz go uwierzytelnianiem hasłem, użyj tego hasła.

​
Funkcje Render Dashboard

​
Logi

Wyświetlaj logi w czasie rzeczywistym w Dashboard → your service → Logs. Filtruj według:
  • Logów budowania (tworzenie obrazu Docker)
  • Logów wdrożenia (uruchomienie usługi)
  • Logów runtime (dane wyjściowe aplikacji)

​
Dostęp do powłoki

Do debugowania otwórz sesję powłoki przez Dashboard → your service → Shell. Trwały dysk jest zamontowany w /data.

​
Zmienne środowiskowe

Modyfikuj zmienne w Dashboard → your service → Environment. Zmiany automatycznie uruchamiają ponowne wdrożenie.

​
Automatyczne wdrażanie

Jeśli używasz oryginalnego repozytorium OpenClaw, Render nie będzie automatycznie wdrażać Twojego OpenClaw. Aby go zaktualizować, uruchom ręczną synchronizację Blueprint z poziomu dashboardu.

​
Własna domena

  1. Przejdź do Dashboard → your service → Settings → Custom Domains
  2. Dodaj swoją domenę
  3. Skonfiguruj DNS zgodnie z instrukcjami (CNAME do *.onrender.com)
  4. Render automatycznie wystawi 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 zwykle wystarcza. Skalowanie poziome wymaga sticky sessions albo zewnętrznego zarządzania stanem.

​
Kopie zapasowe i migracja

W dowolnym momencie możesz wyeksportować stan, konfigurację, profile uwierzytelniania i obszar roboczy, korzystając z dostępu do powłoki w Render Dashboard: 
openclaw backup create
Tworzy to przenośne archiwum kopii zapasowej zawierające stan OpenClaw oraz każdy skonfigurowany obszar roboczy. Szczegóły znajdziesz w Backup.

​
Rozwiązywanie problemów

​
Usługa nie chce się uruchomić

Sprawdź logi wdrożenia w Render Dashboard. Typowe problemy:
  • Brak OPENCLAW_GATEWAY_TOKEN — upewnij się, że jest ustawione w Dashboard → Environment
  • Niezgodność portu — upewnij się, że ustawiono OPENCLAW_GATEWAY_PORT=8080, aby gateway nasłuchiwał na porcie oczekiwanym przez Render

​
Powolne zimne starty (plan bezpłatny)

Usługi w planie bezpłatnym usypiają się po 15 minutach bezczynności. Pierwsze żądanie po uśpieniu trwa kilka sekund, ponieważ kontener musi się uruchomić. Przejdź na plan Starter, aby działać stale.

​
Utrata danych po ponownym wdrożeniu

Dzieje się tak w planie bezpłatnym (brak trwałego dysku). Przejdź na plan płatny lub regularnie eksportuj pełną kopię zapasową przez openclaw backup create w powłoce Render.

​
Błędy health check

Render oczekuje odpowiedzi 200 z /health w ciągu 30 sekund. Jeśli buildy kończą się sukcesem, ale wdrożenia nie, usługa może uruchamiać się zbyt długo. Sprawdź:
  • Logi builda pod kątem błędów
  • Czy kontener uruchamia się lokalnie przez docker build && docker run

​
Następne kroki