Nodes

text

Copy

openclaw nodes

Manage paired nodes (devices) and invoke node capabilities.

Related:

• Nodes overview: Nodes
• Camera: Camera nodes
• Images: Image nodes

Common options:

• text

  Copy

  --url
  ,
  text

  Copy

  --token
  ,
  text

  Copy

  --timeout
  ,
  text

  Copy

  --json

Common commands

bash
Copy
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

prints pending/paired tables. Paired rows include the most recent connect age (Last Connect). Use to only show currently-connected nodes. Use to filter to nodes that connected within a duration (e.g. , ). Use to delete a stale gateway-owned node pairing record.

Approval note:

• text

  Copy

  openclaw nodes pending
  only needs pairing scope.
• text

  Copy

  gateway.nodes.pairing.autoApproveCidrs
  can skip the pending step only for explicitly trusted, first-time
  text

  Copy

  role: node
  device pairing. It is off by default and does not approve upgrades.
• text

  Copy

  openclaw nodes approve <requestId>
  inherits extra scope requirements from the pending request:
  • commandless request: pairing only
  • non-exec node commands: pairing + write
  • text

    Copy

    system.run
    /
    text

    Copy

    system.run.prepare
    /
    text

    Copy

    system.which
    : pairing + admin

Invoke

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

Invoke flags:

• text

  Copy

  --params <json>
  : JSON object string (default
  text

  Copy

  {}
  ).
• text

  Copy

  --invoke-timeout <ms>
  : node invoke timeout (default
  text

  Copy

  15000
  ).
• text

  Copy

  --idempotency-key <key>
  : optional idempotency key.
• text

  Copy

  system.run
  and
  text

  Copy

  system.run.prepare
  are blocked here; use the
  text

  Copy

  exec
  tool with
  text

  Copy

  host=node
  for shell execution.

For shell execution on a node, use the

tool with instead of . The CLI is now capability-focused: direct RPC via , plus pairing, camera, screen, location, canvas, and notifications.

Related

• CLI reference
• Nodes