Connecting Gateways
Add and manage OpenClaw Gateway connections
OpenClaw Swarm connects to your OpenClaw Gateway instances over WebSocket. You can connect to as many gateways as you need — production, staging, development, all at once.
Adding a gateway
- Click the Add Gateway button in the sidebar
- Enter the gateway's WebSocket URL (e.g.
wss://gateway.example.com) - The app will initiate a device pairing flow using your device identity
Device pairing
The first time you connect to a gateway, your device needs to be approved. OpenClaw Swarm uses Ed25519 keypairs for authentication — no passwords.
- Swarm sends a pairing request to the gateway
- Approve the device via the OpenClaw Gateway Control UI > Devices tab
- Once approved, Swarm connects automatically on future launches
Connection states
The sidebar shows a colored status dot for each gateway:
| Indicator | State | Meaning |
|---|---|---|
| Green dot | Connected | Active WebSocket connection |
| Amber dot | Connecting | Establishing connection |
| Blue dot | Pairing | Device pairing in progress |
| Red dot | Auth failed | Authentication rejected — re-pair needed |
| Gray dot | Disconnected | No active connection |
Managing gateways
Click any gateway in the sidebar to see its detail view with:
- Active sessions and agent count
- Token usage and cost statistics
- Streaming log output
- Security configuration
Real-time updates
All gateway data is updated in real time via WebSocket event streaming. When a session starts, an agent connects, or a log line appears — you see it instantly without refreshing.