Gebruik deze pagina wanneer een Node zichtbaar is in de status, maar Node-tools falen.Documentation Index
Fetch the complete documentation index at: https://docs2.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 capability die je aanroept.- Exec-goedkeuringen tonen de verwachte modus/allowlist.
Vereisten voor de voorgrond
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
| Capability | 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 | Bij gebruik of Altijd (hangt af van de modus) | Voorgrond-/achtergrondlocatie op basis van de modus | Locatiemachtiging | LOCATION_PERMISSION_REQUIRED |
system.run | n.v.t. (hostpad van Node) | n.v.t. (hostpad van Node) | Exec-goedkeuringen vereist | SYSTEM_RUN_DENIED |
Koppeling versus goedkeuringen
Dit zijn verschillende poorten:- Apparaatkoppeling: kan deze Node verbinding maken met de Gateway?
- Gateway-Node-opdrachtbeleid: is de RPC-opdracht-ID toegestaan door
gateway.nodes.allowCommands/denyCommandsen platformstandaarden? - Exec-goedkeuringen: kan deze Node lokaal een specifieke shellopdracht uitvoeren?
nodes describe een opdracht ontbreekt, controleer dan het Gateway-Node-opdrachtbeleid en of de Node die opdracht daadwerkelijk heeft gedeclareerd bij het verbinden.
Als koppeling in orde is maar system.run faalt, herstel dan de exec-goedkeuringen/allowlist op die Node.
Node-koppeling is een identiteits-/vertrouwenspoort, geen goedkeuringsoppervlak per opdracht. Voor system.run bevindt het beleid per Node zich in het exec-goedkeuringsbestand van die Node (openclaw approvals get --node ...), niet in de Gateway-koppelingsrecord.
Voor door goedkeuring ondersteunde host=node-runs bindt de Gateway de uitvoering ook aan het
voorbereide canonieke systemRunPlan. Als een latere aanroeper opdracht/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 is uitgeschakeld.LOCATION_PERMISSION_REQUIRED→ aangevraagde locatiemodus is niet verleend.LOCATION_BACKGROUND_UNAVAILABLE→ app draait op de achtergrond, maar er bestaat alleen machtiging Bij gebruik.SYSTEM_RUN_DENIED: approval required→ exec-aanvraag vereist expliciete goedkeuring.SYSTEM_RUN_DENIED: allowlist miss→ opdracht geblokkeerd door allowlist-modus. Op Windows-Node-hosts worden shell-wrappervormen zoalscmd.exe /c ...in allowlist-modus behandeld als allowlist-misses, tenzij ze via de vraagflow zijn goedgekeurd.
Snelle herstellus
- Keur apparaatkoppeling opnieuw goed.
- Open de Node-app opnieuw (voorgrond).
- Verleen OS-machtigingen opnieuw.
- Maak het exec-goedkeuringsbeleid opnieuw aan of pas het aan.