openclaw nodes

Gestiona Nodes emparejados (dispositivos) e invoca capacidades de Node.

Relacionado:

• Descripción general de Nodes: Nodes
• Cámara: Nodes de cámara
• Imágenes: Nodes de imagen

Opciones comunes:

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

Comandos comunes

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 imprime tablas de solicitudes pendientes y emparejadas. Las filas emparejadas incluyen la antigüedad de la conexión más reciente (Última conexión). Usa --connected para mostrar solo los Nodes conectados actualmente. Usa --last-connected <duration> para filtrar a los Nodes que se conectaron dentro de una duración (por ejemplo, 24h, 7d). Usa nodes remove --node <id|name|ip> para eliminar un emparejamiento de Node. Para un Node respaldado por un dispositivo, esto revoca el rol node del dispositivo en devices/paired.json y desconecta sus sesiones con rol de Node (un dispositivo con roles mixtos conserva su fila y solo pierde el rol node; un dispositivo solo de Node se elimina); también borra cualquier registro de emparejamiento de Node heredado y propiedad del Gateway que coincida. operator.pairing puede eliminar filas de Node no operadoras; un llamador con token de dispositivo que revoca su propio rol de Node en un dispositivo con roles mixtos necesita además operator.admin.

Nota de aprobación:

• openclaw nodes pending solo necesita ámbito de emparejamiento.
• gateway.nodes.pairing.autoApproveCidrs puede omitir el paso pendiente solo para emparejamientos de dispositivo role: node explícitamente confiables y de primera vez. Está desactivado de forma predeterminada y no aprueba actualizaciones.
• openclaw nodes approve <requestId> hereda requisitos de ámbito adicionales de la solicitud pendiente:
  • solicitud sin comando: solo emparejamiento
  • comandos de Node que no son exec: emparejamiento + escritura
  • system.run / system.run.prepare / system.which: emparejamiento + administrador

Invocar

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

Opciones de invocación:

• --params <json>: cadena de objeto JSON (predeterminado {}).
• --invoke-timeout <ms>: tiempo de espera de invocación de Node (predeterminado 15000).
• --idempotency-key <key>: clave de idempotencia opcional.
• system.run y system.run.prepare están bloqueados aquí; usa la herramienta exec con host=node para la ejecución de shell.

Para la ejecución de shell en un Node, usa la herramienta exec con host=node en lugar de openclaw nodes run. La CLI de nodes ahora se centra en capacidades: RPC directo mediante nodes invoke, además de emparejamiento, cámara, pantalla, ubicación, Canvas y notificaciones. Los comandos de Canvas los implementa el Plugin experimental de Canvas incluido; el núcleo conserva un enlace de compatibilidad para que sigan estando bajo openclaw nodes canvas.

Relacionado

• Referencia de la CLI
• Nodes