clawdbot/docs/network.md

summary, read_when

summary	read_when
Network hub: gateway surfaces, pairing, discovery, and security	You need the network architecture + security overview You are debugging local vs tailnet access or pairing You want the canonical list of networking docs

Network hub

This hub links the core docs for how Clawdbot connects, pairs, and secures devices across localhost, LAN, and tailnet.

Core model

• Gateway architecture
• Gateway protocol
• Gateway runbook
• Web surfaces + bind modes

Pairing + identity

• Pairing overview (DM + nodes)
• Gateway-owned node pairing
• Devices CLI (pairing + token rotation)
• Pairing CLI (DM approvals)

Local trust:

• Local connections (loopback or the gateway host’s own tailnet address) can be auto‑approved for pairing to keep same‑host UX smooth.
• Non‑local tailnet/LAN clients still require explicit pairing approval.

Discovery + transports

• Discovery & transports
• Bonjour / mDNS
• Remote access (SSH)
• Tailscale

Nodes + transports

• Nodes overview
• Bridge protocol (legacy nodes)
• Node runbook: iOS
• Node runbook: Android

Security

• Security overview
• Gateway config reference
• Troubleshooting
• Doctor