openclaw nodes

Gérez les Nodes appairés (appareils) et invoquez leurs capacités.

Voir aussi : Présentation des Nodes - Présence active de l’ordinateur - Nodes de caméra - Nodes d’image

Options communes à toutes les sous-commandes : --url <url>, --token <token>, --timeout <ms> (valeur par défaut : 10000), --json.

État

openclaw nodes statusopenclaw nodes status --connectedopenclaw nodes status --last-connected 24hopenclaw nodes listopenclaw nodes describe --node <idOrNameOrIp>

status et list acceptent tous deux --connected (uniquement les Nodes connectés) et --last-connected <duration> (par exemple 24h, 7d ; uniquement les Nodes qui se sont connectés pendant cette durée). list affiche les Nodes en attente et appairés dans des tableaux distincts, les lignes appairées indiquant l’ancienneté de la connexion la plus récente (Last Connect) ; status affiche un tableau fusionné avec, pour chaque Node, ses capacités, sa version et les détails de la dernière saisie. Un Node macOS connecté ne signale la dernière saisie que lorsque l’autorisation Accessibilité est accordée, et la ligne la plus récente porte la mention active ; consultez Présence active de l’ordinateur. describe affiche les capacités, les autorisations, l’activité et les commandes d’invocation effectives ou en attente d’un Node.

Appairage

openclaw nodes pendingopenclaw nodes approve <requestId>openclaw nodes reject <requestId>openclaw nodes remove --node <id|name|ip>openclaw nodes rename --node <id|name|ip> --name <displayName>

Ces commandes gèrent le stockage node.pair.* détenu par le Gateway, distinct de l’appairage des appareils (openclaw devices approve) qui contrôle la négociation WS connect du Node. Consultez Nodes pour comprendre leur relation.

• remove révoque l’entrée de rôle appairé du Node. Pour un Node associé à un appareil, cette commande révoque le rôle node dans le stockage d’appairage des appareils et déconnecte ses sessions dotées du rôle Node : un appareil à rôles multiples conserve sa ligne et perd uniquement le rôle node, tandis que la ligne d’un appareil ayant uniquement le rôle Node est supprimée. Elle efface également tout enregistrement d’appairage de Node hérité correspondant détenu par le Gateway.
• pending nécessite uniquement la portée operator.pairing.
• gateway.nodes.pairing.autoApproveCidrs peut ignorer l’étape d’attente pour l’appairage initial d’un appareil avec role: node explicitement approuvé. Désactivé par défaut ; n’approuve pas les élévations de rôle.
• gateway.nodes.pairing.sshVerify (activé par défaut) approuve automatiquement l’appairage initial d’un appareil avec role: node lorsque le Gateway peut vérifier la clé de l’appareil par SSH auprès de l’hôte du Node ; la première surface de capacités est approuvée lors de la même étape. Consultez Appairage d’un Node.
• Les portées requises par approve dépendent des commandes déclarées par la demande en attente :
  • demande sans commande : operator.pairing
  • commandes de Node sans exécution : operator.pairing + operator.write
  • system.run / system.run.prepare / system.which : operator.pairing + operator.admin
• Portée de remove : operator.pairing permet de supprimer les lignes de Node non-opérateur ; un appelant utilisant un jeton d’appareil qui révoque son propre rôle Node sur un appareil à rôles multiples doit en outre disposer de operator.admin.

Invocation

openclaw nodes invoke --node <id> --command system.which --params '{"bins":["uname"]}'

Options :

• --command <command> (obligatoire) : par exemple canvas.eval.
• --params <json> : chaîne représentant un objet JSON (valeur par défaut : {}).
• --invoke-timeout <ms> : délai d’expiration de l’invocation du Node (valeur par défaut : 15000).
• --idempotency-key <key> : clé d’idempotence facultative.

system.run et system.run.prepare sont bloqués ici ; utilisez plutôt l’outil exec avec host=node pour exécuter des commandes shell. system.which est autorisé via invoke.

Notification, push, localisation et écran

openclaw nodes notify --node <id> --title "Build" --body "Done" --priority timeSensitiveopenclaw nodes push --node <id> --title "OpenClaw" --environment sandboxopenclaw nodes location get --node <id> --accuracy preciseopenclaw nodes screen record --node <id> --duration 10s --fps 10 --out ./clip.mp4

• notify envoie une notification locale sur un Node qui déclare system.notify, notamment les Nodes macOS, iOS, Android et watchOS directs. La distribution directe sur watchOS exige qu’OpenClaw soit actif. Nécessite --title ou --body. Options : --sound <name>, --priority <passive|active|timeSensitive>, --delivery <system|overlay|auto> (valeur par défaut : system), --invoke-timeout <ms> (valeur par défaut : 15000).
• push envoie une notification push de test APNs à un Node iOS. Options : --title <text> (valeur par défaut : OpenClaw), --body <text>, --environment <sandbox|production> pour remplacer l’environnement APNs détecté.
• location get récupère la position actuelle du Node. Options : --max-age <ms> (réutiliser une position mise en cache), --accuracy <coarse|balanced|precise>, --location-timeout <ms> (valeur par défaut : 10000), --invoke-timeout <ms> (valeur par défaut : 20000).
• screen record capture un court extrait et affiche le chemin d’enregistrement (ou produit du JSON avec --json). Options : --screen <index> (valeur par défaut : 0), --duration <ms|10s> (valeur par défaut : 10000), --fps <fps> (valeur par défaut : 10), --no-audio, --out <path>, --invoke-timeout <ms> (valeur par défaut : 120000).

Les commandes Camera et Canvas disposent de leur propre documentation : Nodes de caméra, Canvas. Canvas est implémenté par le Plugin Canvas expérimental intégré ; le cœur conserve openclaw nodes canvas comme point de montage de compatibilité.

Voir aussi

• Référence de la CLI
• Nodes