Przejdź do głównej treści
EasyRunner może hostować OpenClaw Gateway jako małą aplikację kontenerową za swoim proxy Caddy. Ten przewodnik zakłada host EasyRunner, który uruchamia aplikacje Compose zgodne z Podman i udostępnia HTTPS przez Caddy.

​
Zanim zaczniesz

  • Serwer EasyRunner z domeną skierowaną do niego.
  • Zbudowany lub opublikowany obraz kontenera OpenClaw.
  • Trwały wolumin konfiguracji dla /home/node/.openclaw.
  • Trwały wolumin obszaru roboczego dla /workspace.
  • Silny token lub hasło Gateway.
Pozostaw uwierzytelnianie urządzeń włączone, gdy to możliwe. Jeśli wdrożenie reverse proxy nie może poprawnie przenosić tożsamości urządzenia, najpierw napraw ustawienia zaufanego proxy; używaj niebezpiecznych obejść uwierzytelniania tylko w pełni prywatnej sieci kontrolowanej przez operatora.

​
Aplikacja Compose

Utwórz aplikację EasyRunner z plikiem Compose o następującej strukturze: 
services:
  openclaw:
    image: ghcr.io/openclaw/openclaw:latest
    restart: unless-stopped
    environment:
      OPENCLAW_GATEWAY_TOKEN: ${OPENCLAW_GATEWAY_TOKEN}
      OPENCLAW_HOME: /home/node
      OPENCLAW_STATE_DIR: /home/node/.openclaw
      OPENCLAW_CONFIG_PATH: /home/node/.openclaw/openclaw.json
      OPENCLAW_WORKSPACE_DIR: /workspace
    volumes:
      - openclaw-config:/home/node/.openclaw
      - openclaw-workspace:/workspace
    labels:
      caddy: openclaw.example.com
      caddy.reverse_proxy: "{{upstreams 1455}}"
    command: ["openclaw", "gateway", "--bind", "lan", "--port", "1455"]

volumes:
  openclaw-config:
  openclaw-workspace:
Zastąp openclaw.example.com nazwą hosta Gateway. Przechowuj OPENCLAW_GATEWAY_TOKEN w menedżerze sekretów/środowiska EasyRunner zamiast zatwierdzać go w definicji aplikacji.

​
Skonfiguruj OpenClaw

W trwałym woluminie konfiguracji utrzymuj Gateway osiągalny tylko przez proxy i wymagaj uwierzytelniania: 
{
  gateway: {
    bind: "lan",
    port: 1455,
    auth: {
      token: "${OPENCLAW_GATEWAY_TOKEN}",
    },
  },
}
Jeśli Caddy kończy TLS dla Gateway, skonfiguruj ustawienia zaufanego proxy dla dokładnej ścieżki proxy zamiast wyłączać kontrole uwierzytelniania globalnie. Zobacz Uwierzytelnianie zaufanego proxy.

​
Weryfikacja

Z Twojej stacji roboczej: 
openclaw gateway probe --url https://openclaw.example.com --token <token>
openclaw gateway status --url https://openclaw.example.com --token <token>
Z hosta EasyRunner sprawdź logi aplikacji pod kątem nasłuchującego Gateway i braku błędów uruchamiania SecretRef, Plugin lub uwierzytelniania kanału.

​
Aktualizacje i kopie zapasowe

  • Pobierz lub zbuduj nowy obraz OpenClaw, a następnie wdróż ponownie aplikację EasyRunner.
  • Utwórz kopię zapasową woluminu openclaw-config przed aktualizacjami.
  • Utwórz kopię zapasową openclaw-workspace, jeśli agenci zapisują tam trwałe dane projektu.
  • Uruchom openclaw doctor po dużych aktualizacjach, aby wykryć migracje konfiguracji i ostrzeżenia usług.

​
Rozwiązywanie problemów

  • gateway probe nie może się połączyć: potwierdź, że nazwa hosta Caddy wskazuje aplikację i że kontener nasłuchuje na 0.0.0.0:1455.
  • Uwierzytelnianie nie działa: obróć token jednocześnie w sekretach EasyRunner i lokalnym poleceniu klienta.
  • Pliki po przywróceniu należą do root: napraw zamontowane woluminy, aby użytkownik kontenera mógł zapisywać w /home/node/.openclaw i /workspace.
  • Pluginy przeglądarki lub kanałów nie działają: sprawdź, czy wymagane zewnętrzne pliki binarne, wyjście do sieci i zamontowane poświadczenia są dostępne wewnątrz kontenera.