Skip to main content

​
openclaw nodes

Zarządzanie sparowanymi węzłami (urządzeniami) i wywoływanie funkcji węzłów. Powiązane: Omówienie węzłów - Aktywna obecność przy komputerze - Węzły kamer - Węzły obrazów Wspólne opcje każdego podpolecenia: --url <url>, --token <token>, --timeout <ms> (domyślnie 10000), --json.

​
Stan

Zarówno status, jak i list przyjmują --connected (tylko połączone węzły) oraz --last-connected <duration> (np. 24h, 7d; tylko węzły, które połączyły się w podanym okresie). list wyświetla oczekujące i sparowane węzły w osobnych tabelach, a wiersze sparowanych węzłów zawierają czas od ostatniego połączenia (Last Connect); status wyświetla jedną połączoną tabelę ze szczegółami funkcji, wersji i ostatniego działania wejściowego każdego węzła. Połączony węzeł macOS zgłasza ostatnie działanie wejściowe tylko wtedy, gdy przyznano uprawnienie Accessibility, a najświeższy wiersz jest oznaczony jako active; zobacz Aktywna obecność przy komputerze. describe wyświetla funkcje, uprawnienia, aktywność oraz obowiązujące i oczekujące polecenia wywołania jednego węzła.

​
Parowanie

Te polecenia obsługują należący do Gateway magazyn node.pair.*, odrębny od parowania urządzeń (openclaw devices approve), które kontroluje uzgadnianie WS connect węzła. Zależność między nimi opisano w sekcji Węzły.
  • remove unieważnia wpis sparowanej roli węzła. W przypadku węzła powiązanego z urządzeniem unieważnia to rolę node w magazynie parowania urządzeń i rozłącza sesje jego roli węzła: urządzenie z wieloma rolami zachowuje swój wiersz i traci tylko rolę node, natomiast wiersz urządzenia pełniącego wyłącznie rolę węzła zostaje usunięty. Usuwany jest również każdy pasujący starszy rekord parowania węzła należący do Gateway.
  • pending wymaga jedynie zakresu operator.pairing.
  • gateway.nodes.pairing.autoApproveCidrs może pominąć etap oczekiwania przy pierwszym parowaniu jawnie zaufanego urządzenia role: node. Domyślnie wyłączone; nie zatwierdza podwyższenia ról.
  • gateway.nodes.pairing.sshVerify (domyślnie włączone) automatycznie zatwierdza pierwsze parowanie urządzenia role: node, gdy Gateway może zweryfikować klucz urządzenia przez SSH z hostem węzła; pierwszy zestaw funkcji zostaje zatwierdzony w tym samym kroku. Zobacz Parowanie węzłów.
  • Wymagania dotyczące zakresu approve wynikają z poleceń zadeklarowanych przez oczekujące żądanie:
    • żądanie bez polecenia: operator.pairing
    • zwykłe polecenia węzła: operator.pairing + operator.write
    • polecenia wrażliwe administracyjnie (system.run, system.run.prepare, system.which, browser.proxy, fs.listDir i system.execApprovals.get/set): operator.pairing + operator.admin
  • Zakres remove: operator.pairing może usuwać wiersze węzłów niebędących operatorami; wywołujący przy użyciu tokenu urządzenia, który unieważnia własną rolę węzła na urządzeniu z wieloma rolami, dodatkowo potrzebuje operator.admin.

​
Wywoływanie

Flagi:
  • --command <command> (wymagane): np. canvas.eval.
  • --params <json>: ciąg znaków zawierający obiekt JSON (domyślnie {}).
  • --invoke-timeout <ms>: limit czasu wywołania węzła (domyślnie 15000).
  • --idempotency-key <key>: opcjonalny klucz idempotencji.
system.run i system.run.prepare są tutaj blokowane; do wykonywania poleceń powłoki należy zamiast tego używać narzędzia exec z host=node. system.which jest dozwolone za pośrednictwem invoke.

​
Powiadomienia, push, lokalizacja i ekran

  • notify wysyła lokalne powiadomienie na węzeł deklarujący system.notify, w tym węzły macOS, iOS, Android oraz bezpośrednie węzły watchOS. Bezpośrednie dostarczanie do watchOS wymaga aktywnego OpenClaw. Wymaga --title lub --body. Opcje: --sound <name>, --priority <passive|active|timeSensitive>, --delivery <system|overlay|auto> (domyślnie system), --invoke-timeout <ms> (domyślnie 15000).
  • push wysyła testowe powiadomienie push APNs do węzła iOS. Opcje: --title <text> (domyślnie OpenClaw), --body <text>, --environment <sandbox|production> w celu zastąpienia wykrytego środowiska APNs.
  • location get pobiera bieżącą lokalizację węzła. Opcje: --max-age <ms> (ponowne użycie zapisanego w pamięci podręcznej ustalenia pozycji), --accuracy <coarse|balanced|precise>, --location-timeout <ms> (domyślnie 10000), --invoke-timeout <ms> (domyślnie 20000).
  • screen record przechwytuje krótki klip i wyświetla ścieżkę zapisu (lub zapisuje dane JSON przy użyciu --json). Opcje: --screen <index> (domyślnie 0), --duration <ms|10s> (domyślnie 10000), --fps <fps> (domyślnie 10), --no-audio, --out <path>, --invoke-timeout <ms> (domyślnie 120000).
Polecenia Camera i Canvas mają osobną dokumentację: Węzły kamer, Canvas. Canvas jest implementowane przez dołączony eksperymentalny plugin Canvas; rdzeń zachowuje openclaw nodes canvas jako punkt montowania zapewniający zgodność.

​
Powiązane