> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Các Node

# `openclaw nodes`

Quản lý các Node (thiết bị) đã ghép đôi và gọi các capability của Node.

Liên quan:

* Tổng quan về Node: [Node](/vi/nodes)
* Camera: [Node camera](/vi/nodes/camera)
* Hình ảnh: [Node hình ảnh](/vi/nodes/images)

Tùy chọn thường dùng:

* `--url`, `--token`, `--timeout`, `--json`

## Lệnh thường dùng

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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
```

`nodes list` in các bảng đang chờ/đã ghép đôi. Các hàng đã ghép đôi bao gồm tuổi kết nối gần đây nhất (Kết nối gần nhất).
Dùng `--connected` để chỉ hiển thị các Node hiện đang kết nối. Dùng `--last-connected <duration>` để
lọc các Node đã kết nối trong một khoảng thời gian (ví dụ: `24h`, `7d`).
Dùng `nodes remove --node <id|name|ip>` để xóa ghép đôi của một Node. Với một
Node dựa trên thiết bị, thao tác này thu hồi vai trò `node` của thiết bị trong `devices/paired.json`
và ngắt kết nối các phiên có vai trò Node của thiết bị đó (thiết bị có nhiều vai trò vẫn giữ hàng của nó và
chỉ mất vai trò `node`; thiết bị chỉ có vai trò Node sẽ bị xóa); thao tác này cũng xóa mọi
bản ghi ghép đôi Node cũ tương ứng do Gateway sở hữu. `operator.pairing` có thể xóa
các hàng Node không phải operator; caller dùng token thiết bị khi thu hồi vai trò Node của chính nó trên một
thiết bị nhiều vai trò cũng cần `operator.admin`.

Ghi chú phê duyệt:

* `openclaw nodes pending` chỉ cần phạm vi ghép đôi.
* `gateway.nodes.pairing.autoApproveCidrs` chỉ có thể bỏ qua bước đang chờ đối với
  ghép đôi thiết bị `role: node` lần đầu, được tin cậy rõ ràng. Tùy chọn này tắt theo
  mặc định và không phê duyệt các lần nâng cấp.
* `openclaw nodes approve <requestId>` kế thừa các yêu cầu phạm vi bổ sung từ
  yêu cầu đang chờ:
  * yêu cầu không có lệnh: chỉ ghép đôi
  * lệnh Node không phải exec: ghép đôi + ghi
  * `system.run` / `system.run.prepare` / `system.which`: ghép đôi + admin

## Gọi

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw nodes invoke --node <id|name|ip> --command <command> --params <json>
```

Cờ gọi:

* `--params <json>`: chuỗi đối tượng JSON (mặc định `{}`).
* `--invoke-timeout <ms>`: thời gian chờ gọi Node (mặc định `15000`).
* `--idempotency-key <key>`: khóa idempotency tùy chọn.
* `system.run` và `system.run.prepare` bị chặn ở đây; dùng công cụ `exec` với `host=node` để thực thi shell.

Để thực thi shell trên một Node, dùng công cụ `exec` với `host=node` thay vì `openclaw nodes run`.
CLI `nodes` hiện tập trung vào capability: RPC trực tiếp qua `nodes invoke`, cùng với ghép đôi, camera,
màn hình, vị trí, Canvas và thông báo. Các lệnh Canvas được triển khai bởi Plugin Canvas thử nghiệm được tích hợp; core giữ một hook tương thích để chúng vẫn nằm dưới `openclaw nodes canvas`.

## Liên quan

* [Tham chiếu CLI](/vi/cli)
* [Node](/vi/nodes)