QuotaCheap Playbook

OpenClaw Nodes: nối companion devices và remote command hosts vào Gateway

Hướng dẫn OpenClaw Nodes cho production: pairing, status, remote node host, system.run, exec host=node, allowlist approvals, command policy, canvas/camera/…

Node không phải gateway phụ. Node là peripheral kết nối WebSocket về Gateway, expose command surfaces như canvas, camera, device, notifications và system.run dưới pairing + policy gates.

Playbook tiếng Việt về OpenClaw Nodes: node role, device pairing, nodes status/describe, remote node host, SSH tunnel, node service, exec host=node, approvals allowlist, command policy, canvas/camera/screen commands và troubleshooting.

OpenClaw Nodes là một trong những phần dễ bị hiểu sai.

Nghe “node” là nhiều người nghĩ gateway phụ, worker cluster, hay máy chạy agent riêng.

Docs nói rõ: node là companion device — macOS, iOS, Android, headless — kết nối tới Gateway WebSocket với role: "node" và expose command surface qua node.invoke.

Node là ngoại vi có quyền hành động.

Gateway vẫn là control plane.

Nói kiểu vận hành: Gateway nhận messages, chạy model, route tool calls.

Node cho Gateway thêm tay/chân trên một thiết bị khác: canvas, camera, screen, notifications, device commands, hoặc system.run trên remote node host.

Node là peripheral, không phải gateway OpenClaw docs nhấn mạnh: Nodes là peripherals, không chạy Gateway service.

Telegram/WhatsApp/etc.

messages land on Gateway, not nodes.

Node kết nối tới Gateway WebSocket cùng port với operators, role node.

Node expose commands như canvas.

Mô hình đúng: Node không thay thế Gateway.

Node mở rộng nơi Gateway có thể quan sát/hành động.

macOS node mode và remote gateway mode Docs nói macOS có thể chạy node mode: menubar app kết nối tới Gateway WS server và expose local canvas/camera commands như một node, để openclaw nodes ...

work against this Mac.

Trong remote gateway mode, browser automation được handled bởi CLI node host openclaw node run hoặc installed node service , không phải native app node.

Điểm này quan trọng khi debug: cùng là “máy Mac”, nhưng command surface nào available phụ thuộc app node hay CLI node host đang chạy.

Pairing: WS nodes dùng device pairing WS nodes dùng device pairing.

Node present device identity trong connect; Gateway tạo pairing request cho role: node.

Approve qua devices CLI hoặc UI.

Quick CLI: Nếu node retry với auth details đổi như role/scopes/public key, pending request cũ bị superseded và requestId mới được tạo.

Re run: trước khi approve.

Đừng approve request cũ rồi hỏi sao không chạy.