Nodes and media
Probleemoplossing voor Node
Gebruik deze pagina wanneer een Node zichtbaar is in de status, maar Node-tools niet werken.
Opdrachtvolgorde
openclaw statusopenclaw gateway statusopenclaw logs --followopenclaw doctoropenclaw channels status --probeVoer daarna Node-specifieke controles uit:
openclaw nodes statusopenclaw nodes describe --node <idOrNameOrIp>openclaw approvals get --node <idOrNameOrIp>Signalen dat alles goed werkt:
- De Node is verbonden en gekoppeld voor de rol
node. nodes describebevat de aangeroepen mogelijkheid.- Uitvoeringsgoedkeuringen tonen de verwachte modus/toelatingslijst.
Vereisten voor de voorgrond
canvas.*, camera.* en screen.* werken op iOS-/Android-Nodes alleen op de voorgrond.
Snelle controle en oplossing:
openclaw nodes describe --node <idOrNameOrIp>openclaw nodes canvas snapshot --node <idOrNameOrIp>openclaw logs --followAls je NODE_BACKGROUND_UNAVAILABLE ziet, breng je de Node-app naar de voorgrond en probeer je het opnieuw.
Machtigingenmatrix
| Mogelijkheid | iOS | Android | macOS-Node-app | Gebruikelijke foutcode |
|---|---|---|---|---|
camera.snap, camera.clip |
Camera (+ microfoon voor clipaudio) | Camera (+ microfoon voor clipaudio) | Camera (+ microfoon voor clipaudio) | *_PERMISSION_REQUIRED |
screen.record |
Screen Recording (+ microfoon optioneel) | Prompt voor schermopname (+ microfoon optioneel) | Screen Recording | *_PERMISSION_REQUIRED |
computer.act |
n.v.t. | n.v.t. | Accessibility + Screen Recording | COMPUTER_DISABLED, ACCESSIBILITY_REQUIRED |
location.get |
While Using of Always (afhankelijk van de modus) | Voorgrond-/achtergrondlocatie op basis van de modus | Locatiemachtiging | LOCATION_PERMISSION_REQUIRED |
system.run |
n.v.t. (pad van Node-host) | n.v.t. (pad van Node-host) | Uitvoeringsgoedkeuringen vereist | SYSTEM_RUN_DENIED |
Koppeling versus goedkeuringen
Drie afzonderlijke poorten bepalen of een Node-opdracht slaagt:
- Apparaatkoppeling: kan deze Node verbinding maken met de Gateway?
- Beleid voor Gateway-Node-opdrachten: is de RPC-opdracht-ID toegestaan door
gateway.nodes.commands.allow/gateway.nodes.commands.denyen de platformstandaarden? - Uitvoeringsgoedkeuringen: kan deze Node lokaal een specifieke shellopdracht uitvoeren?
Node-koppeling is een poort voor identiteit en vertrouwen, geen goedkeuringsoppervlak per opdracht. Voor system.run bevindt het beleid per Node zich in het bestand met uitvoeringsgoedkeuringen van die Node (openclaw approvals get --node ...), niet in de koppelingsregistratie van de Gateway.
Snelle controles:
openclaw devices listopenclaw nodes statusopenclaw approvals get --node <idOrNameOrIp>openclaw approvals allowlist add --node <idOrNameOrIp> "/usr/bin/uname"- Koppeling ontbreekt: keur eerst het Node-apparaat goed.
nodes describemist een opdracht: controleer het beleid voor Gateway-Node-opdrachten en of de Node die opdracht bij het verbinden daadwerkelijk heeft gedeclareerd.- Koppeling is in orde, maar
system.runmislukt: herstel de uitvoeringsgoedkeuringen/toelatingslijst op die Node.
Voor door goedkeuring ondersteunde uitvoeringen van host=node koppelt de Gateway de uitvoering ook aan de voorbereide canonieke systemRunPlan. Als een latere aanroeper de opdracht, werkmap of sessiemetadata wijzigt voordat de goedgekeurde uitvoering wordt doorgestuurd, weigert de Gateway de uitvoering wegens een niet-overeenkomende goedkeuring in plaats van de bewerkte payload te vertrouwen.
Veelvoorkomende Node-foutcodes
| Code | Betekenis |
|---|---|
NODE_BACKGROUND_UNAVAILABLE |
De app bevindt zich op de achtergrond; breng deze naar de voorgrond. |
CAMERA_DISABLED |
De cameraschakelaar is uitgeschakeld in de Node-instellingen. |
*_PERMISSION_REQUIRED |
OS-machtiging ontbreekt of is geweigerd. |
LOCATION_DISABLED |
De locatiemodus is uitgeschakeld. |
LOCATION_PERMISSION_REQUIRED |
De aangevraagde locatiemodus is niet toegestaan. |
LOCATION_BACKGROUND_UNAVAILABLE |
De app bevindt zich op de achtergrond, maar alleen de machtiging While Using is verleend. |
COMPUTER_DISABLED |
Schakel Allow Computer Control in de macOS-app in en keur daarna de bijgewerkte koppeling goed. |
ACCESSIBILITY_REQUIRED |
Verleen Accessibility aan de huidige OpenClaw-appbundel in macOS System Settings. |
SYSTEM_RUN_DENIED: approval required |
Het uitvoeringsverzoek vereist expliciete goedkeuring. |
SYSTEM_RUN_DENIED: allowlist miss |
De opdracht wordt geblokkeerd door de toelatingslijstmodus. Op Windows-Node-hosts worden shellwrappervormen zoals cmd.exe /c ... in de toelatingslijstmodus als ontbrekend in de toelatingslijst behandeld, tenzij ze via de vraagflow worden goedgekeurd. |
Snelle herstellus
openclaw nodes statusopenclaw nodes describe --node <idOrNameOrIp>openclaw approvals get --node <idOrNameOrIp>openclaw logs --followAls het probleem aanhoudt:
- Keur de apparaatkoppeling opnieuw goed.
- Open de Node-app opnieuw (op de voorgrond).
- Verleen de OS-machtigingen opnieuw.
- Maak het beleid voor uitvoeringsgoedkeuringen opnieuw of pas het aan.
Controleer voor computerbesturing ook of een agent met visiemogelijkheden de tool computer beschikbaar stelt, screen.snapshot slaagt met de machtiging Screen Recording en /phone status de bedoelde tijdelijke of permanente Gateway-autorisatie toont. Een vermelding van gateway.nodes.commands.deny heeft altijd voorrang op gateway.nodes.commands.allow.
