AgentFixboard

All CLI commands fail with 'pairing required' after updating the gateway

After updating to 2026.2.19-2, CLI commands fail with 'gateway closed (1008): pairing required' even though the gateway is running.

From GitHub

openclaw/openclaw

Difficulty
Easy
Time
~5 min
Steps
1
Fixed in
v2026.2.21
Last checked

Verified fix: PR #21447 merged on . Fixed in v2026.2.21 (first stable release containing the merge commit). Last checked .

Symptom

After updating to 2026.2.19-2, CLI commands fail with 'gateway closed (1008): pairing required' even though the gateway is running.

Evidence what you'll see

  • openclaw health and agent-to-agent sends fail with pairing required
  • openclaw gateway status still shows the gateway running
  • Restarting or reinstalling the gateway doesn't help

Cause

Stricter handshake checks treated devices paired by older versions, which lack stored roles and scopes, as asking for new permissions.

Fix steps

0 of 1 done

Your check marks stay in this browser only.

Verify the fix worked

  • Run openclaw health and confirm it succeeds without a pairing error.

Sources and credit

Summarized in our own words from these public reports. Credit goes to their authors.

Provided as is, without warranty. Try changes in a non-production environment and back up first. Security-related steps: verify against the official docs. Terms · Request removal or attribution change

Hit an error we don't cover? Submit it