Skip to content

[UX] Exec approval timeout message should include Control UI link and setup hints #53250

Description

@yurtzy

When an exec command times out waiting for approval, the error message is generic:

Exec approval is required, but chat exec approvals are not enabled on Discord.
Approve it from the Web UI or terminal UI, or from Discord or Telegram if those approval clients are enabled.

This tells the user that approval is needed but gives no concrete next steps:

  • No link to the Control UI
  • No hint where the "terminal UI" is
  • No way to know if Discord approvals are actually enabled
  • No command to list pending approvals

As a result, operators get stuck in loops of retrying and timing out, especially during initial setup.

Proposed improvement:
Include specific, actionable guidance in the error message:

  • The Control UI URL (if discoverable from gateway, e.g., http://localhost:8080) and how to get the token (openclaw dashboard --no-open)
  • Reminder to check openclaw.jsonchannels.discord.execApprovals.enabled
  • Suggest openclaw exec-approvals list if such CLI exists

Example:

Exec approval required.
→ Open Control UI: http://localhost:8080 (token from `openclaw dashboard --no-open`)
→ Or enable Discord approvals: set channels.discord.execApprovals.enabled=true and restart.
→ Or check pending: openclaw exec-approvals list

This small UX improvement reduces onboarding friction dramatically.

I can submit a PR for this if desired.

Metadata

Metadata

Assignees

No one assigned

    Labels

    P3Low-priority cleanup, docs, polish, ergonomics, or speculative work.clawsweeper:linked-pr-openClawSweeper found an open linked pull request for this issue.clawsweeper:no-new-fix-prClawSweeper does not recommend queueing a new automated fix PR for this issue.clawsweeper:source-reproClawSweeper found a high-confidence source-level issue reproduction.impact:ux-frictionUser-facing flow adds avoidable confusion or support burden without fully blocking progress.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.

    Type

    No type

    Fields

    Priority

    None yet

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions