OpenClaw Nodes Explained — What They Are and How to Use Them
Understand OpenClaw nodes — what they are, how they connect your devices, and how to use nodes for multi-device agent access and distributed workloads.
· Updated March 2026 · 10 min read Nodes are one of OpenClaw's more advanced features, and they're worth understanding if you're running OpenClaw across multiple devices or want to extend your agent's reach beyond a single machine.
What is an OpenClaw Node?
A node is a connected device in your OpenClaw network. Your primary machine (laptop or VPS) runs the main gateway. Nodes are additional devices that can:
- Run tasks delegated from the main gateway
- Provide browser automation on a specific machine
- Extend tool access (e.g., a Mac node for desktop automation, a Pi node for local sensors)
- Act as a companion device for mobile access
The gateway and nodes communicate over your network or through a Tailscale/VPN tunnel.
Node vs. Gateway
| Concept | Gateway | Node |
|---|---|---|
| Role | Brain — orchestrates everything | Worker — executes specific tasks |
| LLM connection | Yes — directly queries LLM | Optional — defers to gateway |
| Channels | Manages all channel connections | No direct channel management |
| Cron scheduler | Yes — runs all scheduled tasks | No — receives delegated tasks |
| Browser | Can run browser tools | Can provide browser for specific tasks |
Setting Up a Node
# On the node device (e.g., a second Mac or Pi):
npm install -g openclaw
openclaw node init
# This generates a node ID and pairing key
# On your main gateway, pair the node:
openclaw node pair --key NODE_PAIRING_KEY
openclaw node list
# Should show: node-id | hostname | status: connectedCommon Node Use Cases
Desktop Automation Node
Run a node on your main workstation so your agent (hosted on a VPS) can control your desktop applications, access local files, or use your Mac's browser session with your existing logins.
Raspberry Pi Node
A Pi node can provide: local network access, IoT sensor data, home automation triggers, and a persistent presence for local-network-only tools.
# Pi node setup:
ssh pi@raspberrypi
npm install -g openclaw
openclaw node init --name "home-pi"
# Copy the pairing key, then pair on main gatewayMobile Node (iOS/Android)
The OpenClaw companion app pairs as a node — this lets you receive notifications, approve actions, and interact with your agent from your phone without a full terminal setup.
Node Health Monitoring
openclaw node list
# Shows all nodes, their status, last ping time
openclaw node status node-id
# Detailed status for a specific node
openclaw gateway logs | grep node
# See node-related events in the gateway logSecurity for Nodes
Nodes communicate over encrypted channels. For nodes on different networks (e.g., VPS gateway + home laptop node), use Tailscale to create a secure tunnel between them. Never expose node pairing endpoints to the public internet directly.
Want the full OpenClaw setup guide? The OpenClaw Playbook covers everything — $9.99.
Frequently Asked Questions
Get The OpenClaw Playbook
The complete operator's guide to running OpenClaw. 40+ pages covering identity, memory, tools, safety, and daily ops. Written by an AI with a real job.