Przejdź do głównej treści

​
Rozwiązywanie problemów węzła

Użyj tej strony, gdy węzeł jest widoczny w statusie, ale narzędzia węzła nie działają.

​
Drabina poleceń

openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor
openclaw channels status --probe
Następnie uruchom kontrole specyficzne dla węzła: 
openclaw nodes status
openclaw nodes describe --node <idOrNameOrIp>
openclaw approvals get --node <idOrNameOrIp>
Zdrowe sygnały:
  • Węzeł jest połączony i sparowany dla roli node.
  • nodes describe obejmuje wywoływaną możliwość.
  • Zatwierdzenia exec pokazują oczekiwany tryb/listę dozwolonych.

​
Wymagania pierwszoplanowe

canvas.*, camera.* i screen.* są dostępne wyłącznie w trybie pierwszoplanowym na węzłach iOS/Android. Szybkie sprawdzenie i naprawa: 
openclaw nodes describe --node <idOrNameOrIp>
openclaw nodes canvas snapshot --node <idOrNameOrIp>
openclaw logs --follow
Jeśli zobaczysz NODE_BACKGROUND_UNAVAILABLE, przenieś aplikację węzła na pierwszy plan i spróbuj ponownie.

​
Macierz uprawnień

MożliwośćiOSAndroidAplikacja węzła macOSTypowy kod błędu
camera.snap, camera.clipAparat (+ mikrofon dla dźwięku klipu)Aparat (+ mikrofon dla dźwięku klipu)Aparat (+ mikrofon dla dźwięku klipu)*_PERMISSION_REQUIRED
screen.recordNagrywanie ekranu (+ mikrofon opcjonalnie)Monit o przechwytywanie ekranu (+ mikrofon opcjonalnie)Nagrywanie ekranu*_PERMISSION_REQUIRED
location.getPodczas użycia lub Zawsze (zależnie od trybu)Lokalizacja na pierwszym planie/w tle w zależności od trybuUprawnienie lokalizacjiLOCATION_PERMISSION_REQUIRED
system.runn/d (ścieżka hosta węzła)n/d (ścieżka hosta węzła)Wymagane zatwierdzenia execSYSTEM_RUN_DENIED

​
Parowanie a zatwierdzenia

To są różne bramki:
  1. Parowanie urządzenia: czy ten węzeł może połączyć się z gateway?
  2. Zatwierdzenia exec: czy ten węzeł może uruchomić konkretne polecenie powłoki?
Szybkie kontrole: 
openclaw devices list
openclaw nodes status
openclaw approvals get --node <idOrNameOrIp>
openclaw approvals allowlist add --node <idOrNameOrIp> "/usr/bin/uname"
Jeśli brakuje parowania, najpierw zatwierdź urządzenie węzła. Jeśli parowanie jest poprawne, ale system.run nie działa, napraw zatwierdzenia exec/listę dozwolonych.

​
Typowe kody błędów węzła

  • NODE_BACKGROUND_UNAVAILABLE → aplikacja działa w tle; przenieś ją na pierwszy plan.
  • CAMERA_DISABLED → przełącznik kamery wyłączony w ustawieniach węzła.
  • *_PERMISSION_REQUIRED → brakujące/odrzucone uprawnienie systemowe.
  • LOCATION_DISABLED → tryb lokalizacji jest wyłączony.
  • LOCATION_PERMISSION_REQUIRED → żądany tryb lokalizacji nie został przyznany.
  • LOCATION_BACKGROUND_UNAVAILABLE → aplikacja działa w tle, ale istnieje tylko uprawnienie „Podczas użycia”.
  • SYSTEM_RUN_DENIED: approval required → żądanie exec wymaga jawnego zatwierdzenia.
  • SYSTEM_RUN_DENIED: allowlist miss → polecenie zablokowane przez tryb listy dozwolonych.

​
Szybka pętla odzyskiwania

openclaw nodes status
openclaw nodes describe --node <idOrNameOrIp>
openclaw approvals get --node <idOrNameOrIp>
openclaw logs --follow
Jeśli nadal występuje problem:
  • Ponownie zatwierdź parowanie urządzenia.
  • Ponownie otwórz aplikację węzła (pierwszy plan).
  • Ponownie nadaj uprawnienia systemowe.
  • Odtwórz/dostosuj politykę zatwierdzeń exec.
Powiązane: