Nodes

Scope

Nodes are companion devices (macOS/iOS/Android/headless) that connect to the Gateway and expose capabilities like canvas.*, camera.*, screen.*, and system.*.

Pairing + status (CLI)

Device pairing approves a node connection request:

moltbot devices list
moltbot devices approve <requestId>
moltbot nodes status
moltbot nodes describe --node <idOrNameOrIp>

Remote node host (run commands on another machine)

Use a node host when the Gateway runs on one machine but you want exec host=node to run elsewhere.

On the node machine:

moltbot node run --host <gateway-host> --port 18789 --display-name "Build Node"

On the gateway machine:

moltbot nodes pending
moltbot nodes approve <requestId>

Common workflows

Screenshots: /en/docs/nodes/images/
Camera: /en/docs/nodes/camera/
Location: /en/docs/nodes/location-command/

Related docs

Node CLI: /en/docs/cli/node/
Nodes CLI: /en/docs/cli/nodes/
Exec approvals (node hosts): /en/docs/tools/exec-approvals/