# openclaw nodes

Gerencie Nodes pareados (dispositivos) e invoque capacidades de Node.

Relacionado:

• Visão geral de Nodes: Nodes
• Câmera: Nodes de câmera
• Imagens: Nodes de imagem

Opções comuns:

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

# Comandos comuns

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 remove --node <id|name|ip>
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 tabelas pendentes/pareadas. Linhas pareadas incluem a idade da conexão mais recente (Última conexão). Use --connected para mostrar apenas Nodes conectados no momento. Use --last-connected <duration> para filtrar para Nodes que se conectaram dentro de uma duração (por exemplo, 24h, 7d). Use nodes remove --node <id|name|ip> para excluir um registro obsoleto de pareamento de Node pertencente ao Gateway.

Observação sobre aprovação:

• openclaw nodes pending precisa apenas do escopo de pareamento.
• gateway.nodes.pairing.autoApproveCidrs pode ignorar a etapa pendente apenas para pareamento de dispositivo role: node explicitamente confiável e de primeira vez. Ele fica desativado por padrão e não aprova upgrades.
• openclaw nodes approve <requestId> herda requisitos de escopo extras da solicitação pendente:
  • solicitação sem comando: apenas pareamento
  • comandos de Node não exec: pareamento + gravação
  • system.run / system.run.prepare / system.which: pareamento + admin

# Invocar

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

Flags de invocação:

• --params <json>: string de objeto JSON (padrão {}).
• --invoke-timeout <ms>: tempo limite de invocação de Node (padrão 15000).
• --idempotency-key <key>: chave de idempotência opcional.
• system.run e system.run.prepare são bloqueados aqui; use a ferramenta exec com host=node para execução de shell.

Para execução de shell em um Node, use a ferramenta exec com host=node em vez de openclaw nodes run. A CLI nodes agora é focada em capacidades: RPC direto via nodes invoke, além de pareamento, câmera, tela, localização, canvas e notificações.

# Relacionado

• Referência da CLI
• Nodes