{
  "title": "`openclaw nodes`",
  "content": "Manage paired nodes (devices) and invoke node capabilities.\n\n* Nodes overview: [Nodes](/nodes)\n* Camera: [Camera nodes](/nodes/camera)\n* Images: [Image nodes](/nodes/images)\n\n* `--url`, `--token`, `--timeout`, `--json`\n\n`nodes list` prints pending/paired tables. Paired rows include the most recent connect age (Last Connect).\nUse `--connected` to only show currently-connected nodes. Use `--last-connected <duration>` to\nfilter to nodes that connected within a duration (e.g. `24h`, `7d`).\n\n* `--params <json>`: JSON object string (default `{}`).\n* `--invoke-timeout <ms>`: node invoke timeout (default `15000`).\n* `--idempotency-key <key>`: optional idempotency key.\n\n### Exec-style defaults\n\n`nodes run` mirrors the model’s exec behavior (defaults + approvals):\n\n* Reads `tools.exec.*` (plus `agents.list[].tools.exec.*` overrides).\n* Uses exec approvals (`exec.approval.request`) before invoking `system.run`.\n* `--node` can be omitted when `tools.exec.node` is set.\n* Requires a node that advertises `system.run` (macOS companion app or headless node host).\n\n* `--cwd <path>`: working directory.\n* `--env <key=val>`: env override (repeatable).\n* `--command-timeout <ms>`: command timeout.\n* `--invoke-timeout <ms>`: node invoke timeout (default `30000`).\n* `--needs-screen-recording`: require screen recording permission.\n* `--raw <command>`: run a shell string (`/bin/sh -lc` or `cmd.exe /c`).\n* `--agent <id>`: agent-scoped approvals/allowlists (defaults to configured agent).\n* `--ask <off|on-miss|always>`, `--security <deny|allowlist|full>`: overrides.",
  "code_samples": [
    {
      "code": "`nodes list` prints pending/paired tables. Paired rows include the most recent connect age (Last Connect).\nUse `--connected` to only show currently-connected nodes. Use `--last-connected <duration>` to\nfilter to nodes that connected within a duration (e.g. `24h`, `7d`).\n\n## Invoke / run",
      "language": "unknown"
    }
  ],
  "headings": [
    {
      "level": "h2",
      "text": "Common commands",
      "id": "common-commands"
    },
    {
      "level": "h2",
      "text": "Invoke / run",
      "id": "invoke-/-run"
    },
    {
      "level": "h3",
      "text": "Exec-style defaults",
      "id": "exec-style-defaults"
    }
  ],
  "url": "llms-txt#`openclaw-nodes`",
  "links": []
}