Nodes
CLI reference for openclaw nodes (list/status/approve/invoke, camera/canvas/screen).
Manage paired nodes (devices) and invoke node functions.
Related:
- Nodes overview: ''Nodes''
- Camera: ''Camera node''
- Images: ''Images node''
Common options:
- ''--url'', ''--token'', ''--timeout'', ''--json''
Common commands
openclaw nodes list openclaw nodes list --connected openclaw nodes list --last-connected 24h openclaw nodes pending openclaw nodes approve <requestId> openclaw nodes status openclaw nodes status --connected openclaw nodes status --last-connected 24h
''nodes list'' prints a table of pending/paired. Paired rows include the most recent connection time (last connected).
Use ''--connected'' to show only currently connected nodes. Use ''--last-connected <duration>'' to filter to nodes connected within a time period (e.g. ''24h'', ''7d'').
Invoke/run
openclaw nodes invoke --node <id|name|ip> --command <command> --params <json> openclaw nodes run --node <id|name|ip> <command...> openclaw nodes run --raw "git status" openclaw nodes run --agent main --node <id|name|ip> --raw "git status"
Invoke flags:
- ''--params <json>'': JSON object string (default ''{}'').
- ''--invoke-timeout <ms>'': Node invoke timeout (default ''15000'').
- ''--idempotency-key <key>'': Optional idempotency key.
#
Exec-style defaults
''nodes run'' mirrors model execution behavior (defaults + approvals):
- Reads ''tools.exec.*'' (plus ''agents.list[].tools.exec.*'' overrides).
- Uses execution approvals (''exec.approval.request'') before invoking ''system.run''.
- Can omit ''--node'' when ''tools.exec.node'' is set.
- Requires a node that advertises ''system.run'' (macOS companion app or headless node host).
Flags:
- ''--cwd <path>'': Working directory.
- ''--env <key=val>'': Environment override (repeatable).
- ''--command-timeout <ms>'': Command timeout.
- ''--invoke-timeout <ms>'': Node invoke timeout (default ''30000'').
- ''--needs-screen-recording'': Requires screen recording permission.
- ''--raw <command>'': Run shell string (''/bin/sh -lc'' or ''cmd.exe /c'').
- ''--agent <id>'': Agent-scoped approvals/allowlist (defaults to configured agent).
- ''--ask <off|on-miss|always>'', ''--security <deny|allowlist|full>'': Override.