mirror of
https://github.com/hansjone/oclaw.git
synced 2026-10-09 12:30:44 +08:00
oliver
dbbe3add6a
同时收敛启动与运维脚本默认行为（含 wiki worker）、更新 Admin 可观测性与相关测试，降低首轮时延并提高运行稳定性。 Made-with: Cursor
66 lines
2.1 KiB
Markdown
66 lines
2.1 KiB
Markdown
---
|
||
summary: "CLI reference for `openclaw nodes` (status, pairing, invoke, camera/canvas/screen)"
|
||
read_when:
|
||
- You’re managing paired nodes (cameras, screen, canvas)
|
||
- You need to approve requests or invoke node commands
|
||
title: "nodes"
|
||
---
|
||
|
||
# `openclaw nodes`
|
||
|
||
Manage paired nodes (devices) and invoke node capabilities.
|
||
|
||
Related:
|
||
|
||
- Nodes overview: [Nodes](/nodes)
|
||
- Camera: [Camera nodes](/nodes/camera)
|
||
- Images: [Image nodes](/nodes/images)
|
||
|
||
Common options:
|
||
|
||
- `--url`, `--token`, `--timeout`, `--json`
|
||
|
||
## Common commands
|
||
|
||
```bash
|
||
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 rename --node <id|name|ip> --name <displayName>
|
||
openclaw nodes status
|
||
openclaw nodes status --connected
|
||
openclaw nodes status --last-connected 24h
|
||
```
|
||
|
||
`nodes list` prints pending/paired tables. Paired rows include the most recent connect age (Last Connect).
|
||
Use `--connected` to only show currently-connected nodes. Use `--last-connected <duration>` to
|
||
filter to nodes that connected within a duration (e.g. `24h`, `7d`).
|
||
|
||
Approval note:
|
||
|
||
- `openclaw nodes pending` only needs pairing scope.
|
||
- `openclaw nodes approve <requestId>` inherits extra scope requirements from the
|
||
pending request:
|
||
- commandless request: pairing only
|
||
- non-exec node commands: pairing + write
|
||
- `system.run` / `system.run.prepare` / `system.which`: pairing + admin
|
||
|
||
## Invoke
|
||
|
||
```bash
|
||
openclaw nodes invoke --node <id|name|ip> --command <command> --params <json>
|
||
```
|
||
|
||
Invoke flags:
|
||
|
||
- `--params <json>`: JSON object string (default `{}`).
|
||
- `--invoke-timeout <ms>`: node invoke timeout (default `15000`).
|
||
- `--idempotency-key <key>`: optional idempotency key.
|
||
- `system.run` and `system.run.prepare` are blocked here; use the `exec` tool with `host=node` for shell execution.
|
||
|
||
For shell execution on a node, use the `exec` tool with `host=node` instead of `openclaw nodes run`.
|
||
The `nodes` CLI is now capability-focused: direct RPC via `nodes invoke`, plus pairing, camera,
|
||
screen, location, canvas, and notifications.
|