Skip to content

Gateway diagnostics should surface pending node approval IDs and exact approve command #98045

Description

@ccaprani

Summary

When an Android node is connected but waiting for node reapproval, the required approval target is an internal node UUID. That ID is not visible in the Android app and is not shown by the device-oriented CLI path, so a user has no clear way to know what to approve.

What happened

During Android reconnection, the app showed an authentication/approval state. The visible phone IP was 192.168.0.202, and openclaw devices list showed the paired device. Running:

openclaw devices approve 192.168.0.202

was the natural guess, but it was the wrong layer. The actual fix was:

openclaw nodes approve 8bb57418-07c0-4a32-bca7-5d691aa3cc69

The node UUID did not appear in the app or in the device list, so the user could not have discovered it from the visible information.

Expected behavior

Gateway diagnostics and/or the failed approval path should surface the exact pending node approval and command, for example:

Node reapproval pending for "Colin's S25"
Run: openclaw nodes approve 8bb57418-07c0-4a32-bca7-5d691aa3cc69

Useful places to show this:

  • Android app setup/authentication screen
  • openclaw gateway diagnostic / Android gateway diagnostic output
  • openclaw devices list when a paired device has an associated node approval pending
  • openclaw devices approve <ip> error output, if the IP matches a node connection

Actual behavior

The user saw an app-side authentication-needed state and a device/IP in CLI output, but the required nodes approve <uuid> command was only discoverable if the user already knew to run openclaw nodes pending or openclaw nodes status.

Why this matters

The devices and nodes approval layers are easy to confuse during Android setup because the same physical phone appears as both a device and a node. The CLI should guide users from the wrong-but-obvious command to the right command.

Related

Possibly adjacent to #91126 and #98038, but this report is specifically about user-facing discoverability and diagnostics for pending node approval IDs.

Metadata

Metadata

Assignees

No one assigned

    Labels

    P2Normal backlog priority with limited blast radius.clawsweeper:fix-shape-clearClawSweeper found a clear likely implementation shape for this issue.clawsweeper:queueable-fixClawSweeper marked this issue as an existing queue_fix_pr work candidate.clawsweeper:source-reproClawSweeper found a high-confidence source-level issue reproduction.impact:auth-providerAuth, provider routing, model choice, or SecretRef resolution may break.issue-rating: 🦞 diamond lobsterVery strong issue quality with high-confidence source-level or clear reproduction.maturity:stableIssue affects a taxonomy feature currently scored M4/M5.no-staleExclude from stale automation

    Type

    No type

    Fields

    Priority

    None yet

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions