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
• Camera: Node camera
• Hình ảnh: Node hình ảnh

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

• --url, --token, --timeout, --json

Lệnh thường dùng

openclaw nodes listopenclaw nodes list --connectedopenclaw nodes list --last-connected 24hopenclaw nodes pendingopenclaw 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 statusopenclaw nodes status --connectedopenclaw 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

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
• Node