Fixes#4531
When accessing the Web UI from a different machine on the LAN, users
were getting a cryptic 'disconnected (1008): pairing required' error
with no indication of how to resolve it.
Changes:
1. Enhanced server error message to include:
- Clear explanation of the pairing requirement
- Step-by-step CLI instructions (openclaw devices list/approve)
- The specific request ID to approve
- Note that approval must be done on the server machine
- Alternative method (localhost Control UI)
2. Updated Web UI to propagate the full error message from the server
instead of the generic 'connect failed' message
Impact:
- Non-breaking change (only improves error messaging)
- Backwards compatible with existing clients
- Significantly improves UX for LAN/remote access scenarios
Before:
Error: disconnected (1008): pairing required
After:
Error: Device pairing required. On the OpenClaw server machine, run:
'openclaw devices list' to see pending requests, then
'openclaw devices approve <request-id>' to approve this device.
Alternatively, access the Control UI from the server's localhost to approve.
spiceoogway
d2c1fd3c61