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 à chaque sous-commande : --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 au cours de cette durée). list affiche les Nodes en attente et appairés dans des tableaux distincts, les lignes des Nodes appairés indiquant le temps écoulé depuis la connexion la plus récente (Last Connect) ; status affiche un tableau fusionné comprenant les capacités, la version et les détails de la dernière entrée de chaque Node. Un Node macOS connecté ne signale la dernière entrée que lorsque l’autorisation Accessibilité est accordée, et la ligne la plus récente est marquée 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 pilotent le stockage node.pair.* détenu par le Gateway, distinct de l’appairage des appareils (openclaw devices approve) qui contrôle la négociation connect du WS du Node. Consultez Nodes pour comprendre la relation entre les deux.

• remove révoque l’entrée de rôle appairé du Node. Pour un Node associé à un appareil, cette opération révoque le rôle node dans le stockage d’appairage des appareils et déconnecte ses sessions ayant le 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 de mise en attente pour l’appairage initial d’un appareil 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 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 au cours de la même étape. Consultez Appairage des Nodes.
• Les exigences de portée de approve dépendent des commandes déclarées par la demande en attente :
  • demande sans commande : operator.pairing
  • commandes ordinaires de Node : operator.pairing + operator.write
  • commandes sensibles réservées à l’administration (system.run, system.run.prepare, system.which, browser.proxy, fs.listDir et system.execApprovals.get/set) : operator.pairing + operator.admin
• Portée de remove : operator.pairing peut supprimer les lignes de Nodes sans rôle d’opérateur ; l’appelant utilisant un jeton d’appareil qui révoque son propre rôle Node sur un appareil à rôles multiples a également besoin 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é par l’intermédiaire de 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 remise 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 une courte séquence et affiche le chemin d’enregistrement (ou écrit 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 de caméra et de Canvas disposent de leur propre documentation : Nodes de caméra, Canvas. Canvas est implémenté par le Plugin Canvas expérimental fourni ; le cœur conserve openclaw nodes canvas comme point de montage de compatibilité.

Voir aussi

• Référence de la CLI
• Nodes