openclaw nodes

Gestisci i nodi (dispositivi) associati e invoca le capacità dei nodi.

Correlati:

• Panoramica dei nodi: Nodi
• Fotocamera: Nodi fotocamera
• Immagini: Nodi immagine

Opzioni comuni:

• --url, --token, --timeout, --json

Comandi comuni

openclaw nodes listopenclaw nodes list --connectedopenclaw nodes list --last-connected 24hopenclaw 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>openclaw nodes statusopenclaw nodes status --connectedopenclaw nodes status --last-connected 24h

nodes list stampa tabelle dei nodi in sospeso/associati. Le righe associate includono l'età della connessione più recente (Ultima connessione). Usa --connected per mostrare solo i nodi attualmente connessi. Usa --last-connected <duration> per filtrare i nodi che si sono connessi entro una durata (ad es. 24h, 7d). Usa nodes remove --node <id|name|ip> per rimuovere l'associazione di un nodo. Per un nodo supportato da dispositivo, questo revoca il ruolo node del dispositivo in devices/paired.json e disconnette le sue sessioni con ruolo di nodo (un dispositivo con ruoli misti mantiene la sua riga e perde solo il ruolo node; un dispositivo solo nodo viene eliminato); cancella inoltre qualsiasi record di associazione nodo legacy corrispondente di proprietà del gateway. operator.pairing può rimuovere righe nodo non operatore; un chiamante con token dispositivo che revoca il proprio ruolo nodo su un dispositivo con ruoli misti necessita inoltre di operator.admin.

Nota sull'approvazione:

• openclaw nodes pending richiede solo l'ambito di associazione.
• gateway.nodes.pairing.autoApproveCidrs può saltare il passaggio in sospeso solo per associazioni di dispositivi role: node esplicitamente attendibili e al primo utilizzo. È disattivato per impostazione predefinita e non approva gli upgrade.
• openclaw nodes approve <requestId> eredita requisiti di ambito aggiuntivi dalla richiesta in sospeso:
  • richiesta senza comando: solo associazione
  • comandi nodo non exec: associazione + scrittura
  • system.run / system.run.prepare / system.which: associazione + amministrazione

Invocazione

openclaw nodes invoke --node <id|name|ip> --command <command> --params <json>

Flag di invocazione:

• --params <json>: stringa oggetto JSON (predefinito {}).
• --invoke-timeout <ms>: timeout di invocazione del nodo (predefinito 15000).
• --idempotency-key <key>: chiave di idempotenza facoltativa.
• system.run e system.run.prepare sono bloccati qui; usa lo strumento exec con host=node per l'esecuzione shell.

Per l'esecuzione shell su un nodo, usa lo strumento exec con host=node invece di openclaw nodes run. La CLI nodes ora è focalizzata sulle capacità: RPC diretta tramite nodes invoke, più associazione, fotocamera, schermo, posizione, Canvas e notifiche. I comandi Canvas sono implementati dal Plugin Canvas sperimentale incluso; il core mantiene un hook di compatibilità affinché rimangano sotto openclaw nodes canvas.

Correlati

• Riferimento CLI
• Nodi