Skip to main content
Utilisez cette page lorsqu’un Node est visible dans l’état, mais que les outils du Node échouent.

​
Séquence de commandes

Exécutez ensuite les vérifications propres au Node :
Signes de bon fonctionnement :
  • Le Node est connecté et appairé pour le rôle node.
  • nodes describe inclut la fonctionnalité que vous appelez.
  • Les approbations d’exécution indiquent le mode et la liste d’autorisation attendus.

​
Exigences relatives au premier plan

canvas.*, camera.* et screen.* fonctionnent uniquement au premier plan sur les Nodes iOS/Android. Vérification et correction rapides :
Si vous voyez NODE_BACKGROUND_UNAVAILABLE, placez l’application du Node au premier plan et réessayez.

​
Matrice des autorisations

​
Appairage et approbations

Trois contrôles distincts déterminent si une commande de Node aboutit :
  1. Appairage de l’appareil : ce Node peut-il se connecter au Gateway ?
  2. Politique des commandes de Node du Gateway : l’identifiant de commande RPC est-il autorisé par gateway.nodes.allowCommands / denyCommands et par les valeurs par défaut de la plateforme ?
  3. Approbations d’exécution : ce Node peut-il exécuter localement une commande shell précise ?
L’appairage du Node est un contrôle d’identité et de confiance, pas une interface d’approbation par commande. Pour system.run, la politique propre au Node se trouve dans le fichier d’approbations d’exécution de ce Node (openclaw approvals get --node ...), et non dans l’enregistrement d’appairage du Gateway. Vérifications rapides :
  • Appairage manquant : approuvez d’abord l’appareil du Node.
  • Commande absente de nodes describe : vérifiez la politique des commandes de Node du Gateway et si le Node a effectivement déclaré cette commande lors de la connexion.
  • Appairage correct, mais échec de system.run : corrigez les approbations d’exécution ou la liste d’autorisation sur ce Node.
Pour les exécutions host=node soumises à approbation, le Gateway lie également l’exécution au systemRunPlan canonique préparé. Si un appelant ultérieur modifie la commande, le répertoire de travail ou les métadonnées de session avant la transmission de l’exécution approuvée, le Gateway rejette l’exécution en raison d’une non-correspondance avec l’approbation au lieu de faire confiance à la charge utile modifiée.

​
Codes d’erreur courants des Nodes

​
Boucle de récupération rapide

Si le problème persiste :
  • Réapprouvez l’appairage de l’appareil.
  • Rouvrez l’application du Node au premier plan.
  • Accordez de nouveau les autorisations du système d’exploitation.
  • Recréez ou ajustez la politique d’approbation des exécutions.
Pour le contrôle de l’ordinateur, vérifiez également qu’un agent doté de capacités de vision expose l’outil computer, que screen.snapshot aboutit avec l’autorisation Screen Recording et que /phone status affiche l’autorisation temporaire ou persistante du Gateway que vous souhaitiez. Une entrée gateway.nodes.denyCommands prévaut toujours sur allowCommands.

​
Voir aussi