Utilisez cette page lorsqu’un nœud est visible dans le statut, mais que les outils du nœud échouent.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.
Échelle de commandes
- Le nœud est connecté et appairé pour le rôle
node. nodes describeinclut la capacité que vous appelez.- Les approbations d’exécution affichent le mode/la liste d’autorisation attendus.
Exigences de premier plan
canvas.*, camera.* et screen.* nécessitent le premier plan sur les nœuds iOS/Android.
Vérification et correction rapides :
NODE_BACKGROUND_UNAVAILABLE, placez l’application du nœud au premier plan et réessayez.
Matrice des autorisations
| Capacité | iOS | Android | Application de nœud macOS | Code d’échec typique |
|---|---|---|---|---|
camera.snap, camera.clip | Caméra (+ micro pour l’audio du clip) | Caméra (+ micro pour l’audio du clip) | Caméra (+ micro pour l’audio du clip) | *_PERMISSION_REQUIRED |
screen.record | Enregistrement de l’écran (+ micro facultatif) | Invite de capture d’écran (+ micro facultatif) | Enregistrement de l’écran | *_PERMISSION_REQUIRED |
location.get | Lors de l’utilisation ou Toujours (selon le mode) | Position au premier plan/en arrière-plan selon le mode | Autorisation de localisation | LOCATION_PERMISSION_REQUIRED |
system.run | n/a (chemin de l’hôte du nœud) | n/a (chemin de l’hôte du nœud) | Approbations d’exécution requises | SYSTEM_RUN_DENIED |
Appairage versus approbations
Ce sont des barrières différentes :- Appairage de l’appareil : ce nœud peut-il se connecter au Gateway ?
- Politique de commande des nœuds du Gateway : l’ID de commande RPC est-il autorisé par
gateway.nodes.allowCommands/denyCommandset les valeurs par défaut de la plateforme ? - Approbations d’exécution : ce nœud peut-il exécuter localement une commande shell spécifique ?
nodes describe ne contient pas une commande, vérifiez la politique de commande des nœuds du Gateway et si le nœud a réellement déclaré cette commande lors de la connexion.
Si l’appairage est correct, mais que system.run échoue, corrigez les approbations d’exécution/la liste d’autorisation sur ce nœud.
L’appairage des nœuds est une barrière d’identité/de confiance, pas une surface d’approbation par commande. Pour system.run, la politique par nœud se trouve dans le fichier d’approbations d’exécution de ce nœud (openclaw approvals get --node ...), pas dans l’enregistrement d’appairage du Gateway.
Pour les exécutions host=node adossées à une approbation, le Gateway lie aussi l’exécution au
systemRunPlan canonique préparé. Si un appelant ultérieur modifie la commande/le cwd ou les
métadonnées de session avant que l’exécution approuvée soit transférée, le Gateway rejette
l’exécution comme non-concordance d’approbation au lieu de faire confiance à la charge utile modifiée.
Codes d’erreur courants des nœuds
NODE_BACKGROUND_UNAVAILABLE→ l’application est en arrière-plan ; ramenez-la au premier plan.CAMERA_DISABLED→ le bouton caméra est désactivé dans les paramètres du nœud.*_PERMISSION_REQUIRED→ autorisation du système d’exploitation manquante/refusée.LOCATION_DISABLED→ le mode de localisation est désactivé.LOCATION_PERMISSION_REQUIRED→ le mode de localisation demandé n’a pas été accordé.LOCATION_BACKGROUND_UNAVAILABLE→ l’application est en arrière-plan, mais seule l’autorisation Lors de l’utilisation existe.SYSTEM_RUN_DENIED: approval required→ la demande d’exécution nécessite une approbation explicite.SYSTEM_RUN_DENIED: allowlist miss→ commande bloquée par le mode liste d’autorisation. Sur les hôtes de nœud Windows, les formes d’enveloppe shell commecmd.exe /c ...sont traitées comme des absences de liste d’autorisation en mode liste d’autorisation, sauf si elles sont approuvées via le flux de demande.
Boucle de récupération rapide
- Réapprouvez l’appairage de l’appareil.
- Rouvrez l’application du nœud (premier plan).
- Réaccordez les autorisations du système d’exploitation.
- Recréez/ajustez la politique d’approbation d’exécution.