openclaw nodes

Gestiona los nodos (dispositivos) emparejados e invoca sus capacidades.

Relacionado: Descripción general de los nodos - Presencia activa en el equipo - Nodos de cámara - Nodos de imagen

Opciones comunes en todos los subcomandos: --url <url>, --token <token>, --timeout <ms> (valor predeterminado: 10000), --json.

Estado

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

Tanto status como list aceptan --connected (solo nodos conectados) y --last-connected <duration> (p. ej., 24h, 7d; solo nodos que se hayan conectado dentro de ese período). list muestra los nodos pendientes y emparejados en tablas separadas; las filas de los emparejados incluyen el tiempo transcurrido desde la conexión más reciente (Last Connect). status muestra una única tabla combinada con detalles de las capacidades, la versión y la última entrada de cada nodo. Un nodo macOS conectado informa de la última entrada únicamente mientras se haya concedido el permiso de Accesibilidad, y la fila más reciente se marca como active; consulta Presencia activa en el equipo. describe muestra las capacidades, los permisos, la actividad y los comandos de invocación efectivos o pendientes de un nodo.

Emparejamiento

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>

Estos comandos controlan el almacén node.pair.*, propiedad del Gateway, que es independiente del emparejamiento de dispositivos (openclaw devices approve) que controla el protocolo de enlace connect de WS del nodo. Consulta Nodos para conocer la relación entre ambos.

• remove revoca la entrada de rol emparejado del nodo. En un nodo respaldado por un dispositivo, esto revoca el rol node en el almacén de emparejamiento de dispositivos y desconecta sus sesiones con rol de nodo: un dispositivo con varios roles conserva su fila y solo pierde el rol node; la fila de un dispositivo que solo tiene el rol de nodo se elimina. También borra cualquier registro de emparejamiento de nodo heredado coincidente propiedad del Gateway.
• pending solo necesita el ámbito operator.pairing.
• gateway.nodes.pairing.autoApproveCidrs puede omitir el paso pendiente para el primer emparejamiento de un dispositivo role: node que sea de confianza explícita. Está desactivado de forma predeterminada y no aprueba ampliaciones de roles.
• gateway.nodes.pairing.sshVerify (activado de forma predeterminada) aprueba automáticamente el primer emparejamiento de un dispositivo role: node cuando el Gateway puede verificar la clave del dispositivo mediante SSH en el host del nodo; la primera superficie de capacidades se aprueba en el mismo paso. Consulta Emparejamiento de nodos.
• Los requisitos de ámbito de approve dependen de los comandos declarados en la solicitud pendiente:
  • solicitud sin comandos: operator.pairing
  • comandos de nodo ordinarios: operator.pairing + operator.write
  • comandos que requieren privilegios administrativos (system.run, system.run.prepare, system.which, browser.proxy, fs.listDir y system.execApprovals.get/set): operator.pairing + operator.admin
• Ámbito de remove: operator.pairing puede eliminar filas de nodos que no sean de operadores; un llamador que use un token de dispositivo para revocar su propio rol de nodo en un dispositivo con varios roles necesita además operator.admin.

Invocación

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

Opciones:

• --command <command> (obligatoria): p. ej., canvas.eval.
• --params <json>: cadena de objeto JSON (valor predeterminado: {}).
• --invoke-timeout <ms>: tiempo de espera de invocación del nodo (valor predeterminado: 15000).
• --idempotency-key <key>: clave de idempotencia opcional.

system.run y system.run.prepare están bloqueados aquí; para ejecutar comandos del shell, utiliza en su lugar la herramienta exec con host=node. system.which se permite mediante invoke.

Notificaciones, envío, ubicación y pantalla

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 envía una notificación local a un nodo que declare system.notify, incluidos los nodos macOS, iOS, Android y watchOS directos. La entrega directa en watchOS requiere que OpenClaw esté activo. Requiere --title o --body. Opciones: --sound <name>, --priority <passive|active|timeSensitive>, --delivery <system|overlay|auto> (valor predeterminado: system), --invoke-timeout <ms> (valor predeterminado: 15000).
• push envía una notificación push de prueba de APNs a un nodo iOS. Opciones: --title <text> (valor predeterminado: OpenClaw), --body <text>, --environment <sandbox|production> para sustituir el entorno de APNs detectado.
• location get obtiene la ubicación actual del nodo. Opciones: --max-age <ms> (reutiliza una ubicación almacenada en caché), --accuracy <coarse|balanced|precise>, --location-timeout <ms> (valor predeterminado: 10000), --invoke-timeout <ms> (valor predeterminado: 20000).
• screen record captura un clip breve y muestra la ruta donde se ha guardado (o escribe JSON con --json). Opciones: --screen <index> (valor predeterminado: 0), --duration <ms|10s> (valor predeterminado: 10000), --fps <fps> (valor predeterminado: 10), --no-audio, --out <path>, --invoke-timeout <ms> (valor predeterminado: 120000).

Los comandos de Cámara y Canvas tienen su propia documentación: Nodos de cámara, Canvas. Canvas se implementa mediante el Plugin experimental de Canvas incluido; el núcleo conserva openclaw nodes canvas como punto de montaje de compatibilidad.

Contenido relacionado

• Referencia de la CLI
• Nodos