Gebruik deze pagina wanneer een Node zichtbaar is in status, maar Node-tools falen.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.
Commandoladder
- Node is verbonden en gekoppeld voor rol
node. nodes describebevat de mogelijkheid die je aanroept.- Uitvoeringsgoedkeuringen tonen de verwachte modus/toelatingslijst.
Voorgrondvereisten
canvas.*, camera.* en screen.* werken alleen op de voorgrond op iOS-/Android-Nodes.
Snelle controle en oplossing:
NODE_BACKGROUND_UNAVAILABLE ziet, breng je de Node-app naar de voorgrond en probeer je het opnieuw.
Machtigingenmatrix
| Mogelijkheid | iOS | Android | macOS-Node-app | Typische foutcode |
|---|---|---|---|---|
camera.snap, camera.clip | Camera (+ microfoon voor clipaudio) | Camera (+ microfoon voor clipaudio) | Camera (+ microfoon voor clipaudio) | *_PERMISSION_REQUIRED |
screen.record | Schermopname (+ microfoon optioneel) | Prompt voor schermopname (+ microfoon optioneel) | Schermopname | *_PERMISSION_REQUIRED |
location.get | Tijdens gebruik of altijd (afhankelijk van modus) | Voorgrond-/achtergrondlocatie op basis van de modus | Locatiemachtiging | LOCATION_PERMISSION_REQUIRED |
system.run | n.v.t. (Node-hostpad) | n.v.t. (Node-hostpad) | Uitvoeringsgoedkeuringen vereist | SYSTEM_RUN_DENIED |
Koppeling versus goedkeuringen
Dit zijn verschillende poorten:- Apparaatkoppeling: kan deze Node verbinding maken met de Gateway?
- Gateway-Node-commandobeleid: is de RPC-commando-ID toegestaan door
gateway.nodes.allowCommands/denyCommandsen platformstandaarden? - Uitvoeringsgoedkeuringen: kan deze Node lokaal een specifieke shellopdracht uitvoeren?
nodes describe een commando mist, controleer dan het Gateway-Node-commandobeleid en of de Node dat commando daadwerkelijk heeft gedeclareerd bij het verbinden.
Als koppeling in orde is maar system.run faalt, herstel dan de uitvoeringsgoedkeuringen/toelatingslijst op die Node.
Node-koppeling is een identiteits-/vertrouwenspoort, geen goedkeuringsoppervlak per commando. Voor system.run bevindt het beleid per Node zich in het bestand met uitvoeringsgoedkeuringen van die Node (openclaw approvals get --node ...), niet in de Gateway-koppelingsrecord.
Voor goedkeuringsgedekte host=node-runs bindt de Gateway de uitvoering ook aan het
voorbereide canonieke systemRunPlan. Als een latere aanroeper commando/cwd of
sessiemetadata wijzigt voordat de goedgekeurde run wordt doorgestuurd, weigert de Gateway de
run als een goedkeuringsmismatch in plaats van de bewerkte payload te vertrouwen.
Veelvoorkomende Node-foutcodes
NODE_BACKGROUND_UNAVAILABLE→ app draait op de achtergrond; breng deze naar de voorgrond.CAMERA_DISABLED→ cameraschakelaar uitgeschakeld in Node-instellingen.*_PERMISSION_REQUIRED→ OS-machtiging ontbreekt/geweigerd.LOCATION_DISABLED→ locatiemodus staat uit.LOCATION_PERMISSION_REQUIRED→ aangevraagde locatiemodus niet verleend.LOCATION_BACKGROUND_UNAVAILABLE→ app draait op de achtergrond, maar alleen machtiging Tijdens gebruik bestaat.SYSTEM_RUN_DENIED: approval required→ uitvoeringsverzoek heeft expliciete goedkeuring nodig.SYSTEM_RUN_DENIED: allowlist miss→ commando geblokkeerd door toelatingslijstmodus. Op Windows-Node-hosts worden shell-wrappervormen zoalscmd.exe /c ...behandeld als toelatingslijstmissers in toelatingslijstmodus, tenzij ze via de vraagflow zijn goedgekeurd.
Snelle herstellus
- Keur de apparaatkoppeling opnieuw goed.
- Open de Node-app opnieuw (voorgrond).
- Verleen OS-machtigingen opnieuw.
- Maak het uitvoeringsgoedkeuringsbeleid opnieuw aan of pas het aan.