Diagnose OpenClaw node connection and pairing failures for Android, iOS, and macOS companion apps. Use when QR/setup code/manual connect fails, local Wi-Fi w...
Real data. Real impact.
Emerging
Developers
Per week
Open source
Skills give you superpowers. Install in 30 seconds.
Goal: find the one real route from node -> gateway, verify OpenClaw is advertising that route, then fix pairing/auth.
Decide which case you are in before proposing fixes:
Do not mix them.
localhostIf the setup is unclear or the failure report is vague, ask short clarifying questions before diagnosing.
Ask for:
openclaw devices listDo not guess from
can't connectPrefer
openclaw qr --jsonopenclaw config get gateway.mode openclaw config get gateway.bind openclaw config get gateway.tailscale.mode openclaw config get gateway.remote.url openclaw config get gateway.auth.mode openclaw config get gateway.auth.allowTailscale openclaw config get plugins.entries.device-pair.config.publicUrl openclaw qr --json openclaw devices list openclaw nodes status
If this OpenClaw instance is pointed at a remote gateway, also run:
openclaw qr --remote --json
If Tailscale is part of the story:
tailscale status --json
openclaw qr --jsongatewayUrlurlSourceCommon good sources:
gateway.bind=langateway.bind=tailnetgateway.tailscale.mode=servegateway.tailscale.mode=funnelplugins.entries.device-pair.config.publicUrlgateway.remote.urlIf
openclaw qr --jsonGateway is only bound to loopbackgateway.bind=autogateway.bind=langateway.tailscale.mode=servegateway.bind=tailnetplugins.entries.device-pair.config.publicUrlgateway.remote.urlIf
gateway.bind=tailnet set, but no tailnet IP was foundIf
qr --remote requires gateway.remote.urlIf the app says
pairing requiredopenclaw devices list openclaw devices approve --latest
If the app says
bootstrap token invalid or expiredIf the app says
unauthorizedgateway.auth.allowTailscale127.0.0.1localhosturlSourceopenclaw devices listReply with one concrete diagnosis and one route.
If there is not enough signal yet, ask for setup + exact app text instead of guessing.
Good:
The gateway is still loopback-only, so a node on another network can never reach it. Enable Tailscale Serve, restart the gateway, run openclaw qr again, rescan, then approve the pending device pairing.Bad:
Maybe LAN, maybe Tailscale, maybe port forwarding, maybe public URL.No automatic installation available. Please visit the source repository for installation instructions.
View Installation Instructions
1,500+ AI skills, agents & workflows. Install in 30 seconds. Part of the Torly.ai family.
© 2026 Torly.ai. All rights reserved.