openclaw nodes

Gerencie nós (dispositivos) pareados e invoque capacidades de nós.

Relacionado:

• Visão geral de nós: Nós
• Câmera: Nós de câmera
• Imagens: Nós de imagem

Opções comuns:

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

Comandos comuns

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 tabelas de pendentes/pareados. As linhas pareadas incluem a idade da conexão mais recente (Última conexão). Use --connected para mostrar apenas nós conectados no momento. Use --last-connected <duration> para filtrar nós que se conectaram dentro de uma duração (por exemplo, 24h, 7d). Use nodes remove --node <id|name|ip> para remover o pareamento de um nó. Para um nó respaldado por dispositivo, isso revoga o papel node do dispositivo em devices/paired.json e desconecta suas sessões com papel de nó (um dispositivo com papéis mistos mantém sua linha e perde apenas o papel node; um dispositivo somente de nó é excluído); também limpa qualquer registro de pareamento de nó legado correspondente pertencente ao gateway. operator.pairing pode remover linhas de nó não operadoras; um chamador com token de dispositivo que revoga seu próprio papel de nó em um dispositivo com papéis mistos também precisa de operator.admin.

Observação de aprovação:

• openclaw nodes pending precisa apenas do escopo de pareamento.
• gateway.nodes.pairing.autoApproveCidrs pode pular a etapa de pendência 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 extras de escopo da solicitação pendente:
  • solicitação sem comando: apenas pareamento
  • comandos de nó não exec: pareamento + escrita
  • 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>: timeout de invocação de nó (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 nó, 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. Os comandos Canvas são implementados pelo Plugin Canvas experimental incluído; o core mantém um hook de compatibilidade para que eles permaneçam em openclaw nodes canvas.

Relacionado

• Referência da CLI
• Nós