openclaw nodes

Gerencie Nodes emparelhados (dispositivos) e invoque os recursos dos Nodes.

Relacionado: Visão geral dos Nodes - Presença ativa no computador - Nodes de câmera - Nodes de imagem

Opções comuns a todos os subcomandos: --url <url>, --token <token>, --timeout <ms> (padrão 10000), --json.

Status

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

status e list aceitam --connected (somente Nodes conectados) e --last-connected <duration> (por exemplo, 24h, 7d; somente Nodes que se conectaram durante o período). list mostra Nodes pendentes e emparelhados em tabelas separadas, com as linhas emparelhadas incluindo o tempo desde a conexão mais recente (Last Connect); status mostra uma tabela unificada com detalhes de recurso, versão e última entrada de cada Node. Um Node macOS conectado informa a última entrada somente enquanto a permissão de Acessibilidade está concedida, e a linha mais recente é marcada como active; consulte Presença ativa no computador. describe exibe os recursos, as permissões, a atividade e os comandos de invocação efetivos/pendentes de um Node.

Emparelhamento

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>

Esses comandos controlam o armazenamento node.pair.* pertencente ao Gateway, separado do emparelhamento de dispositivos (openclaw devices approve), que controla o handshake connect de WS do Node. Consulte Nodes para entender como os dois se relacionam.

• remove revoga a entrada de função emparelhada do Node. Para um Node respaldado por dispositivo, isso revoga a função node no armazenamento de emparelhamento de dispositivos e desconecta suas sessões de função de Node: um dispositivo com funções mistas mantém sua linha e perde apenas a função node; a linha de um dispositivo que é somente Node é excluída. Isso também limpa qualquer registro legado correspondente de emparelhamento de Node pertencente ao Gateway.
• pending requer apenas o escopo operator.pairing.
• gateway.nodes.pairing.autoApproveCidrs pode ignorar a etapa pendente no primeiro emparelhamento de dispositivo role: node explicitamente confiável. Desativado por padrão; não aprova upgrades de função.
• gateway.nodes.pairing.sshVerify (ativado por padrão) aprova automaticamente o primeiro emparelhamento de dispositivo role: node quando o Gateway consegue verificar a chave do dispositivo via SSH no host do Node; a primeira superfície de recursos é aprovada na mesma etapa. Consulte Emparelhamento de Nodes.
• Os requisitos de escopo de approve seguem os comandos declarados pela solicitação pendente:
  • solicitação sem comandos: operator.pairing
  • comandos comuns de Node: operator.pairing + operator.write
  • comandos administrativos sensíveis (system.run, system.run.prepare, system.which, browser.proxy, fs.listDir e system.execApprovals.get/set): operator.pairing + operator.admin
• Escopo de remove: operator.pairing pode remover linhas de Nodes que não são operadores; um chamador com token de dispositivo que revoga sua própria função de Node em um dispositivo com funções mistas também precisa de operator.admin.

Invocação

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

Opções:

• --command <command> (obrigatório): por exemplo, canvas.eval.
• --params <json>: string de objeto JSON (padrão {}).
• --invoke-timeout <ms>: tempo limite de invocação do Node (padrão 15000).
• --idempotency-key <key>: chave de idempotência opcional.

system.run e system.run.prepare são bloqueados aqui; em vez disso, use a ferramenta exec com host=node para executar comandos do shell. system.which é permitido por meio de invoke.

Notificação, push, localização e tela

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 envia uma notificação local em um Node que declara system.notify, incluindo Nodes macOS, iOS, Android e watchOS diretos. A entrega direta ao watchOS exige que o OpenClaw esteja ativo. Requer --title ou --body. Opções: --sound <name>, --priority <passive|active|timeSensitive>, --delivery <system|overlay|auto> (padrão system), --invoke-timeout <ms> (padrão 15000).
• push envia uma notificação push de teste do APNs para um Node iOS. Opções: --title <text> (padrão OpenClaw), --body <text>, --environment <sandbox|production> para substituir o ambiente APNs detectado.
• location get obtém a localização atual do Node. Opções: --max-age <ms> (reutilizar uma localização em cache), --accuracy <coarse|balanced|precise>, --location-timeout <ms> (padrão 10000), --invoke-timeout <ms> (padrão 20000).
• screen record captura um clipe curto e exibe o caminho salvo (ou grava JSON com --json). Opções: --screen <index> (padrão 0), --duration <ms|10s> (padrão 10000), --fps <fps> (padrão 10), --no-audio, --out <path>, --invoke-timeout <ms> (padrão 120000).

Os comandos de câmera e Canvas têm documentação própria: Nodes de câmera, Canvas. O Canvas é implementado pelo Plugin experimental Canvas incluído; o núcleo mantém openclaw nodes canvas como ponto de montagem de compatibilidade.

Relacionado

• Referência da CLI
• Nodes