Na tej stronie

Na tej stronie

CLI commands

Demon

openclaw daemon

Starszy alias do zarządzania usługą Gateway. openclaw daemon ... odpowiada tym samym poleceniom sterowania usługą co openclaw gateway .... Aktualną dokumentację i przykłady zawiera sekcja openclaw gateway.

Użycie

bash
openclaw daemon statusopenclaw daemon installopenclaw daemon startopenclaw daemon stopopenclaw daemon restartopenclaw daemon uninstall

Podpolecenia i opcje

Podpolecenie Opcje
status --url, --token, --password, --timeout, --no-probe, --require-rpc, --deep, --json
install --port, --runtime <node>, --token, --wrapper <path>, --force, --json
uninstall --json
start --json
stop --json, --disable (tylko launchd: trwale wyłącza KeepAlive/RunAtLoad do następnego uruchomienia)
restart --force, --safe, --skip-deferral, --wait <duration>, --json
  • status: wyświetla stan instalacji usługi (launchd/systemd/schtasks) i sprawdza kondycję Gateway.
  • install: instaluje usługę; --force ponownie instaluje lub nadpisuje istniejącą instalację.
  • restart --safe: prosi działający Gateway o wstępne sprawdzenie aktywnych zadań i zaplanowanie jednego skonsolidowanego ponownego uruchomienia po ich zakończeniu, z limitem określonym przez gateway.reload.deferralTimeoutMs (domyślnie 300000ms/5 minut; ustawienie 0 oznacza oczekiwanie bezterminowe). Po wyczerpaniu tego limitu ponowne uruchomienie jest mimo wszystko wymuszane. Zwykłe restart korzysta bezpośrednio z menedżera usług; --force wymusza wykonanie natychmiastowe.
  • restart --safe --skip-deferral: pomija mechanizm odraczania z powodu aktywnych zadań, dzięki czemu Gateway uruchamia się ponownie natychmiast, nawet gdy zgłoszono blokady. Wymaga --safe.

Uwagi

  • status w miarę możliwości rozwiązuje skonfigurowane odwołania SecretRef uwierzytelniania na potrzeby uwierzytelniania testu. Jeśli wymagane odwołanie SecretRef pozostaje nierozwiązane, status --json zgłasza rpc.authWarning; należy jawnie przekazać --token/--password lub najpierw rozwiązać źródło sekretu. Ostrzeżenia o nierozwiązanym uwierzytelnianiu są wyciszane, gdy test poza tym kończy się powodzeniem.
  • status --deep dodaje wykonywane w miarę możliwości skanowanie na poziomie systemu w poszukiwaniu innych usług podobnych do Gateway (wyświetla wskazówki dotyczące czyszczenia; nadal zaleca się jeden Gateway na maszynę) oraz uruchamia walidację konfiguracji w trybie uwzględniającym pluginy, ujawniając ostrzeżenia manifestów pluginów pomijane przez szybką ścieżkę domyślną.
  • W instalacjach systemd w systemie Linux kontrole rozbieżności tokenów sprawdzają źródła jednostek zarówno Environment=, jak i EnvironmentFile=.
  • Kontrole rozbieżności tokenów rozwiązują odwołania SecretRef gateway.auth.token przy użyciu scalonego środowiska uruchomieniowego (najpierw środowisko polecenia usługi, następnie środowisko procesu). Jeśli uwierzytelnianie tokenem nie jest faktycznie aktywne (gateway.auth.mode ma wartość password/none/trusted-proxy albo nie jest ustawione, a pierwszeństwo może uzyskać hasło), rozwiązywanie tokenu konfiguracji jest pomijane.
  • install sprawdza, czy zarządzane przez SecretRef odwołanie gateway.auth.token można rozwiązać, ale nigdy nie zapisuje rozwiązanej wartości w metadanych środowiska usługi; jeśli rozwiązanie nie jest możliwe, instalacja kończy się niepowodzeniem zgodnie z zasadą bezpiecznego odrzucenia.
  • Jeśli skonfigurowano zarówno gateway.auth.token, jak i gateway.auth.password, a gateway.auth.mode nie jest ustawione, install blokuje działanie do czasu jawnego ustawienia trybu.
  • W systemie macOS install ustawia pliki plist LaunchAgent oraz wygenerowany plik środowiska/skrypt opakowujący jako dostępne wyłącznie dla właściciela (tryb 0600/0700), zamiast osadzać sekrety w EnvironmentVariables.
  • Uruchamianie wielu instancji Gateway na jednym hoście: należy odizolować porty, konfigurację/stan oraz obszary robocze. Zobacz Wiele instancji Gateway.

Powiązane

Was this useful?