Użyj tej strony, gdy węzeł jest widoczny w statusie, ale narzędzia węzła zawodzą.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.
Drabina poleceń
- Węzeł jest połączony i sparowany dla roli
node. nodes describezawiera wywoływaną funkcję.- Zatwierdzenia exec pokazują oczekiwany tryb/listę dozwolonych.
Wymagania pierwszego planu
canvas.*, camera.* i screen.* działają tylko na pierwszym planie na węzłach iOS/Android.
Szybka kontrola i poprawka:
NODE_BACKGROUND_UNAVAILABLE, przenieś aplikację węzła na pierwszy plan i spróbuj ponownie.
Macierz uprawnień
| Funkcja | iOS | Android | Aplikacja węzła macOS | Typowy kod błędu |
|---|---|---|---|---|
camera.snap, camera.clip | Kamera (+ mikrofon dla dźwięku klipu) | Kamera (+ mikrofon dla dźwięku klipu) | Kamera (+ mikrofon dla dźwięku klipu) | *_PERMISSION_REQUIRED |
screen.record | Nagrywanie ekranu (+ opcjonalnie mikrofon) | Monit przechwytywania ekranu (+ opcjonalnie mikrofon) | Nagrywanie ekranu | *_PERMISSION_REQUIRED |
location.get | Podczas używania lub zawsze (zależy od trybu) | Lokalizacja na pierwszym planie/w tle zależnie od trybu | Uprawnienie do lokalizacji | LOCATION_PERMISSION_REQUIRED |
system.run | nie dotyczy (ścieżka hosta węzła) | nie dotyczy (ścieżka hosta węzła) | Wymagane zatwierdzenia exec | SYSTEM_RUN_DENIED |
Parowanie a zatwierdzenia
To są różne bramki:- Parowanie urządzenia: czy ten węzeł może połączyć się z Gateway?
- Polityka poleceń węzła Gateway: czy identyfikator polecenia RPC jest dozwolony przez
gateway.nodes.allowCommands/denyCommandsoraz domyślne ustawienia platformy? - Zatwierdzenia exec: czy ten węzeł może lokalnie uruchomić konkretne polecenie powłoki?
nodes describe brakuje polecenia, sprawdź politykę poleceń węzła Gateway oraz czy węzeł faktycznie zadeklarował to polecenie przy połączeniu.
Jeśli parowanie jest poprawne, ale system.run kończy się niepowodzeniem, popraw zatwierdzenia exec/listę dozwolonych na tym węźle.
Parowanie węzła jest bramką tożsamości/zaufania, a nie powierzchnią zatwierdzania per polecenie. Dla system.run polityka dla danego węzła znajduje się w pliku zatwierdzeń exec tego węzła (openclaw approvals get --node ...), a nie w rekordzie parowania Gateway.
Dla uruchomień z host=node opartych na zatwierdzeniach Gateway wiąże też wykonanie z
przygotowanym kanonicznym systemRunPlan. Jeśli późniejszy wywołujący zmieni polecenie/cwd lub
metadane sesji przed przekazaniem zatwierdzonego uruchomienia, Gateway odrzuca
uruchomienie jako niezgodność zatwierdzenia zamiast ufać edytowanemu ładunkowi.
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 jest wyłączony w ustawieniach węzła.*_PERMISSION_REQUIRED→ brakuje uprawnienia systemu operacyjnego lub zostało odmówione.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żywania.SYSTEM_RUN_DENIED: approval required→ żądanie exec wymaga jawnego zatwierdzenia.SYSTEM_RUN_DENIED: allowlist miss→ polecenie zablokowane przez tryb listy dozwolonych. Na hostach węzłów Windows formy opakowujące powłokę, takie jakcmd.exe /c ..., są traktowane jako braki na liście dozwolonych w trybie listy dozwolonych, chyba że zostaną zatwierdzone przez przepływ pytania.
Szybka pętla odzyskiwania
- Ponownie zatwierdź parowanie urządzenia.
- Ponownie otwórz aplikację węzła (na pierwszym planie).
- Ponownie przyznaj uprawnienia systemu operacyjnego.
- Odtwórz/dostosuj politykę zatwierdzeń exec.