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 vervolgens Node-specifieke controles uit:
openclaw nodes statusopenclaw nodes describe --node <idOrNameOrIp>openclaw approvals get --node <idOrNameOrIp>Signalen van een goede werking:
- De Node is verbonden en gekoppeld voor de rol
node. nodes describebevat de mogelijkheid die je aanroept.- Uitvoeringsgoedkeuringen tonen de verwachte modus/toestaanlijst.
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 audio bij een fragment) | Camera (+ microfoon voor audio bij een fragment) | Camera (+ microfoon voor fragmentaudio) | *_PERMISSION_REQUIRED |
screen.record |
Schermopname (+ microfoon optioneel) | Prompt voor schermopname (+ microfoon optioneel) | Schermopname | *_PERMISSION_REQUIRED |
computer.act |
n.v.t. | n.v.t. | Toegankelijkheid + schermopname | COMPUTER_DISABLED, ACCESSIBILITY_REQUIRED |
location.get |
Tijdens gebruik of altijd (afhankelijk van modus) | Locatie op voor-/achtergrond op basis van de modus | Locatiemachtiging | LOCATION_PERMISSION_REQUIRED |
system.run |
n.v.t. (pad op Node-host) | n.v.t. (pad op 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 Node-opdrachten van de Gateway: is de RPC-opdracht-ID toegestaan door
gateway.nodes.allowCommands/denyCommandsen de platformstandaarden? - Uitvoeringsgoedkeuringen: mag deze Node lokaal een specifieke shellopdracht uitvoeren?
Node-koppeling is een identiteits-/vertrouwenspoort, geen goedkeuringsmechanisme 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.
- Een opdracht ontbreekt in
nodes describe: controleer het beleid voor Node-opdrachten van de Gateway en of de Node die opdracht daadwerkelijk heeft gedeclareerd bij het verbinden. - De koppeling is in orde, maar
system.runmislukt: herstel de uitvoeringsgoedkeuringen/toestaanlijst op die Node.
Voor door goedkeuring ondersteunde uitvoeringen met host=node koppelt de Gateway de uitvoering ook aan het voorbereide, canonieke systemRunPlan. Als een latere aanroeper de opdracht, cwd of sessiemetadata wijzigt voordat de goedgekeurde uitvoering wordt doorgestuurd, wijst de Gateway de uitvoering af vanwege een niet-overeenkomende goedkeuring, in plaats van de bewerkte payload te vertrouwen.
Veelvoorkomende Node-foutcodes
| Code | Betekenis |
|---|---|
NODE_BACKGROUND_UNAVAILABLE |
De app draait 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 draait op de achtergrond, maar alleen machtiging voor gebruik op de voorgrond is verleend. |
COMPUTER_DISABLED |
Schakel Allow Computer Control in de macOS-app in en keur vervolgens de koppelingsupdate goed. |
ACCESSIBILITY_REQUIRED |
Verleen toegankelijkheid 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 is geblokkeerd door de toestaanlijstmodus. Op Windows-Node-hosts worden shell-wrappervormen zoals cmd.exe /c ... in de toestaanlijstmodus beschouwd als niet aanwezig in de toestaanlijst, tenzij ze via de vraagprocedure zijn goedgekeurd. |
Snelle herstelcyclus
openclaw nodes statusopenclaw nodes describe --node <idOrNameOrIp>openclaw approvals get --node <idOrNameOrIp>openclaw logs --followAls je nog steeds vastloopt:
- 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 beeldmogelijkheden de tool computer beschikbaar stelt, of screen.snapshot slaagt met machtiging voor schermopname en of /phone status de bedoelde tijdelijke of permanente autorisatie van de Gateway toont. Een vermelding in gateway.nodes.denyCommands heeft altijd voorrang op allowCommands.
