Skip to main content

OpenClaw: pairing required (openclaw-gateway)

Common message

pairing required

Symptoms

  • Control UI shows Disconnected from gateway
  • pairing required / device identity required loops
  • origin not allowed errors in UI

Root cause

OpenClaw gateway/control UI connectivity

Fix

  1. Set gateway.controlUi.allowedOrigins to include the public host.
  2. Ensure pairing approval bootstrap is executed once (idempotent).
  3. Verify gateway service is reachable from the UI and websockets are allowed.