Hoppa till huvudinnehåll

​
Felsökning av noder

Använd den här sidan när en nod är synlig i status men nodverktyg misslyckas.

​
Kommandostege

openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor
openclaw channels status --probe
Kör sedan nodspecifika kontroller: 
openclaw nodes status
openclaw nodes describe --node <idOrNameOrIp>
openclaw approvals get --node <idOrNameOrIp>
Friska signaler:
  • Noden är ansluten och parad för rollen node.
  • nodes describe inkluderar den kapacitet du anropar.
  • Exec-godkännanden visar förväntat läge/tillåtelselista.

​
Förgrundskrav

canvas.*, camera.* och screen.* är endast tillgängliga i förgrunden på iOS-/Android-noder. Snabb kontroll och åtgärd: 
openclaw nodes describe --node <idOrNameOrIp>
openclaw nodes canvas snapshot --node <idOrNameOrIp>
openclaw logs --follow
Om du ser NODE_BACKGROUND_UNAVAILABLE, ta fram nodappen i förgrunden och försök igen.

​
Behörighetsmatris

KapacitetiOSAndroidmacOS-nodappTypisk felkod
camera.snap, camera.clipKamera (+ mikrofon för klippljud)Kamera (+ mikrofon för klippljud)Kamera (+ mikrofon för klippljud)*_PERMISSION_REQUIRED
screen.recordSkärminspelning (+ mikrofon valfri)Skärminspelningsprompt (+ mikrofon valfri)Skärminspelning*_PERMISSION_REQUIRED
location.getVid användning eller Alltid (beror på läge)Förgrunds-/bakgrundsplats baserat på lägePlatsbehörighetLOCATION_PERMISSION_REQUIRED
system.runn/a (nodvärdsökväg)n/a (nodvärdsökväg)Exec-godkännanden krävsSYSTEM_RUN_DENIED

​
Parning kontra godkännanden

Detta är olika grindar:
  1. Enhetsparning: kan denna nod ansluta till gatewayn?
  2. Exec-godkännanden: kan denna nod köra ett specifikt skalkommando?
Snabba kontroller: 
openclaw devices list
openclaw nodes status
openclaw approvals get --node <idOrNameOrIp>
openclaw approvals allowlist add --node <idOrNameOrIp> "/usr/bin/uname"
Om parkoppling saknas, godkänn nodenheten först. Om parning är bra men system.run misslyckas, åtgärda exec godkännanden/tillåtna lista.

​
Vanliga nodfelkoder

  • NODE_BACKGROUND_UNAVAILABLE → appen är i bakgrunden; ta den till förgrunden.
  • CAMERA_DISABLED → kameraväxeln är inaktiverad i nodinställningarna.
  • *_PERMISSION_REQUIRED → OS-behörighet saknas/nekad.
  • LOCATION_DISABLED → platsläge är avstängt.
  • LOCATION_PERMISSION_REQUIRED → begärt platsläge är inte beviljat.
  • LOCATION_BACKGROUND_UNAVAILABLE → appen är i bakgrunden men endast behörigheten ”Vid användning” finns.
  • SYSTEM_RUN_DENIED: approval required → exec-begäran kräver uttryckligt godkännande.
  • SYSTEM_RUN_DENIED: allowlist miss → kommandot blockeras av tillåtelselistan.

​
Snabb återställningsloop

openclaw nodes status
openclaw nodes describe --node <idOrNameOrIp>
openclaw approvals get --node <idOrNameOrIp>
openclaw logs --follow
Om du fortfarande sitter fast:
  • Godkänn enhetsparning på nytt.
  • Öppna nodappen igen (förgrunden).
  • Bevilja OS-behörigheter på nytt.
  • Skapa om/justera policyn för exec-godkännanden.
Relaterat: