Przejdź do głównej treści

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Render

Wdróż OpenClaw na Render, używając 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

​
Wdrażanie za pomocą Render Blueprint

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

​
Jak działa 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 # auto-generates a secure token
    disk:
      name: openclaw-data
      mountPath: /data
      sizeGB: 1
Użyte najważniejsze funkcje Blueprint:
FunkcjaCel
runtime: dockerBuduje z Dockerfile repozytorium
healthCheckPathRender monitoruje /health i restartuje niezdrowe instancje
generateValue: trueAutomatycznie generuje kryptograficznie bezpieczną wartość
diskTrwała pamięć masowa, która przetrwa ponowne wdrożenia

​
Wybór planu

PlanUsypianieDyskNajlepszy do
FreePo 15 min bezczynnościNiedostępnyTestowania, 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 darmowego, 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 Control UI

Panel web 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 zamiast tego tego hasła.

​
Funkcje Render Dashboard

​
Logi

Przeglądaj logi w czasie rzeczywistym w Dashboard → your service → Logs. Filtruj według:
  • logów buildu (tworzenie obrazu Docker)
  • logów wdrożenia (uruchamianie usługi)
  • logów runtime (wyjście aplikacji)

​
Dostęp do shella

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

​
Zmienne środowiskowe

Modyfikuj zmienne w Dashboard → your service → Environment. Zmiany wywołują automatyczne ponowne wdrożenie.

​
Auto-deploy

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 panelu.

​
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)
Dla OpenClaw skalowanie pionowe zwykle jest wystarczające. Skalowanie poziome wymaga lepkich sesji albo zewnętrznego zarządzania stanem.

​
Kopie zapasowe i migracja

Wyeksportuj stan, konfigurację, profile uwierzytelniania i workspace w dowolnym momencie, używając dostępu do shella w Render Dashboard: 
openclaw backup create
To tworzy przenośne archiwum kopii zapasowej ze stanem OpenClaw oraz dowolnym skonfigurowanym workspace. 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 — sprawdź, czy jest ustawione w Dashboard → Environment
  • Niedopasowanie portu — upewnij się, że ustawiono OPENCLAW_GATEWAY_PORT=8080, aby gateway nasłuchiwał na porcie oczekiwanym przez Render

​
Wolne zimne starty (plan darmowy)

Usługi w planie darmowym przechodzą w stan uśpienia po 15 minutach bezczynności. Pierwsze żądanie po uśpieniu trwa kilka sekund, zanim kontener się uruchomi. Przejdź na plan Starter, aby mieć usługę zawsze włączoną.

​
Utrata danych po ponownym wdrożeniu

Dzieje się tak w planie darmowym (brak trwałego dysku). Przejdź na plan płatny albo regularnie eksportuj pełną kopię zapasową przez openclaw backup create w shellu 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 kończą się błędem, usługa może uruchamiać się zbyt długo. Sprawdź:
  • logi buildu pod kątem błędów
  • czy kontener uruchamia się lokalnie przy użyciu docker build && docker run

​
Następne kroki