Saltar al contenido principal

​
openclaw nodes

Gestiona nodos emparejados (dispositivos) e invoca capacidades de nodo. Relacionado: Opciones comunes:
  • --url, --token, --timeout, --json

​
Comandos comunes

openclaw nodes list
openclaw nodes list --connected
openclaw nodes list --last-connected 24h
openclaw nodes pending
openclaw nodes approve <requestId>
openclaw nodes reject <requestId>
openclaw nodes rename --node <id|name|ip> --name <displayName>
openclaw nodes status
openclaw nodes status --connected
openclaw nodes status --last-connected 24h
nodes list imprime tablas de nodos pendientes y emparejados. Las filas emparejadas incluyen la antigüedad de la conexión más reciente (Last Connect). Usa --connected para mostrar solo los nodos conectados actualmente. Usa --last-connected <duration> para filtrar a los nodos que se conectaron dentro de una duración determinada (por ejemplo, 24h, 7d). Nota sobre la aprobación:
  • openclaw nodes pending solo necesita alcance de emparejamiento.
  • openclaw nodes approve <requestId> hereda requisitos de alcance adicionales de la solicitud pendiente:
    • solicitud sin comandos: solo emparejamiento
    • comandos de nodo sin ejecución: emparejamiento + escritura
    • system.run / system.run.prepare / system.which: emparejamiento + administración

​
Invocar

openclaw nodes invoke --node <id|name|ip> --command <command> --params <json>
Indicadores de invocación:
  • --params <json>: cadena de objeto JSON (predeterminado {}).
  • --invoke-timeout <ms>: tiempo de espera de invocación de nodo (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 ejecución de shell.
Para la ejecución de shell en un nodo, usa la herramienta exec con host=node en lugar de openclaw nodes run. La CLI de nodes ahora está centrada en capacidades: RPC directa mediante nodes invoke, además de emparejamiento, cámara, pantalla, ubicación, canvas y notificaciones.